{ "openapi": "3.0.1", "info": { "title": "Competitor Price Tracker & Price Comparison by Product URL", "description": "Paste any product URL to get every retailer selling the same item, live prices, your market rank, and a suggested pricing action. Matches are strictly verified by UPC, EAN, GTIN, and MPN, with no fuzzy titles or foreign currency guesses. Works on Amazon, Walmart, Target, Best Buy, eBay, and Shopify.", "version": "0.0", "x-build-id": "0OLjz5yetcoW7ZRwc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fayoussef~competitor-price-tracker-price-comparison-by-product-url/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fayoussef-competitor-price-tracker-price-comparison-by-product-url", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fayoussef~competitor-price-tracker-price-comparison-by-product-url/runs": { "post": { "operationId": "runs-sync-fayoussef-competitor-price-tracker-price-comparison-by-product-url", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fayoussef~competitor-price-tracker-price-comparison-by-product-url/run-sync": { "post": { "operationId": "run-sync-fayoussef-competitor-price-tracker-price-comparison-by-product-url", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "productUrls" ], "properties": { "productUrls": { "title": "Product URLs", "type": "array", "description": "Reference product URLs to track. Use canonical product pages (e.g. /dp/B0XXXXX), not /offer-listing/ pages. Each URL is processed in parallel.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "se", "pl", "ae", "sa", "za", "br", "mx", "in", "jp", "sg" ], "type": "string", "description": "ISO-3166 country code. Controls Google SERP geo-targeting AND residential proxy country for page fetches.", "default": "us" }, "currency": { "title": "Target Currency", "type": "string", "description": "ISO-4217 currency code (e.g. USD, EUR, GBP). Competitor prices in any other currency are dropped (not converted) so all reported prices are comparable.", "default": "USD" }, "maxCompetitors": { "title": "Max competitors per product", "minimum": 1, "maximum": 50, "type": "integer", "description": "Stop searching once this many confirmed matches are found per product.", "default": 10 }, "maxPages": { "title": "Google SERP pages per product", "minimum": 1, "maximum": 5, "type": "integer", "description": "Number of Google search result pages to scan for each product. Each page yields ~10 candidate URLs.", "default": 2 }, "excludedDomains": { "title": "Additional excluded domains", "type": "array", "description": "Domains to skip when scanning competitors (in addition to the built-in social/review/hard-blocked list).", "default": [], "items": { "type": "string" } }, "includedDomains": { "title": "Additional included domains", "type": "array", "description": "If provided, the Google search query is restricted to these domains via `site:` operators (e.g. amazon.com, walmart.com). Leave empty to search the whole web.", "default": [], "items": { "type": "string" } }, "model": { "title": "AI model", "enum": [ "anthropic/claude-opus-5-fast", "anthropic/claude-opus-5", "anthropic/claude-sonnet-5", "anthropic/claude-opus-4.8-fast", "anthropic/claude-opus-4.8", "anthropic/claude-opus-4.7-fast", "anthropic/claude-opus-4.7", "anthropic/claude-sonnet-4.6", "anthropic/claude-opus-4.6", "anthropic/claude-opus-4.5", "anthropic/claude-haiku-4.5", "anthropic/claude-sonnet-4.5", "anthropic/claude-opus-4.1", "anthropic/claude-opus-4", "anthropic/claude-sonnet-4", "anthropic/claude-3-haiku", "anthropic/claude-fable-5", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "google/gemini-3.1-flash-lite-preview", "google/gemini-3.1-pro-preview-customtools", "google/gemini-3.1-pro-preview", "google/gemini-3-flash-preview", "google/gemini-2.5-flash-lite", "google/gemini-2.5-flash", "google/gemini-2.5-pro", "google/gemini-2.5-pro-preview", "google/gemini-2.5-pro-preview-05-06", "google/gemma-4-26b-a4b-it", "google/gemma-4-31b-it", "google/gemma-3n-e4b-it", "google/gemma-3-4b-it", "google/gemma-3-12b-it", "google/gemma-3-27b-it", "google/gemma-2-27b-it", "google/gemma-4-26b-a4b-it:free", "google/gemma-4-31b-it:free", "openai/gpt-5.6-luna-pro", "openai/gpt-5.6-luna", "openai/gpt-5.6-terra-pro", "openai/gpt-5.6-terra", "openai/gpt-5.6-sol-pro", "openai/gpt-5.6-sol", "openai/gpt-5.5-pro", "openai/gpt-5.5", "openai/gpt-5.4-nano", "openai/gpt-5.4-mini", "openai/gpt-5.4-pro", "openai/gpt-5.4", "openai/gpt-5.3-chat", "openai/gpt-5.3-codex", "openai/gpt-5.2-codex", "openai/gpt-5.2-chat", "openai/gpt-5.2-pro", "openai/gpt-5.2", "openai/gpt-5.1-codex-max", "openai/gpt-5.1", "openai/gpt-5.1-chat", "openai/gpt-5.1-codex", "openai/gpt-5.1-codex-mini", "openai/o3-deep-research", "openai/o4-mini-deep-research", "openai/gpt-5-pro", "openai/gpt-5-codex", "openai/gpt-5", "openai/gpt-5-mini", "openai/gpt-5-nano", "openai/o3-pro", "openai/o4-mini-high", "openai/o3", "openai/o4-mini", "openai/gpt-4.1", "openai/gpt-4.1-mini", "openai/gpt-4.1-nano", "openai/o3-mini-high", "openai/o3-mini", "openai/gpt-4o-2024-11-20", "openai/gpt-4o-2024-08-06", "openai/gpt-4o-mini", "openai/gpt-4o-mini-2024-07-18", "openai/gpt-4o", "openai/gpt-4o-2024-05-13", "openai/gpt-4-turbo", "openai/gpt-4-turbo-preview", "openai/gpt-4", "openai/gpt-chat-latest", "openai/gpt-oss-120b", "openai/gpt-oss-20b", "openai/o1-pro", "openai/o1", "openai/gpt-3.5-turbo-0613", "openai/gpt-3.5-turbo-instruct", "openai/gpt-3.5-turbo-16k", "openai/gpt-3.5-turbo", "openai/gpt-oss-20b:free", "deepseek/deepseek-v3.2", "deepseek/deepseek-v3.2-exp", "deepseek/deepseek-v3.1-terminus", "deepseek/deepseek-chat-v3.1", "deepseek/deepseek-r1-0528", "deepseek/deepseek-chat-v3-0324", "deepseek/deepseek-r1-distill-llama-70b", "deepseek/deepseek-r1", "deepseek/deepseek-chat", "deepseek/deepseek-v4-pro", "deepseek/deepseek-v4-flash", "x-ai/grok-4.5", "x-ai/grok-4.3", "x-ai/grok-4.20-multi-agent", "x-ai/grok-4.20", "x-ai/grok-build-0.1", "meta-llama/llama-4-maverick", "meta-llama/llama-4-scout", "meta-llama/llama-3.1-70b-instruct", "meta-llama/llama-3.1-8b-instruct", "meta-llama/llama-3.3-70b-instruct", "meta-llama/llama-3.2-1b-instruct", "meta-llama/llama-3.2-3b-instruct", "qwen/qwen3.7-flash", "qwen/qwen3.7-plus", "qwen/qwen3.7-max", "qwen/qwen3.5-plus-20260420", "qwen/qwen3.6-flash", "qwen/qwen3.6-35b-a3b", "qwen/qwen3.6-max-preview", "qwen/qwen3.6-27b", "qwen/qwen3.6-plus", "qwen/qwen3.5-9b", "qwen/qwen3.5-35b-a3b", "qwen/qwen3.5-27b", "qwen/qwen3.5-122b-a10b", "qwen/qwen3.5-flash-02-23", "qwen/qwen3.5-plus-02-15", "qwen/qwen3.5-397b-a17b", "qwen/qwen3-max-thinking", "qwen/qwen3-coder-next", "qwen/qwen3-vl-32b-instruct", "qwen/qwen3-vl-8b-thinking", "qwen/qwen3-vl-8b-instruct", "qwen/qwen3-vl-30b-a3b-thinking", "qwen/qwen3-vl-30b-a3b-instruct", "qwen/qwen3-vl-235b-a22b-thinking", "qwen/qwen3-vl-235b-a22b-instruct", "qwen/qwen3-max", "qwen/qwen3-coder-plus", "qwen/qwen3-coder-flash", "qwen/qwen3-next-80b-a3b-thinking", "qwen/qwen3-next-80b-a3b-instruct" ], "type": "string", "description": "The AI model used to confirm product matches. The list is the live model catalog, ordered by popularity, with each model's real price per million tokens. The default is a cheap, fast model that is accurate enough for match confirmation: pick a bigger one only if you scrape pages where matching is genuinely hard. Need a model that is not listed? Fill in `customModel` below, which overrides this selection.", "default": "meta-llama/llama-3.1-8b-instruct" }, "customModel": { "title": "Custom model (optional, overrides the dropdown)", "type": "string", "description": "Any OpenRouter-compatible model ID (e.g. `openai/o1-mini`, `x-ai/grok-2`, `cohere/command-r-plus`). If set, this overrides the `AI model` selection above. Browse the full catalog at https://openrouter.ai/models." }, "scrapedoApiKey": { "title": "Scraper API Key (required for reliable scraping of most sites)", "type": "string", "description": "**Strongly recommended, and required if you want most sites (Amazon, eBay, Walmart, Cloudflare-protected stores, etc.) to actually be scraped.** Without this key the actor only uses curl_cffi + residential proxy, which is blocked by most major retailers and will return empty results for them.\n\nGet a **free** key with 1000 credits/month using my referral link: https://scrape.do/?fpr=automationbyexperts (sign up, copy your token, paste it here).\n\nDomains listed in `src/scrapedo_direct_domains.txt` (Amazon, eBay by default) skip curl_cffi entirely and go straight through this API to save retry cycles." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }