{
"openapi": "3.0.1",
"info": {
"title": "Meta Ad Library Scraper - Facebook & Instagram Ads",
"description": "Scrape the Meta Ad Library without the Meta API: Facebook and Instagram ads by keyword or advertiser page, with ad text, headline, link, CTA, image, video, page details, start date, days running, platforms and EU reach. Active or inactive, any country. No account, no start fee. CSV or JSON.",
"version": "1.0",
"x-build-id": "edyG3ZEV6DGdWkOVe"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zaver.api~meta-ad-library-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zaver.api-meta-ad-library-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/zaver.api~meta-ad-library-scraper/runs": {
"post": {
"operationId": "runs-sync-zaver.api-meta-ad-library-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/zaver.api~meta-ad-library-scraper/run-sync": {
"post": {
"operationId": "run-sync-zaver.api-meta-ad-library-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": {
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Search terms, one per line, as you would type them into the Ad Library search box (brand names, product words, phrases).",
"items": {
"type": "string"
}
},
"pages": {
"title": "Advertiser pages",
"type": "array",
"description": "Facebook pages whose ads you want, one per line: page links (https://www.facebook.com/nike), numeric page IDs, Ad Library links with view_all_page_id, or page names (the best match is used).",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"type": "string",
"description": "Two-letter country code of the audience the ads were shown to, such as US, GB, DE, IN, BR.",
"default": "US"
},
"adStatus": {
"title": "Ad status",
"enum": [
"active",
"inactive",
"all"
],
"type": "string",
"description": "Active ads only, inactive only, or both.",
"default": "active"
},
"adType": {
"title": "Ad category",
"enum": [
"all",
"political",
"housing",
"employment",
"credit"
],
"type": "string",
"description": "All ads, or one of the special categories Meta separates in the library.",
"default": "all"
},
"searchType": {
"title": "Keyword matching",
"enum": [
"keyword",
"exact_phrase"
],
"type": "string",
"description": "Whether all words may appear in any order or the exact phrase must match.",
"default": "keyword"
},
"sortBy": {
"title": "Sort",
"enum": [
"relevance",
"impressions"
],
"type": "string",
"description": "Order of the results.",
"default": "relevance"
},
"maxAdsPerQuery": {
"title": "Max ads per keyword or page",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "The Actor pages through the library until it has this many ads for each keyword or page.",
"default": 100
},
"maxItems": {
"title": "Max ads in total",
"minimum": 0,
"maximum": 10000000,
"type": "integer",
"description": "Hard cap on ads for the whole run. 0 means no cap.",
"default": 0
},
"includeDetails": {
"title": "Add ad details",
"type": "boolean",
"description": "Opens each ad's detail record and adds whatever extra data Meta holds for it: more creative cards, EU and UK transparency data (reach, age and gender split, targeting) where the ad ran there, and payer or beneficiary data. Charged as a separate event per ad.",
"default": false
},
"concurrency": {
"title": "Parallel sessions",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "Keywords and pages collected at the same time, each on its own session. Higher is faster; 4 is a safe default.",
"default": 4
}
}
},
"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
}
}
}
}
}
}
}
}
}
}