{
  "title": "Amazon Search & Best Sellers",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "queries": {
      "title": "Search keywords",
      "type": "array",
      "description": "Search keywords, e.g. [\"wireless earbuds\"]. Use ONE keyword per run when tracking each keyword: the same ASIN is delivered once across the whole run, so another keyword may lose that observation. For each result retain query, domain, page, position and fetched_at. position is the source page data-index; it is not a global or renumbered organic rank. Each delivered row costs $0.004. Either queries or categories is required.",
      "editor": "stringList",
      "prefill": [
        "wireless earbuds"
      ],
      "default": [],
      "uniqueItems": true,
      "sectionCaption": "What to search"
    },
    "domain": {
      "title": "Marketplace",
      "type": "string",
      "description": "Marketplace, e.g. \"de\" for amazon.de. Default \"com\". One of: com, co.uk, de, fr, it, es, ca, com.au, co.jp, in, com.mx, com.br, nl, se, pl, sa, ae, sg, com.tr, com.be. Rank and price differ per marketplace, so run each marketplace as its own run; prices come in the marketplace's currency.",
      "editor": "textfield",
      "default": "com"
    },
    "department": {
      "title": "Search department",
      "type": "string",
      "description": "Department to search inside, Amazon's own slug as in the search URL's i= parameter, e.g. \"electronics\", \"kitchen\", \"books\". Empty (default) = all departments. Use when the user names a department (\"in Electronics\").",
      "editor": "textfield",
      "default": ""
    },
    "pages": {
      "title": "Pages per keyword or category",
      "type": "integer",
      "description": "Result pages per keyword or category, 1 to 20, e.g. 3 (default 1). A search page is about 20 organic products plus sponsored ones; a chart page 30. Walking stops early when a page adds nothing new. Cost = pages × rows per page × $0.004: 3 keywords × 2 pages is a little over 100 rows.",
      "editor": "number",
      "minimum": 1,
      "maximum": 20,
      "default": 1,
      "sectionCaption": "How many rows, which rows (filters run before billing)"
    },
    "maxResultsPerQuery": {
      "title": "Max products per keyword or category",
      "type": "integer",
      "description": "0 (default) = every unique ASIN found within pages. N caps the collected rows per keyword/category BEFORE skipSponsored and minRating; those filters can leave fewer than N paid rows. Collection stops at N, the page limit or a page with no new ASINs. Each ASIN is delivered only once across all queries/categories in the run. At most N × $0.004 per target when N > 0; use callOptions.maxTotalChargeUsd for the MCP dollar ceiling.",
      "editor": "number",
      "minimum": 0,
      "maximum": 2000,
      "default": 0
    },
    "skipSponsored": {
      "title": "Skip sponsored results",
      "type": "boolean",
      "description": "true drops rows flagged sponsored before billing; false (default) keeps them. It does NOT renumber position: that remains Amazon's data-index on its page and can have gaps. Use for organic product results, not an exact global organic rank. With maxResultsPerQuery=N, ads are removed from the first N collected rows, so fewer than N may remain. Keep page with position when comparing snapshots.",
      "editor": "checkbox",
      "default": false
    },
    "minRating": {
      "title": "Minimum rating",
      "type": "number",
      "description": "Keep only products rated at or above this, e.g. 4 or 4.5. 0 (default) = every product. Products without a rating are dropped too. Filtered rows are never charged.",
      "editor": "number",
      "minimum": 0,
      "maximum": 5,
      "default": 0
    },
    "categories": {
      "title": "Category charts",
      "type": "array",
      "description": "Category slugs to pull a chart for instead of (or as well as) keywords, e.g. [\"electronics\", \"kitchen\", \"books\"]: the segment after /gp/bestsellers/ in a Best Sellers URL. A chart page renders 30 of its 50 entries; for every rank of the Top 100 use kestrel/amazon-best-sellers-scraper. Empty (default) = no charts.",
      "editor": "stringList",
      "default": [],
      "uniqueItems": true,
      "sectionCaption": "Category charts (optional)"
    },
    "chart": {
      "title": "Chart type",
      "type": "string",
      "description": "\"bestsellers\" (default) or \"new_releases\": which chart to pull for each category above. Ignored for keyword searches. Movers & Shakers is not available (Amazon renders it client-side; the page carries no products).",
      "enum": [
        "bestsellers",
        "new_releases"
      ],
      "enumTitles": [
        "Best Sellers",
        "New Releases"
      ],
      "default": "bestsellers",
      "editor": "select"
    },
    "sessions": {
      "title": "Parallel sessions",
      "type": "integer",
      "description": "Parallel proxy sessions (one egress IP each), 1 to 16, e.g. 4 (default 4). More is faster for long keyword lists; each session is paced separately.",
      "editor": "number",
      "minimum": 1,
      "maximum": 16,
      "default": 4,
      "sectionCaption": "Proxy and pacing"
    },
    "perIp": {
      "title": "Requests per second per IP",
      "type": "number",
      "description": "Requests per second per session, 0.1 to 2 (default 0.5). Amazon tolerates about 0.5/s per IP; faster causes captchas, not speed. Leave the default.",
      "editor": "number",
      "minimum": 0.1,
      "maximum": 2,
      "default": 0.5
    },
    "proxyConfiguration": {
      "title": "Proxy",
      "type": "object",
      "description": "Apify Proxy, default {\"useApifyProxy\": true} (datacentre). Required: Amazon captchas unrotated datacentre traffic and refuses search pages from whole datacentre ranges for minutes at a time; the run rotates the IP on a captcha or 503 and after two refusals in a row moves to residential proxies by itself. Pass {\"useApifyProxy\": true, \"apifyProxyGroups\": [\"RESIDENTIAL\"]} for the most reliable runs.",
      "editor": "proxy",
      "default": {
        "useApifyProxy": true
      }
    }
  },
  "required": [],
  "description": "Amazon search results: {\"queries\":[\"wireless earbuds\"],\"pages\":2,\"maxResultsPerQuery\":20,\"skipSponsored\":true}. Up to $0.08 at $0.004/product; filters can reduce rows. The cap applies BEFORE filters. position is Amazon's page data-index, not a renumbered organic or global rank. For keyword tracking, run one keyword per run: ASINs are deduplicated across all queries. Set callOptions.maxTotalChargeUsd outside input in MCP. Charts here contain partial pages; use the Best Sellers Actor for Top 100."
}
