{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Center Scraper & API",
"description": "Extract published and removed ads from Google Ads Transparency Center, including creatives, advertisers, spend, impressions, targeting, and political statistics. Export JSON, CSV, and Excel.",
"version": "0.0",
"x-build-id": "tES7b0gR1PWL4R1qI"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/clearpath~google-ads-transparency-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-clearpath-google-ads-transparency-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/clearpath~google-ads-transparency-scraper/runs": {
"post": {
"operationId": "runs-sync-clearpath-google-ads-transparency-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/clearpath~google-ads-transparency-scraper/run-sync": {
"post": {
"operationId": "run-sync-clearpath-google-ads-transparency-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": {
"operation": {
"title": "Operation",
"enum": [
"published_ads",
"removed_ads",
"political_statistics"
],
"type": "string",
"description": "Choose published ads, Europe's removed-ad feed, or aggregate political statistics.",
"default": "published_ads"
},
"searchQuery": {
"title": "Search query",
"type": "string",
"description": "Enter an advertiser name, domain, advertiser ID beginning with AR, or a political candidate name. Candidate names are supported for published political ads. Leave empty to use only filters. Removed ads do not support a search query."
},
"queryType": {
"title": "Query type",
"enum": [
"auto",
"advertiser_name",
"domain",
"advertiser_id",
"candidate"
],
"type": "string",
"description": "Use automatic detection, or select an explicit type. Candidate names must be explicit, and additionally need topic political plus at least one supported political region.",
"default": "auto"
},
"advertiserMatchMode": {
"title": "Advertiser matches",
"enum": [
"all",
"best"
],
"type": "string",
"description": "Return ads from all matching advertisers, or only the strongest match by creative count.",
"default": "all"
},
"maxResults": {
"title": "Maximum results",
"minimum": 0,
"type": "integer",
"description": "Maximum ad rows to return. Set 0 for unlimited. Statistics return at most one row.",
"default": 100
},
"topic": {
"title": "Topic",
"enum": [
"all",
"political"
],
"type": "string",
"description": "Choose all ads or political ads. Political statistics always use the political topic.",
"default": "all"
},
"regions": {
"title": "Regions",
"uniqueItems": true,
"type": "array",
"description": "Select every country or region in which the ads were shown. Leave empty for worldwide. Political statistics require exactly one supported political region.",
"items": {
"type": "string",
"enum": [
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AQ",
"AG",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BT",
"BO",
"BA",
"BW",
"BR",
"BN",
"BG",
"BF",
"BI",
"KH",
"CM",
"CA",
"CV",
"BQ",
"CF",
"TD",
"CL",
"CN",
"CX",
"CC",
"CO",
"KM",
"CK",
"CR",
"CI",
"HR",
"CW",
"CY",
"CZ",
"CD",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"SZ",
"ET",
"FM",
"FJ",
"FI",
"FR",
"PF",
"TF",
"GA",
"GE",
"DE",
"GH",
"GR",
"GD",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"HN",
"HU",
"IS",
"IN",
"ID",
"IQ",
"IE",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KI",
"XK",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MG",
"MW",
"MY",
"MV",
"MT",
"ML",
"MH",
"MR",
"MU",
"MX",
"MD",
"MC",
"MN",
"ME",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NL",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"MK",
"MP",
"NO",
"OM",
"PK",
"PW",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"QA",
"CG",
"RO",
"RW",
"SH",
"KN",
"LC",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"SX",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"KR",
"SS",
"ES",
"LK",
"SD",
"SR",
"CH",
"SE",
"TJ",
"TZ",
"TH",
"BS",
"GM",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TV",
"UG",
"UA",
"AE",
"GB",
"US",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"YE",
"ZM",
"ZW",
"BM",
"BV",
"IO",
"VG",
"IC",
"KY",
"TW",
"YT",
"FO",
"FK",
"GF",
"PS",
"GI",
"GL",
"GP",
"HK",
"IM",
"MO",
"MQ",
"MS",
"AW",
"PR",
"RE",
"AI",
"EH",
"MF",
"SJ",
"TC",
"UM",
"VI",
"WF"
],
"enumTitles": [
"Afghanistan",
"Albania",
"Algeria",
"American Samoa",
"Andorra",
"Angola",
"Antarctica",
"Antigua and Barbuda",
"Argentina",
"Armenia",
"Australia",
"Austria",
"Azerbaijan",
"Bahrain",
"Bangladesh",
"Barbados",
"Belarus",
"Belgium",
"Belize",
"Benin",
"Bhutan",
"Bolivia",
"Bosnia and Herzegovina",
"Botswana",
"Brazil",
"Brunei",
"Bulgaria",
"Burkina Faso",
"Burundi",
"Cambodia",
"Cameroon",
"Canada",
"Cabo Verde",
"Caribbean Netherlands",
"Central African Republic",
"Chad",
"Chile",
"China",
"Christmas Island",
"Cocos (Keeling) Islands",
"Colombia",
"Comoros",
"Cook Islands",
"Costa Rica",
"Cote d'Ivoire",
"Croatia",
"Curacao",
"Cyprus",
"Czechia",
"Democratic Republic of the Congo",
"Denmark",
"Djibouti",
"Dominica",
"Dominican Republic",
"Ecuador",
"Egypt",
"El Salvador",
"Equatorial Guinea",
"Eritrea",
"Estonia",
"Eswatini",
"Ethiopia",
"Micronesia",
"Fiji",
"Finland",
"France",
"French Polynesia",
"French Southern and Antarctic Lands",
"Gabon",
"Georgia",
"Germany",
"Ghana",
"Greece",
"Grenada",
"Guam",
"Guatemala",
"Guernsey",
"Guinea",
"Guinea-Bissau",
"Guyana",
"Haiti",
"Heard Island and McDonald Islands",
"Honduras",
"Hungary",
"Iceland",
"India",
"Indonesia",
"Iraq",
"Ireland",
"Israel",
"Italy",
"Jamaica",
"Japan",
"Jersey",
"Jordan",
"Kazakhstan",
"Kenya",
"Kiribati",
"Kosovo",
"Kuwait",
"Kyrgyzstan",
"Laos",
"Latvia",
"Lebanon",
"Lesotho",
"Liberia",
"Libya",
"Liechtenstein",
"Lithuania",
"Luxembourg",
"Madagascar",
"Malawi",
"Malaysia",
"Maldives",
"Malta",
"Mali",
"Marshall Islands",
"Mauritania",
"Mauritius",
"Mexico",
"Moldova",
"Monaco",
"Mongolia",
"Montenegro",
"Morocco",
"Mozambique",
"Myanmar (Burma)",
"Namibia",
"Nauru",
"Nepal",
"Netherlands",
"New Caledonia",
"New Zealand",
"Nicaragua",
"Niger",
"Nigeria",
"Niue",
"Norfolk Island",
"North Macedonia",
"Northern Mariana Islands",
"Norway",
"Oman",
"Pakistan",
"Palau",
"Panama",
"Papua New Guinea",
"Paraguay",
"Peru",
"Philippines",
"Pitcairn Islands",
"Poland",
"Portugal",
"Qatar",
"Republic of the Congo",
"Romania",
"Rwanda",
"Saint Helena, Ascension and Tristan da Cunha",
"Saint Kitts and Nevis",
"Saint Lucia",
"Saint Pierre and Miquelon",
"Saint Vincent and the Grenadines",
"Samoa",
"San Marino",
"Sao Tome and Principe",
"Saudi Arabia",
"Senegal",
"Serbia",
"Seychelles",
"Sierra Leone",
"Singapore",
"Sint Maarten",
"Slovakia",
"Slovenia",
"Solomon Islands",
"Somalia",
"South Africa",
"South Georgia and the South Sandwich Islands",
"South Korea",
"South Sudan",
"Spain",
"Sri Lanka",
"Sudan",
"Suriname",
"Switzerland",
"Sweden",
"Tajikistan",
"Tanzania",
"Thailand",
"The Bahamas",
"The Gambia",
"Timor-Leste",
"Togo",
"Tokelau",
"Tonga",
"Trinidad and Tobago",
"Tunisia",
"Turkiye",
"Turkmenistan",
"Tuvalu",
"Uganda",
"Ukraine",
"United Arab Emirates",
"United Kingdom",
"United States",
"Uruguay",
"Uzbekistan",
"Vanuatu",
"Vatican City",
"Venezuela",
"Vietnam",
"Yemen",
"Zambia",
"Zimbabwe",
"Bermuda",
"Bouvet Island",
"British Indian Ocean Territory",
"British Virgin Islands",
"Canary Islands",
"Cayman Islands",
"Taiwan",
"Mayotte",
"Faroe Islands",
"Falkland Islands (Islas Malvinas)",
"French Guiana",
"Palestine",
"Gibraltar",
"Greenland",
"Guadeloupe",
"Hong Kong",
"Isle of Man",
"Macao",
"Martinique",
"Montserrat",
"Aruba",
"Puerto Rico",
"Reunion",
"Anguilla",
"Western Sahara",
"Saint Martin",
"Svalbard and Jan Mayen",
"Turks and Caicos Islands",
"United States Minor Outlying Islands",
"U.S. Virgin Islands",
"Wallis and Futuna"
]
},
"default": []
},
"platforms": {
"title": "Platforms",
"uniqueItems": true,
"type": "array",
"description": "Select one or more Google surfaces. Leave empty to include every surface.",
"items": {
"type": "string",
"enum": [
"google_search",
"youtube",
"google_shopping",
"google_maps",
"google_play"
],
"enumTitles": [
"Google Search",
"YouTube",
"Google Shopping",
"Google Maps",
"Google Play"
]
},
"default": []
},
"adFormat": {
"title": "Ad format",
"enum": [
"all",
"text",
"image",
"video"
],
"type": "string",
"description": "Return every format, or only text, image, or video ads.",
"default": "all"
},
"dateFrom": {
"title": "Date from",
"type": "string",
"description": "Only include ads shown on or after this date."
},
"dateTo": {
"title": "Date to",
"type": "string",
"description": "Only include ads shown on or before this date."
},
"impressionRanges": {
"title": "Impression ranges",
"uniqueItems": true,
"type": "array",
"description": "Select one or more website impression buckets. Published ads only.",
"items": {
"type": "string",
"enum": [
"RANGE_0_TO_1K",
"RANGE_1K_TO_10K",
"RANGE_10K_TO_50K",
"RANGE_50K_TO_100K",
"RANGE_100K_TO_250K",
"RANGE_250K_TO_500K",
"RANGE_500K_TO_1M",
"RANGE_1M_TO_2500K",
"RANGE_2500K_TO_5M",
"RANGE_5M_TO_10M",
"RANGE_10M_AND_ABOVE"
],
"enumTitles": [
"0 to 1K",
"1K to 10K",
"10K to 50K",
"50K to 100K",
"100K to 250K",
"250K to 500K",
"500K to 1M",
"1M to 2.5M",
"2.5M to 5M",
"5M to 10M",
"10M and above"
]
},
"default": []
},
"spendRanges": {
"title": "Spend ranges",
"uniqueItems": true,
"type": "array",
"description": "Select one or more currency-specific spend buckets from the complete website catalog. Published ads only.",
"items": {
"type": "string",
"enum": [
"ARS:RANGE_0_TO_15K",
"ARS:RANGE_15K_TO_150K",
"ARS:RANGE_150K_TO_500K",
"ARS:RANGE_500K_TO_1M",
"ARS:RANGE_1M_AND_ABOVE",
"AUD:RANGE_0_TO_150",
"AUD:RANGE_150_TO_750",
"AUD:RANGE_750_TO_1K",
"AUD:RANGE_1K_TO_5K",
"AUD:RANGE_5K_TO_10K",
"AUD:RANGE_10K_TO_50K",
"AUD:RANGE_50K_TO_100K",
"AUD:RANGE_100K_TO_250K",
"AUD:RANGE_250K_TO_500K",
"AUD:RANGE_500K_TO_1M",
"AUD:RANGE_1M_TO_3M",
"AUD:RANGE_3M_AND_ABOVE",
"BGN:RANGE_0_TO_26",
"BGN:RANGE_26_TO_250",
"BGN:RANGE_250_TO_10K",
"BGN:RANGE_10K_TO_25K",
"BGN:RANGE_25K_AND_ABOVE",
"BRL:RANGE_0_TO_500",
"BRL:RANGE_500_TO_5K",
"BRL:RANGE_5K_TO_25K",
"BRL:RANGE_25K_TO_50K",
"BRL:RANGE_50K_TO_100K",
"BRL:RANGE_100K_AND_ABOVE",
"CLP:RANGE_0_TO_50K",
"CLP:RANGE_50K_TO_500K",
"CLP:RANGE_500K_TO_1M",
"CLP:RANGE_1M_AND_ABOVE",
"CZK:RANGE_0_TO_1K",
"CZK:RANGE_1K_TO_10K",
"CZK:RANGE_10K_TO_500K",
"CZK:RANGE_500K_TO_1M",
"CZK:RANGE_1M_AND_ABOVE",
"DKK:RANGE_0_TO_500",
"DKK:RANGE_500_TO_5K",
"DKK:RANGE_5K_TO_250K",
"DKK:RANGE_250K_TO_500K",
"DKK:RANGE_500K_AND_ABOVE",
"EUR:RANGE_0_TO_50",
"EUR:RANGE_50_TO_500",
"EUR:RANGE_500_TO_1K",
"EUR:RANGE_1K_TO_5K",
"EUR:RANGE_5K_TO_10K",
"EUR:RANGE_10K_TO_50K",
"EUR:RANGE_50K_TO_100K",
"EUR:RANGE_100K_TO_250K",
"EUR:RANGE_250K_TO_500K",
"EUR:RANGE_500K_TO_1M",
"EUR:RANGE_1M_TO_3M",
"EUR:RANGE_3M_AND_ABOVE",
"GBP:RANGE_0_TO_50",
"GBP:RANGE_50_TO_500",
"GBP:RANGE_500_TO_1K",
"GBP:RANGE_1K_TO_5K",
"GBP:RANGE_5K_TO_10K",
"GBP:RANGE_10K_TO_50K",
"GBP:RANGE_50K_TO_100K",
"GBP:RANGE_100K_TO_250K",
"GBP:RANGE_250K_TO_500K",
"GBP:RANGE_500K_TO_1M",
"GBP:RANGE_1M_TO_3M",
"GBP:RANGE_3M_AND_ABOVE",
"HRK:RANGE_0_TO_100",
"HRK:RANGE_100_TO_1500",
"HRK:RANGE_1500_TO_7500",
"HRK:RANGE_7500_TO_150K",
"HRK:RANGE_150K_AND_ABOVE",
"HUF:RANGE_0_TO_7500",
"HUF:RANGE_7500_TO_75K",
"HUF:RANGE_75K_TO_375K",
"HUF:RANGE_375K_TO_750K",
"HUF:RANGE_750K_AND_ABOVE",
"ILS:RANGE_0_TO_250",
"ILS:RANGE_250_TO_1K",
"ILS:RANGE_1K_TO_5K",
"ILS:RANGE_5K_TO_10K",
"ILS:RANGE_10K_TO_50K",
"ILS:RANGE_50K_TO_100K",
"ILS:RANGE_100K_TO_250K",
"ILS:RANGE_250K_TO_500K",
"ILS:RANGE_500K_TO_1M",
"ILS:RANGE_1M_TO_3M",
"ILS:RANGE_3M_AND_ABOVE",
"INR:RANGE_0_TO_250",
"INR:RANGE_250_TO_1K",
"INR:RANGE_1K_TO_5K",
"INR:RANGE_5K_TO_10K",
"INR:RANGE_10K_TO_50K",
"INR:RANGE_50K_TO_100K",
"INR:RANGE_100K_TO_250K",
"INR:RANGE_250K_TO_500K",
"INR:RANGE_500K_TO_1M",
"INR:RANGE_1M_TO_3M",
"INR:RANGE_3M_AND_ABOVE",
"MXN:RANGE_0_TO_1K",
"MXN:RANGE_1K_TO_10K",
"MXN:RANGE_10K_TO_100K",
"MXN:RANGE_100K_AND_ABOVE",
"NZD:RANGE_0_TO_200",
"NZD:RANGE_200_TO_1K",
"NZD:RANGE_1K_TO_5K",
"NZD:RANGE_5K_TO_10K",
"NZD:RANGE_10K_TO_50K",
"NZD:RANGE_50K_TO_100K",
"NZD:RANGE_100K_TO_250K",
"NZD:RANGE_250K_TO_500K",
"NZD:RANGE_500K_TO_1M",
"NZD:RANGE_1M_TO_3M",
"NZD:RANGE_3M_AND_ABOVE",
"PLN:RANGE_0_TO_100",
"PLN:RANGE_100_TO_1K",
"PLN:RANGE_1K_TO_50K",
"PLN:RANGE_50K_TO_100K",
"PLN:RANGE_100K_AND_ABOVE",
"RON:RANGE_0_TO_76",
"RON:RANGE_76_TO_750",
"RON:RANGE_750_TO_37500",
"RON:RANGE_37500_TO_75K",
"RON:RANGE_75K_AND_ABOVE",
"SEK:RANGE_0_TO_750",
"SEK:RANGE_750_TO_7500",
"SEK:RANGE_7500_TO_375K",
"SEK:RANGE_375K_TO_750K",
"SEK:RANGE_750K_AND_ABOVE",
"TWD:RANGE_0_TO_3K",
"TWD:RANGE_3K_TO_15K",
"TWD:RANGE_15K_TO_50K",
"TWD:RANGE_50K_TO_100K",
"TWD:RANGE_100K_TO_250K",
"TWD:RANGE_250K_TO_500K",
"TWD:RANGE_500K_TO_1M",
"TWD:RANGE_1M_TO_3M",
"TWD:RANGE_3M_AND_ABOVE",
"USD:RANGE_0_TO_100",
"USD:RANGE_100_TO_1K",
"USD:RANGE_1K_TO_5K",
"USD:RANGE_5K_TO_10K",
"USD:RANGE_10K_TO_50K",
"USD:RANGE_50K_TO_100K",
"USD:RANGE_100K_TO_250K",
"USD:RANGE_250K_TO_500K",
"USD:RANGE_500K_TO_1M",
"USD:RANGE_1M_TO_3M",
"USD:RANGE_3M_AND_ABOVE",
"ZAR:RANGE_0_TO_15K",
"ZAR:RANGE_15K_TO_150K",
"ZAR:RANGE_150K_TO_500K",
"ZAR:RANGE_500K_TO_1M",
"ZAR:RANGE_1M_AND_ABOVE"
],
"enumTitles": [
"ARS 0 to 15K",
"ARS 15K to 150K",
"ARS 150K to 500K",
"ARS 500K to 1M",
"ARS 1M and above",
"AUD 0 to 150",
"AUD 150 to 750",
"AUD 750 to 1K",
"AUD 1K to 5K",
"AUD 5K to 10K",
"AUD 10K to 50K",
"AUD 50K to 100K",
"AUD 100K to 250K",
"AUD 250K to 500K",
"AUD 500K to 1M",
"AUD 1M to 3M",
"AUD 3M and above",
"BGN 0 to 26",
"BGN 26 to 250",
"BGN 250 to 10K",
"BGN 10K to 25K",
"BGN 25K and above",
"BRL 0 to 500",
"BRL 500 to 5K",
"BRL 5K to 25K",
"BRL 25K to 50K",
"BRL 50K to 100K",
"BRL 100K and above",
"CLP 0 to 50K",
"CLP 50K to 500K",
"CLP 500K to 1M",
"CLP 1M and above",
"CZK 0 to 1K",
"CZK 1K to 10K",
"CZK 10K to 500K",
"CZK 500K to 1M",
"CZK 1M and above",
"DKK 0 to 500",
"DKK 500 to 5K",
"DKK 5K to 250K",
"DKK 250K to 500K",
"DKK 500K and above",
"EUR 0 to 50",
"EUR 50 to 500",
"EUR 500 to 1K",
"EUR 1K to 5K",
"EUR 5K to 10K",
"EUR 10K to 50K",
"EUR 50K to 100K",
"EUR 100K to 250K",
"EUR 250K to 500K",
"EUR 500K to 1M",
"EUR 1M to 3M",
"EUR 3M and above",
"GBP 0 to 50",
"GBP 50 to 500",
"GBP 500 to 1K",
"GBP 1K to 5K",
"GBP 5K to 10K",
"GBP 10K to 50K",
"GBP 50K to 100K",
"GBP 100K to 250K",
"GBP 250K to 500K",
"GBP 500K to 1M",
"GBP 1M to 3M",
"GBP 3M and above",
"HRK 0 to 100",
"HRK 100 to 1500",
"HRK 1500 to 7500",
"HRK 7500 to 150K",
"HRK 150K and above",
"HUF 0 to 7500",
"HUF 7500 to 75K",
"HUF 75K to 375K",
"HUF 375K to 750K",
"HUF 750K and above",
"ILS 0 to 250",
"ILS 250 to 1K",
"ILS 1K to 5K",
"ILS 5K to 10K",
"ILS 10K to 50K",
"ILS 50K to 100K",
"ILS 100K to 250K",
"ILS 250K to 500K",
"ILS 500K to 1M",
"ILS 1M to 3M",
"ILS 3M and above",
"INR 0 to 250",
"INR 250 to 1K",
"INR 1K to 5K",
"INR 5K to 10K",
"INR 10K to 50K",
"INR 50K to 100K",
"INR 100K to 250K",
"INR 250K to 500K",
"INR 500K to 1M",
"INR 1M to 3M",
"INR 3M and above",
"MXN 0 to 1K",
"MXN 1K to 10K",
"MXN 10K to 100K",
"MXN 100K and above",
"NZD 0 to 200",
"NZD 200 to 1K",
"NZD 1K to 5K",
"NZD 5K to 10K",
"NZD 10K to 50K",
"NZD 50K to 100K",
"NZD 100K to 250K",
"NZD 250K to 500K",
"NZD 500K to 1M",
"NZD 1M to 3M",
"NZD 3M and above",
"PLN 0 to 100",
"PLN 100 to 1K",
"PLN 1K to 50K",
"PLN 50K to 100K",
"PLN 100K and above",
"RON 0 to 76",
"RON 76 to 750",
"RON 750 to 37500",
"RON 37500 to 75K",
"RON 75K and above",
"SEK 0 to 750",
"SEK 750 to 7500",
"SEK 7500 to 375K",
"SEK 375K to 750K",
"SEK 750K and above",
"TWD 0 to 3K",
"TWD 3K to 15K",
"TWD 15K to 50K",
"TWD 50K to 100K",
"TWD 100K to 250K",
"TWD 250K to 500K",
"TWD 500K to 1M",
"TWD 1M to 3M",
"TWD 3M and above",
"USD 0 to 100",
"USD 100 to 1K",
"USD 1K to 5K",
"USD 5K to 10K",
"USD 10K to 50K",
"USD 50K to 100K",
"USD 100K to 250K",
"USD 250K to 500K",
"USD 500K to 1M",
"USD 1M to 3M",
"USD 3M and above",
"ZAR 0 to 15K",
"ZAR 15K to 150K",
"ZAR 150K to 500K",
"ZAR 500K to 1M",
"ZAR 1M and above"
]
},
"default": []
},
"sort": {
"title": "Sort",
"enum": [
"default",
"most_recent",
"oldest",
"spend_high_to_low",
"spend_low_to_high",
"impressions_high_to_low",
"impressions_low_to_high"
],
"type": "string",
"description": "Choose the order for published ads. Removed ads and statistics do not support sorting.",
"default": "default"
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}