{ "openapi": "3.0.1", "info": { "title": "Instagram Ads Scraper: Ad Library & Creatives", "description": "Instagram ads scraper for the Meta Ad Library: paste an advertiser's Instagram or Facebook link, a page id or a name, or type keywords, and get every Instagram ad with its copy, images, videos, landing page, CTA, start date, days running and variants. For competitor creative research. No login.", "version": "0.1", "x-build-id": "xNw0JIgEVt2GIe450" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deepmine~instagram-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deepmine-instagram-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/deepmine~instagram-ads-scraper/runs": { "post": { "operationId": "runs-sync-deepmine-instagram-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/deepmine~instagram-ads-scraper/run-sync": { "post": { "operationId": "run-sync-deepmine-instagram-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", "properties": { "advertisers": { "title": "🏢 Advertisers (links, ids or names)", "type": "array", "description": "Brands whose Instagram ads you want: an Instagram or Facebook profile link (instagram.com/gymshark), an @handle, a page id, an advertiser's Ad Library link, or the name as it shows on its ads. Newest ads first.", "items": { "type": "string" } }, "searchQueries": { "title": "🔍 Keywords", "type": "array", "description": "Words to find Instagram ads by, as you'd type them in the Ad Library search box, e.g. protein powder. One search per line. A keyword search costs more per ad than an advertiser search (see Pricing).", "items": { "type": "string" } }, "country": { "title": "🌍 Country", "type": "string", "description": "Two-letter code of the country where the ads ran (US, GB, DE, ...), or ALL for every country.", "default": "ALL" }, "maxAdsPerQuery": { "title": "💯 Max ads per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop each advertiser, keyword or link after this many ads. You pay per ad, so this caps each search's cost. Up to 10,000.", "default": 200 }, "includeAdDetails": { "title": "📋 Include ad details ($)", "type": "boolean", "description": "Also read each ad's details: the advertiser's verification, Instagram account and followers and, for ads shown in the EU or UK, reach by country, ages and gender, payer and beneficiary. Charged only for ads whose details came.", "default": false }, "activeStatus": { "title": "Ad status", "enum": [ "active", "inactive", "all" ], "type": "string", "description": "Only ads running now, only ads that stopped, or both.", "default": "active" }, "mediaType": { "title": "Media type", "enum": [ "all", "image", "video", "meme", "image_and_meme", "none" ], "type": "string", "description": "Only ads with this kind of media.", "default": "all" }, "dateFrom": { "title": "📅 Shown on or after", "type": "string", "description": "Only ads shown on or after this date, whatever day they started (the Ad Library's own filter), e.g. 2026-10-01. An advertiser search with dates is priced as a keyword search. Empty = any time." }, "dateTo": { "title": "📅 Shown on or before", "type": "string", "description": "Only ads shown on or before this date. Empty = up to today." }, "exactPhrase": { "title": "Exact phrase", "type": "boolean", "description": "Match the keywords as an exact phrase instead of in any order.", "default": false }, "adType": { "title": "Ad category", "enum": [ "all", "political_and_issue_ads" ], "type": "string", "description": "All ads, or only ads about social issues, elections or politics (these carry spend and impressions ranges).", "default": "all" }, "startUrls": { "title": "🔗 Ad Library links", "type": "array", "description": "Searches copied from facebook.com/ads/library in your browser. The link's own filters (country, status, media, dates) are used; the platform is always Instagram.", "items": { "type": "string" } }, "adIds": { "title": "🆔 Ad Library IDs", "type": "array", "description": "Single ads by their Library ID (e.g. 1234567890123456) or their Ad Library link with ?id=. Priced as advertiser ads.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: residential proxies (US) are needed past the first page of results; the first pages are read on cheaper datacenter IPs on their own.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }