{
"openapi": "3.0.1",
"info": {
"title": "Pinterest Ad Library Scraper — Ad Search & Export",
"description": "Export ad records from Pinterest's public Ads Repository — pin id, title, image, date range, countries, genders, age buckets, and EU reach. Filter by country, date window, advertiser name, gender, and ad vertical. Covers EU27, Brazil, and Turkey. Deduplicated rows, no login required.",
"version": "0.2",
"x-build-id": "9QeD7FveJE17XNU4a"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~pinterest-ad-library-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-pinterest-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/devilscrapes~pinterest-ad-library-scraper/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-pinterest-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/devilscrapes~pinterest-ad-library-scraper/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-pinterest-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",
"required": [
"start_date",
"country"
],
"properties": {
"start_date": {
"title": "Start date",
"type": "string",
"description": "Repository window start, YYYY-MM-DD. Required."
},
"country": {
"title": "Country",
"type": "string",
"description": "ISO-3166 alpha-2 market to search, e.g. DE. Required. Also pins the proxy exit if Apify Proxy is enabled. The Ads Repository covers EU27, Brazil, and Turkey only — not a global/US ad library."
},
"end_date": {
"title": "End date",
"type": "string",
"description": "Repository window end, YYYY-MM-DD. Optional — omit to search open-ended.",
"default": null
},
"advertiser_name": {
"title": "Advertiser name",
"type": "string",
"description": "Optional free-text advertiser filter. No autocomplete/validation against Pinterest's advertiser list.",
"default": null
},
"fetch_advertiser_details": {
"title": "Fetch real advertiser names (slower)",
"type": "boolean",
"description": "Look up each ad's real merchant/advertiser name from its Pinterest pin page. Off by default: Pinterest's search API never returns advertiser identity, and this costs one extra paced request per unique ad (roughly 1 MB of HTML each), so it meaningfully increases run time. Some rows can still come back null even when enabled — Pinterest throttles rapid per-pin requests.",
"default": false
},
"gender": {
"title": "Gender filter",
"type": "string",
"description": "Optional passthrough gender filter, as accepted by the Ads Repository.",
"default": null
},
"ad_vertical": {
"title": "Ad vertical",
"type": "string",
"description": "Optional passthrough ad-vertical filter, as accepted by the Ads Repository.",
"default": null
},
"maxResults": {
"title": "Max results (per run)",
"minimum": 1,
"maximum": 20000,
"type": "integer",
"description": "Cap on unique deduplicated pin rows written to the dataset.",
"default": 500
},
"maxPages": {
"title": "Max pages",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Soft ceiling on bookmark-cursor pagination round-trips — never a hard-fail condition. At ~25 rows/page and ~5s/page pacing, the default covers a few minutes of fetch time before dedup.",
"default": 20
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify Proxy. The Ads Repository returns 200 with zero proxy, so this defaults to no proxy. If you opt in, the exit country is pinned to Country above — a geo-random exit can otherwise return a plausible but wrong-market result set.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}