{ "openapi": "3.0.1", "info": { "title": "ChatGPT Ads Scraper", "description": "ChatGPT Ads Scraper collects the sponsored ads ChatGPT shows under answers to shopping questions: advertiser, product, price, rating, image and landing page. Use it to see which brands advertise on your topics, check your own ads appear, or track ChatGPT ads over time.", "version": "0.0", "x-build-id": "BnunoIthYbDdp1dDa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gytelio1~chatgpt-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gytelio1-chatgpt-ads-scraper", "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/gytelio1~chatgpt-ads-scraper/runs": { "post": { "operationId": "runs-sync-gytelio1-chatgpt-ads-scraper", "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/gytelio1~chatgpt-ads-scraper/run-sync": { "post": { "operationId": "run-sync-gytelio1-chatgpt-ads-scraper", "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": [ "queries" ], "properties": { "queries": { "title": "Questions", "uniqueItems": true, "type": "array", "description": "See which brands advertise for these questions. Name a brand or model, like \"best Nike running shoes\" or \"Nike Pegasus 42\", to steer the chat toward it. Product topics like gaming, toys, shoes, and electronics get the most ads. Health and politics get none.", "items": { "type": "string" } }, "chatsPerItem": { "title": "Chats per question", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many chats each question gets. More chats, more ads. Each chat costs $0.045, so a run costs about $0.045 × questions × chats, plus ads. About 2 minutes each, and more memory runs more chats at once.", "default": 24 }, "country": { "title": "Country", "pattern": "^[A-Za-z]{2}$", "minLength": 2, "maxLength": 2, "type": "string", "description": "Two-letter country code, like US, GB, or DE. Chats run from this country, so you see the ads shown there. ChatGPT shows the most ads in the US. Write your questions in English: follow-ups are in English too, whatever the country.", "default": "US" }, "saveScreenshots": { "title": "Save ad proof", "type": "boolean", "description": "Save a screenshot of each ad with the end of ChatGPT's answer above it, and the ad's HTML with all the data ChatGPT sent. Proof the ad was shown and what it was shown under. Linked from screenshotUrl and htmlUrl in the results. Adds a few seconds per ad, no extra charge.", "default": false }, "followUpQueries": { "title": "Follow-up questions", "maxItems": 8, "type": "array", "description": "Sent in order after every question, so keep them general, like \"Which one should I buy?\". Stay on the same topic and ask about buying: a new topic brings ads that get counted under your question. ChatGPT doesn't show ads on the first message, so follow-ups about buying keep the chat going until one shows. Up to 8. Ignored when Generate follow-ups is on.", "items": { "type": "string" } }, "generateFollowUps": { "title": "Generate follow-ups (experimental)", "type": "boolean", "description": "AI writes each follow-up from ChatGPT's last answer, naming the products it just brought up and staying on your question. Leave off to compare brands: every chat sends the same Follow-up questions, so counts are comparable. Replaces Follow-up questions.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }