{ "openapi": "3.0.1", "info": { "title": "DuckDuckGo Scraper | Pay Per Event", "description": "DuckDuckGo search scraper that extracts comprehensive search results including organic results, ads, knowledge graph, news, inline images, videos, and related searches. Features localization, safe search, and date. Perfect for market research, SEO analysis, and competitive intelligence.", "version": "0.0", "x-build-id": "XbXffFCELBwbCA8mC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~DuckDuckGoSEOScraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-DuckDuckGoSEOScraper", "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/johnvc~DuckDuckGoSEOScraper/runs": { "post": { "operationId": "runs-sync-johnvc-DuckDuckGoSEOScraper", "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/johnvc~DuckDuckGoSEOScraper/run-sync": { "post": { "operationId": "run-sync-johnvc-DuckDuckGoSEOScraper", "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": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "The search term to search for on DuckDuckGo." }, "localization": { "title": "Localization/Region", "enum": [ "us-en", "uk-en", "ca-en", "au-en", "de-de", "fr-fr", "es-es", "it-it", "nl-nl", "pl-pl", "pt-br", "ru-ru", "ja-jp", "ko-kr", "zh-cn", "zh-tw", "hi-in", "ar-sa", "tr-tr", "sv-se", "da-dk", "no-no", "fi-fi", "cs-cz", "hu-hu", "ro-ro", "bg-bg", "hr-hr", "sk-sk", "sl-si", "et-ee", "lv-lv", "lt-lt", "mt-mt", "el-gr", "cy-cy", "is-is", "mk-mk", "sq-al", "sr-rs", "bs-ba", "me-me" ], "type": "string", "description": "The region and language to use for search results (e.g., 'us-en' for United States English, 'uk-en' for United Kingdom English, 'fr-fr' for French).", "default": "us-en" }, "safe": { "title": "Safe Search", "enum": [ "strict", "moderate", "off" ], "type": "string", "description": "Content filtering level for search results. 'strict'=Strict, 'moderate'=Moderate (default), 'off'=Off", "default": "moderate" }, "date_filter": { "title": "Date Filter", "pattern": "^(d|w|m|y|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2})$", "type": "string", "description": "Filter results by date. Use 'd' (past day), 'w' (past week), 'm' (past month), 'y' (past year), or custom format 'YYYY-MM-DD..YYYY-MM-DD' (e.g., '2024-01-01..2024-01-31')" }, "max_pages": { "title": "Maximum Pages", "minimum": 0, "type": "integer", "description": "Maximum number of pages to fetch (0 = no limit, default: 2 to avoid too many requests).", "default": 2 }, "output_file": { "title": "Output File", "type": "string", "description": "Optional filename to save results. If not provided, will auto-generate based on query and parameters." } } }, "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 } } } } } } } } } }