American Girl Product Scraper

Extract American Girl products, prices, availability, variants, images, categories, and detailed item data from the public US storefront. Use the data for price monitoring, catalog research, assortment tracking, availability checks, and ecommerce analysis.

This is an unofficial Actor and is not affiliated with or endorsed by American Girl.

Supported operations

The default run searches for doll and requests only 10 results.

Quick start

Search products

{
  "operation": "search",
  "query": "doll",
  "limit": 10,
  "sort": "relevance",
  "proxyMode": "auto"
}

Browse a collection

{
  "operation": "category",
  "slug": "18-doll-collection",
  "limit": 10,
  "sort": "price_asc"
}

Retrieve one product

{
  "operation": "item",
  "slug": "felicity-merriman-18-inch-doll-book-accessories-historical-characters-jmv35",
  "details": true
}

List categories

{
  "operation": "categories",
  "limit": 20
}

Input guide

• query: keyword for search; optional seed for search_filters.
• slug: collection slug for category or product slug for item.
• url: full collection URL as an alternative for category.
• page: result page, starting from 1.
• limit: 1–60 results per page. Start with 10.
• sort: relevance, new, bestsellers, price_asc, price_desc, name_asc, or name_desc.
• category: optional collection filter for keyword search.
• brand: optional brand filter.
• details: enrich product records from the storefront page. This is slower; leave it disabled for listing runs.
• include_hidden: include internal/hidden collections in categories.
• includeRaw: add the original source payload to the run summary.
• proxyMode: auto, direct, apify, or custom.

Because the Console displays a union schema, fields unrelated to the selected operation are ignored.

Output

Product Dataset items can include:

• identifiers: id, slug, barcode
• catalog fields: name, brand, category, source_url
• pricing: price, discount_price, currency, price_info
• availability: in_stock, stock_status, stock
• media: image, images
• content: short_description, description, features
• merchandising: variants, specifications, attributes

Example:

{
  "id": "JMV35",
  "slug": "felicity-merriman-18-inch-doll-book-accessories-historical-characters-jmv35",
  "name": "Felicity Merriman 18-inch Doll, Book & Accessories",
  "price": 135,
  "currency": "USD",
  "in_stock": true,
  "source_url": "https://www.americangirl.com/products/..."
}

The default Key-Value Store contains OUTPUT with success, status, totals, published item count, proxy diagnostics, quota status, and structured errors. For automation, require both platform SUCCEEDED and OUTPUT.success === true.

Ready-to-run Saved Tasks

The Actor package includes bounded use cases for:

• doll product search
• public category discovery
• 18-inch doll collection browsing
• one detailed product lookup

Each task uses a small result limit so it is suitable as a first test and easy to adapt.

Proxy and cost behavior

auto uses a direct request first because the Searchspring catalog is normally available without a proxy. This is the cheapest recommended mode. Select apify only if direct requests are blocked. custom uses operator-provided proxy URLs configured outside the public input.

Keep details disabled for bulk search/category runs. Enable it only when the extra product-page fields justify the additional requests.

Use with n8n or Make

A practical workflow is:

American Girl Actor -> wait for run -> check OUTPUT.success -> Dataset -> Google Sheets, Telegram, inventory system, or BI dashboard

Start a run with the Apify API:

curl -X POST \
  "https://api.apify.com/v2/acts/s3SSpmv1gH7lsAadK/runs?token=YOUR_APIFY_TOKEN&waitForFinish=120" \
  -H "Content-Type: application/json" \
  -d '{"operation":"search","query":"doll","limit":10}'

Read the run summary and Dataset using the IDs returned by the run:

curl "https://api.apify.com/v2/key-value-stores/STORE_ID/records/OUTPUT?token=YOUR_APIFY_TOKEN"
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?clean=true&format=json&token=YOUR_APIFY_TOKEN"

Store the Apify token in your automation platform's credential manager, not in a public workflow.

Limits and responsible use

• Searchspring and storefront structures can change without notice.
• details=true depends on the product-page HTML and may return only Searchspring fields when page enrichment is unavailable.
• Free or trial usage may be limited; inspect OUTPUT.free_trial_quota.
• Use reasonable page sizes and request frequency.
• Users are responsible for complying with applicable laws and site terms.