{
"openapi": "3.0.1",
"info": {
"title": "Snapchat Ads Scraper | Ad Library, Impressions & Targeting",
"description": "Snapchat ads scraper for the Snap Ads Library (Ads Gallery). Search a brand, paste a Gallery link or an ad id and get headline, creative, landing page, catalog products, impressions by country, age and gender targeting, status and dates. 20 ads in 9 seconds, 32 fields each, no Snapchat account.",
"version": "1.0",
"x-build-id": "L7d9i1ufm5i9pUDeK"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~snapchat-ads-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-snapchat-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/silentflow~snapchat-ads-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-snapchat-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/silentflow~snapchat-ads-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-snapchat-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": {
"searchQueries": {
"title": "🔎 Advertisers or brands",
"type": "array",
"description": "The brand or company that paid for the ads: Nike, Zalando, Lidl, Temu. The name is matched anywhere in the paying advertiser's legal name, so nike finds Nike, Inc.. One search per entry; a large brand returns hundreds of ads over the last 12 months, a small one a handful. An ad found twice is delivered once.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Ads Gallery links",
"type": "array",
"description": "Links copied from the Snapchat Ads Gallery (adsgallery.snap.com):- a search, with the country, status and dates you set there:
https://adsgallery.snap.com/?advertiser=Nike&country=DE&status=ACTIVE - one ad:
https://adsgallery.snap.com/?adId=a9e36555-f1e4-4cda-a548-fc3c82c1d096
The filters in a search link win over the form below.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"adIds": {
"title": "🆔 Ad ids",
"type": "array",
"description": "Ad ids from the Gallery or from an earlier run (id field), 36 characters such as a9e36555-f1e4-4cda-a548-fc3c82c1d096. Each id gives one row with fresh impressions and status, so a watchlist of ads refreshes in one run. An id the library no longer carries gives no row and is counted in the run summary.",
"items": {
"type": "string"
}
},
"country": {
"title": "🌍 Country",
"type": "string",
"description": "Keep the ads shown in one country, or in all markets at once. Pick it in the list, or type its code (de, deu), its English name (Germany), or several codes separated by commas (de, fr, nl).",
"default": "all"
},
"startDate": {
"title": "📅 Shown from",
"type": "string",
"description": "Keep the ads that ran on or after this day (2026-09-01). An ad that started earlier and still ran after it is kept. Leave empty for the last 12 months."
},
"endDate": {
"title": "📅 Shown until",
"type": "string",
"description": "Keep the ads that ran on or before this day (2026-09-30). With a start day and no end day, the window runs to today."
},
"status": {
"title": "🚦 Ad status",
"enum": [
"all",
"active",
"paused"
],
"type": "string",
"description": "Active only keeps the ads running today, the ones a competitor is paying for right now. Paused only keeps the ads that stopped.",
"default": "all"
},
"maxItems": {
"title": "🔢 Max ads",
"minimum": 1,
"type": "integer",
"description": "Stop after this many ads, across advertisers, links and ids. Snapchat serves 10 ads per page: 40 ads take about half a minute, 100 ads a few minutes when the library is busy. Set it to what you need, the cost grows with it.",
"default": 100
}
}
},
"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
}
}
}
}
}
}
}
}
}
}