{ "openapi": "3.0.1", "info": { "title": "๐Ÿ“ข LinkedIn Ads Library Scraper", "description": "LinkedIn Ads Library Scraper extracts LinkedIn ad copy, creatives, headlines, CTAs, landing pages, impressions, targeting, advertisers, payers, and run dates. Built for competitor ad analysis, B2B research, creative intelligence, and AI pipelines.", "version": "1.0", "x-build-id": "vb3YmZ9kuWaM9DErb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/citrine_venus~linkedin-ads-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-citrine_venus-linkedin-ads-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/citrine_venus~linkedin-ads-library-scraper/runs": { "post": { "operationId": "runs-sync-citrine_venus-linkedin-ads-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/citrine_venus~linkedin-ads-library-scraper/run-sync": { "post": { "operationId": "run-sync-citrine_venus-linkedin-ads-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": { "urls": { "title": "๐Ÿ”— LinkedIn Ad Library URLs", "type": "array", "description": "One or more LinkedIn Ad Library search links โ€” e.g. `https://www.linkedin.com/ad-library/search?accountOwner=apify`. Bulk paste, file upload and remote lists are all supported. A company page link such as `https://www.linkedin.com/company/nvidia/` also works, but it gives you no date or country control.", "items": { "type": "string" } }, "searches": { "title": "๐Ÿงฉ Searches", "type": "array", "description": "Build one or more searches from individual filters instead of pasting a link. Each entry becomes its own independent search.", "items": { "type": "object", "properties": { "accountOwner": { "title": "๐Ÿข Company or advertiser", "type": "string", "description": "Company or advertiser name, exactly as it appears on LinkedIn โ€” e.g. `apify`, `Microsoft`, `nvidia`. โš ๏ธ Every search needs at least one of Company, Payer or Keyword.", "editor": "textfield" }, "payer": { "title": "๐Ÿ’ณ Payer", "type": "string", "description": "The entity that paid for the ad, which is often an agency rather than the advertiser itself. โš ๏ธ Every search needs at least one of Company, Payer or Keyword.", "editor": "textfield" }, "keyword": { "title": "๐Ÿ” Keyword", "type": "string", "description": "Word or phrase to look for in the ad copy โ€” e.g. `web scraping`, `black friday`, `hiring`. โš ๏ธ Every search needs at least one of Company, Payer or Keyword.", "editor": "textfield" }, "countries": { "title": "๐ŸŒ Countries", "type": "array", "description": "Only return ads shown in these countries. Leave empty for every country.", "editor": "select", "items": { "type": "string", "enum": [ "ALL", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "CB", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "TP", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KP", "KO", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "GS", "SH", "KN", "LC", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "CS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "OM", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "YU", "ZM", "ZW" ], "enumTitles": [ "๐ŸŒ All countries", "Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Caribbean Nations", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Cote Dโ€™Ivoire (Ivory Coast)", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Federated States of Micronesia", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea", "Korea (North)", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Pakistan", "Palau", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russian Federation", "Rwanda", "S. Georgia and S. Sandwich Islands", "Saint Helena", "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", "Serbia and Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Slovak Republic", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Sultanate of Oman", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Vietnam", "Virgin Islands (British)", "Virgin Islands (U.S.)", "Wallis and Futuna", "Western Sahara", "Yemen", "Yugoslavia", "Zambia", "Zimbabwe" ] } }, "dateOption": { "title": "๐Ÿ“… Date range", "type": "string", "description": "Only return ads that ran in this period. For an exact window, leave this empty and fill in the two dates below instead.", "editor": "select", "enum": [ "last-30-days", "current-month", "current-year", "last-year" ], "enumTitles": [ "๐Ÿ“… Last 30 days", "๐Ÿ—“๏ธ This month", "๐Ÿ“† This year", "๐Ÿ“† Last year" ] }, "startDate": { "title": "๐Ÿš€ Custom start date", "type": "string", "description": "First day of a custom window, as `YYYY-MM-DD`. โš ๏ธ Must be paired with an end date.", "editor": "datepicker", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "errorMessage": { "pattern": "Use the format YYYY-MM-DD, e.g. 2026-01-31." } }, "endDate": { "title": "๐Ÿ Custom end date", "type": "string", "description": "Last day of a custom window, as `YYYY-MM-DD`. โš ๏ธ Must be paired with a start date, and must be **before today** โ€” LinkedIn returns no ads at all for a range that ends today or later, so a today/future date is pulled back to yesterday automatically.", "editor": "datepicker", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "errorMessage": { "pattern": "Use the format YYYY-MM-DD, e.g. 2026-06-30." } }, "sortOrder": { "title": "๐Ÿ”ƒ Sort order", "type": "string", "description": "Newest ads first (the LinkedIn default), or oldest first to start from an advertiser's earliest campaigns.", "editor": "select", "enum": [ "DESCENDING", "ASCENDING" ], "enumTitles": [ "๐Ÿ†• Newest first", "๐Ÿ•ฐ๏ธ Oldest first" ] }, "impressionsMinValue": { "title": "๐Ÿ“‰ Minimum impressions", "type": "integer", "description": "Only return ads with at least this many impressions. Combine with the unit below โ€” e.g. `10` + `Thousand` means 10,000.", "editor": "number", "minimum": 0 }, "impressionsMinUnit": { "title": "๐Ÿ“ Minimum impressions unit", "type": "string", "description": "Multiplier for the minimum impressions value.", "editor": "select", "enum": [ "none", "thousand", "million" ], "enumTitles": [ "๐Ÿ”ข Exact number", "๐Ÿ”ค Thousand (K)", "๐Ÿ”  Million (M)" ] }, "impressionsMaxValue": { "title": "๐Ÿ“ˆ Maximum impressions", "type": "integer", "description": "Only return ads with at most this many impressions. If you fill in only one side of the range, the other is opened up automatically so the search still matches.", "editor": "number", "minimum": 0 }, "impressionsMaxUnit": { "title": "๐Ÿ“ Maximum impressions unit", "type": "string", "description": "Multiplier for the maximum impressions value.", "editor": "select", "enum": [ "none", "thousand", "million" ], "enumTitles": [ "๐Ÿ”ข Exact number", "๐Ÿ”ค Thousand (K)", "๐Ÿ”  Million (M)" ] }, "includedTargetingFacetCategories": { "title": "๐ŸŽฏ Included targeting categories", "type": "array", "description": "Only return ads that use at least one of these targeting categories.", "editor": "select", "items": { "type": "string", "enum": [ "LANGUAGE", "LOCATION", "AUDIENCE", "DEMOGRAPHIC", "COMPANY", "EDUCATION", "JOB", "INTERESTS_AND_TRAITS" ], "enumTitles": [ "๐Ÿ—ฃ๏ธ Language", "๐Ÿ“ Location", "๐Ÿ‘ฅ Audience", "๐Ÿงฌ Demographic", "๐Ÿข Company", "๐ŸŽ“ Education", "๐Ÿ’ผ Job", "๐Ÿ’ก Interests & traits" ] } }, "excludedTargetingFacetCategories": { "title": "๐Ÿšซ Excluded targeting categories", "type": "array", "description": "Skip ads that use any of these targeting categories.", "editor": "select", "items": { "type": "string", "enum": [ "LANGUAGE", "LOCATION", "AUDIENCE", "DEMOGRAPHIC", "COMPANY", "EDUCATION", "JOB", "INTERESTS_AND_TRAITS" ], "enumTitles": [ "๐Ÿ—ฃ๏ธ Language", "๐Ÿ“ Location", "๐Ÿ‘ฅ Audience", "๐Ÿงฌ Demographic", "๐Ÿข Company", "๐ŸŽ“ Education", "๐Ÿ’ผ Job", "๐Ÿ’ก Interests & traits" ] } } }, "additionalProperties": false } }, "resultsLimit": { "title": "๐Ÿ“ฌ Max ads per search", "minimum": 0, "type": "integer", "description": "Stop each search after this many ads. `0` means collect every match. This is a ceiling, not a target โ€” a narrow search simply has fewer ads to give.", "default": 100 }, "skipDetails": { "title": "โšก Skip ad detail pages", "type": "boolean", "description": "Much faster, but thinner records: you get the advertiser, ad copy preview, format and creative from the results list only โ€” no impressions, targeting, run dates, call-to-action or click URL.", "default": false }, "dateFilter": { "title": "๐Ÿ“… Date range (all searches)", "enum": [ "last-30-days", "current-month", "current-year", "last-year" ], "type": "string", "description": "Only collect ads that ran in this period. Overrides the date already present in your links. For an exact window use the two date fields below instead." }, "startDate": { "title": "๐Ÿš€ Custom start date (all searches)", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "First day of a custom window, as `YYYY-MM-DD`. โš ๏ธ Must be paired with an end date." }, "endDate": { "title": "๐Ÿ Custom end date (all searches)", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Last day of a custom window, as `YYYY-MM-DD`. โš ๏ธ Must be paired with a start date, and must be **before today** โ€” LinkedIn returns no ads at all for a range that ends today or later, so a today/future date is pulled back to yesterday automatically." }, "countryFilter": { "title": "๐ŸŒ Countries (all searches)", "type": "array", "description": "Only collect ads shown in these countries. Overrides the countries already present in your links. Leave empty to keep each link's own choice.", "items": { "type": "string", "enum": [ "ALL", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "CB", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "TP", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KP", "KO", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "GS", "SH", "KN", "LC", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "CS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "OM", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "YU", "ZM", "ZW" ], "enumTitles": [ "๐ŸŒ All countries", "Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Caribbean Nations", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Cote Dโ€™Ivoire (Ivory Coast)", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Federated States of Micronesia", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea", "Korea (North)", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Pakistan", "Palau", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russian Federation", "Rwanda", "S. Georgia and S. Sandwich Islands", "Saint Helena", "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", "Serbia and Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Slovak Republic", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Sultanate of Oman", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Vietnam", "Virgin Islands (British)", "Virgin Islands (U.S.)", "Wallis and Futuna", "Western Sahara", "Yemen", "Yugoslavia", "Zambia", "Zimbabwe" ] } }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "By default this Actor connects directly with no proxy, and only escalates to a datacenter and then a residential proxy if it is refused. Pick a group here to pin your own route instead.", "default": { "useApifyProxy": false } }, "maxConcurrency": { "title": "โšก Ads in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many ad pages to read at the same time. `1` is the safest and is plenty for most runs; higher values are faster but far more likely to be throttled.", "default": 1 }, "requestDelay": { "title": "โฑ๏ธ Delay between requests", "minimum": 0, "maximum": 30, "type": "number", "description": "Seconds enforced between the start of any two requests, across the whole run. Raise this to about `4` if you see repeated slow-downs.", "default": 1.5 }, "maxRequestRetries": { "title": "๐Ÿ” Retries per request", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times one request is retried on the current network route before the run steps up to the next route.", "default": 3 }, "maxScanned": { "title": "๐Ÿงฎ Max pages per search", "minimum": 1, "type": "integer", "description": "Safety cap on how many result pages a single search may walk through. The default is far above any real search.", "default": 20000 } } }, "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 } } } } } } } } } }