{ "openapi": "3.1.0", "info": { "title": "Search Query Autocomplete API", "version": "Unversioned", "description": "Search autocomplete across Google, Bing, DuckDuckGo and YouTube, plus DuckDuckGo search and discovery tools.", "x-pricing-model": "payg", "x-free-tier-calls": 0, "x-docs-url": "", "x-dakidarts-contract-status": "published", "x-dakidarts-execution-status": "source-only" }, "servers": [ { "url": "https://api.dakidarts.com/search-query-autocomplete", "description": "Dakidarts direct gateway" } ], "tags": [ { "name": "Operations", "description": "Operations endpoints sourced from the Search Query Autocomplete API implementation." }, { "name": "Autocomplete", "description": "Autocomplete endpoints sourced from the Search Query Autocomplete API implementation." }, { "name": "DuckDuckGo search", "description": "DuckDuckGo search endpoints sourced from the Search Query Autocomplete API implementation." } ], "paths": { "/status": { "get": { "summary": "Ping", "description": "Returns Search Query Autocomplete service health.", "operationId": "search-query-autocomplete_get_status", "tags": [ "Operations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "example": { "status": "API is online" } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true, "x-dakidarts-sample-response": { "status": "API is online" } }, "post": { "summary": "Ping", "description": "Returns Search Query Autocomplete service health.", "operationId": "search-query-autocomplete_post_status", "tags": [ "Operations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "example": { "status": "API is online" } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true, "x-dakidarts-sample-response": { "status": "API is online" } } }, "/{endpoint}": { "get": { "summary": "Autocomplete", "description": "Returns autocomplete suggestions from the selected search provider.", "operationId": "search-query-autocomplete_get_{endpoint}", "tags": [ "Autocomplete" ], "parameters": [ { "name": "query", "in": "query", "required": false, "description": "Search phrase or partial query to complete.", "schema": { "type": "string", "default": "" } }, { "name": "endpoint", "in": "path", "required": true, "description": "Autocomplete provider name; supported values are google, bing, duckduckgo, and youtube.", "schema": { "type": "string", "enum": [ "google", "bing", "duckduckgo", "youtube" ], "example": "google" }, "example": "google" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "description": "Dynamic source value; no concrete response example is published." }, "details": { "type": "object", "additionalProperties": true }, "message": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "suggestion": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Autocomplete", "description": "Returns autocomplete suggestions from the selected search provider.", "operationId": "search-query-autocomplete_post_{endpoint}", "tags": [ "Autocomplete" ], "parameters": [ { "name": "endpoint", "in": "path", "required": true, "description": "Autocomplete provider name; supported values are google, bing, duckduckgo, and youtube.", "schema": { "type": "string", "enum": [ "google", "bing", "duckduckgo", "youtube" ], "example": "google" }, "example": "google" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "description": "Dynamic source value; no concrete response example is published." }, "details": { "type": "object", "additionalProperties": true }, "message": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "suggestion": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": false, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "query": { "type": "string", "default": "" } }, "example": { "query": "dakidarts" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/search": { "get": { "summary": "Search", "description": "Searches DuckDuckGo and returns ranked web results.", "operationId": "search-query-autocomplete_get_ddgs_search", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Search query string.", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of suggestions or results to return.", "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Search", "description": "Searches DuckDuckGo and returns ranked web results.", "operationId": "search-query-autocomplete_post_ddgs_search", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "q": { "type": "string" }, "limit": { "type": "integer", "default": 10 } }, "required": [ "q" ], "example": { "q": "dakidarts API", "limit": 10 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/proxy/search": { "get": { "summary": "Proxy Search", "description": "Searches DuckDuckGo through the requested proxy configuration.", "operationId": "search-query-autocomplete_get_ddgs_proxy_search", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Search query string.", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of suggestions or results to return.", "schema": { "type": "integer", "default": 10 } }, { "name": "proxy", "in": "query", "required": false, "description": "Proxy URL or proxy mode used for the upstream search request.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Proxy Search", "description": "Searches DuckDuckGo through the requested proxy configuration.", "operationId": "search-query-autocomplete_post_ddgs_proxy_search", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "q": { "type": "string" }, "limit": { "type": "integer", "default": 10 }, "proxy": { "type": "string" } }, "required": [ "q" ], "example": { "q": "dakidarts API", "limit": 10, "proxy": "http://127.0.0.1:8080" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/blaze/search": { "get": { "summary": "Blaze Search", "description": "Runs a DuckDuckGo search with configurable region, safe-search, time range, and backend.", "operationId": "search-query-autocomplete_get_ddgs_blaze_search", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "description": "Search region or locale code.", "schema": { "type": "string", "default": "wt-wt" } }, { "name": "safesearch", "in": "query", "required": false, "description": "Safe-search filtering level supported by the provider.", "schema": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] } }, { "name": "timelimit", "in": "query", "required": false, "description": "Restrict results to the requested time range.", "schema": { "type": "string", "enum": [ "d", "w", "m", "y" ] } }, { "name": "backend", "in": "query", "required": false, "description": "Search backend/provider selection.", "schema": { "type": "string", "default": "api", "enum": [ "api", "html", "lite" ] } }, { "name": "max_results", "in": "query", "required": false, "description": "Maximum number of results to return.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "backend": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "timelimit": { "type": [ "string", "null" ] }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Blaze Search", "description": "Runs a DuckDuckGo search with configurable region, safe-search, time range, and backend.", "operationId": "search-query-autocomplete_post_ddgs_blaze_search", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "backend": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "timelimit": { "type": [ "string", "null" ] }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "region": { "type": "string", "default": "wt-wt" }, "safesearch": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] }, "timelimit": { "type": "string", "enum": [ "d", "w", "m", "y" ] }, "backend": { "type": "string", "default": "api", "enum": [ "api", "html", "lite" ] }, "max_results": { "type": "integer" } }, "required": [ "keywords" ], "example": { "region": "wt-wt", "backend": "api", "keywords": "open source security", "timelimit": "d", "safesearch": "moderate", "max_results": 10 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/ai": { "get": { "summary": "Ai Chat", "description": "Returns an AI-generated answer for the supplied search keywords.", "operationId": "search-query-autocomplete_get_ddgs_ai", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "model", "in": "query", "required": false, "description": "AI model identifier supported by the configured provider.", "schema": { "type": "string", "default": "gpt-3.5", "enum": [ "gpt-3.5", "claude-3-haiku", "llama-3-70b", "mixtral-8x7b" ] } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "description": "Dynamic source value; no concrete response example is published." }, "query": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "response": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Ai Chat", "description": "Returns an AI-generated answer for the supplied search keywords.", "operationId": "search-query-autocomplete_post_ddgs_ai", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "description": "Dynamic source value; no concrete response example is published." }, "query": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "response": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "model": { "type": "string", "default": "gpt-3.5", "enum": [ "gpt-3.5", "claude-3-haiku", "llama-3-70b", "mixtral-8x7b" ] } }, "required": [ "keywords" ], "example": { "model": "gpt-3.5", "keywords": "open source security" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/images": { "get": { "summary": "Image Search", "description": "Searches DuckDuckGo Images with optional region, safe-search, size, color, layout, and license filters.", "operationId": "search-query-autocomplete_get_ddgs_images", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "description": "Search region or locale code.", "schema": { "type": "string", "default": "wt-wt" } }, { "name": "safesearch", "in": "query", "required": false, "description": "Safe-search filtering level supported by the provider.", "schema": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] } }, { "name": "timelimit", "in": "query", "required": false, "description": "Restrict results to the requested time range.", "schema": { "type": "string", "enum": [ "Day", "Week", "Month", "Year" ] } }, { "name": "size", "in": "query", "required": false, "description": "Image size filter.", "schema": { "type": "string" } }, { "name": "color", "in": "query", "required": false, "description": "Image color filter.", "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "description": "Image type filter.", "schema": { "type": "string" } }, { "name": "layout", "in": "query", "required": false, "description": "Image layout filter.", "schema": { "type": "string" } }, { "name": "license", "in": "query", "required": false, "description": "Image/video license filter.", "schema": { "type": "string" } }, { "name": "max_results", "in": "query", "required": false, "description": "Maximum number of results to return.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "size": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "color": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "layout": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "license": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "timelimit": { "type": [ "string", "null" ] }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Image Search", "description": "Searches DuckDuckGo Images with optional region, safe-search, size, color, layout, and license filters.", "operationId": "search-query-autocomplete_post_ddgs_images", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "size": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "color": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "layout": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "license": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "timelimit": { "type": [ "string", "null" ] }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "region": { "type": "string", "default": "wt-wt" }, "safesearch": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] }, "timelimit": { "type": "string", "enum": [ "Day", "Week", "Month", "Year" ] }, "size": { "type": "string" }, "color": { "type": "string" }, "type": { "type": "string" }, "layout": { "type": "string" }, "license": { "type": "string" }, "max_results": { "type": "integer" } }, "required": [ "keywords" ], "example": { "size": "medium", "type": "photo", "color": "color", "layout": "wide", "region": "wt-wt", "license": "", "keywords": "open source security", "timelimit": "Day", "safesearch": "moderate", "max_results": 10 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/videos": { "get": { "summary": "Video Search", "description": "Searches DuckDuckGo Videos with optional region, safe-search, duration, resolution, and license filters.", "operationId": "search-query-autocomplete_get_ddgs_videos", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "description": "Search region or locale code.", "schema": { "type": "string", "default": "wt-wt" } }, { "name": "safesearch", "in": "query", "required": false, "description": "Safe-search filtering level supported by the provider.", "schema": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] } }, { "name": "timelimit", "in": "query", "required": false, "description": "Restrict results to the requested time range.", "schema": { "type": "string", "enum": [ "d", "w", "m" ] } }, { "name": "resolution", "in": "query", "required": false, "description": "Minimum video resolution filter.", "schema": { "type": "string" } }, { "name": "duration", "in": "query", "required": false, "description": "Video duration filter.", "schema": { "type": "string" } }, { "name": "license", "in": "query", "required": false, "description": "Image/video license filter.", "schema": { "type": "string" } }, { "name": "max_results", "in": "query", "required": false, "description": "Maximum number of results to return.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "license": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "duration": { "type": [ "string", "null" ] }, "timelimit": { "type": [ "string", "null" ] }, "resolution": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Video Search", "description": "Searches DuckDuckGo Videos with optional region, safe-search, duration, resolution, and license filters.", "operationId": "search-query-autocomplete_post_ddgs_videos", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "license": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "duration": { "type": [ "string", "null" ] }, "timelimit": { "type": [ "string", "null" ] }, "resolution": { "type": [ "string", "null" ], "description": "Dynamic source value; no concrete response example is published." }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "region": { "type": "string", "default": "wt-wt" }, "safesearch": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] }, "timelimit": { "type": "string", "enum": [ "d", "w", "m" ] }, "resolution": { "type": "string" }, "duration": { "type": "string" }, "license": { "type": "string" }, "max_results": { "type": "integer" } }, "required": [ "keywords" ], "example": { "region": "wt-wt", "license": "", "duration": "medium", "keywords": "open source security", "timelimit": "d", "resolution": "high", "safesearch": "moderate", "max_results": 10 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/news": { "get": { "summary": "News Search", "description": "Searches DuckDuckGo News with optional region, safe-search, and time-range filters.", "operationId": "search-query-autocomplete_get_ddgs_news", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "description": "Search region or locale code.", "schema": { "type": "string", "default": "wt-wt" } }, { "name": "safesearch", "in": "query", "required": false, "description": "Safe-search filtering level supported by the provider.", "schema": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] } }, { "name": "timelimit", "in": "query", "required": false, "description": "Restrict results to the requested time range.", "schema": { "type": "string", "enum": [ "d", "w", "m" ] } }, { "name": "max_results", "in": "query", "required": false, "description": "Maximum number of results to return.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "timelimit": { "type": [ "string", "null" ] }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "News Search", "description": "Searches DuckDuckGo News with optional region, safe-search, and time-range filters.", "operationId": "search-query-autocomplete_post_ddgs_news", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "params": { "type": "object", "properties": { "region": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "timelimit": { "type": [ "string", "null" ] }, "safesearch": { "type": "string", "description": "Dynamic source value; no concrete response example is published." }, "max_results": { "type": [ "integer", "null" ], "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true }, "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "region": { "type": "string", "default": "wt-wt" }, "safesearch": { "type": "string", "default": "moderate", "enum": [ "on", "moderate", "off" ] }, "timelimit": { "type": "string", "enum": [ "d", "w", "m" ] }, "max_results": { "type": "integer" } }, "required": [ "keywords" ], "example": { "region": "wt-wt", "keywords": "open source security", "timelimit": "d", "safesearch": "moderate", "max_results": 10 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/maps": { "get": { "summary": "Maps Search", "description": "Searches DuckDuckGo Maps using keywords and optional address or coordinate filters.", "operationId": "search-query-autocomplete_get_ddgs_maps", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "place", "in": "query", "required": false, "description": "Place name or point of interest.", "schema": { "type": "string" } }, { "name": "street", "in": "query", "required": false, "description": "Street name for map search.", "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "description": "City name for map search.", "schema": { "type": "string" } }, { "name": "county", "in": "query", "required": false, "description": "County or district for map search.", "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "description": "State or region for map search.", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "Country name or country code for map search.", "schema": { "type": "string" } }, { "name": "postalcode", "in": "query", "required": false, "description": "Postal or ZIP code for map search.", "schema": { "type": "string" } }, { "name": "latitude", "in": "query", "required": false, "description": "Latitude coordinate for map search.", "schema": { "type": "number" } }, { "name": "longitude", "in": "query", "required": false, "description": "Longitude coordinate for map search.", "schema": { "type": "number" } }, { "name": "radius", "in": "query", "required": false, "description": "Search radius around the supplied location.", "schema": { "type": "number" } }, { "name": "max_results", "in": "query", "required": false, "description": "Maximum number of results to return.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Maps Search", "description": "Searches DuckDuckGo Maps using keywords and optional address or coordinate filters.", "operationId": "search-query-autocomplete_post_ddgs_maps", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "results": { "type": "array", "items": {} }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "place": { "type": "string" }, "street": { "type": "string" }, "city": { "type": "string" }, "county": { "type": "string" }, "state": { "type": "string" }, "country": { "type": "string" }, "postalcode": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius": { "type": "integer", "default": 0 }, "max_results": { "type": "integer" } }, "required": [ "keywords" ], "example": { "city": "Douala", "place": "Douala", "state": "Littoral", "county": "Wouri", "radius": 0, "street": "Boulevard de la Liberte", "country": "CM", "keywords": "open source security", "latitude": 4.0511, "longitude": 9.7679, "max_results": 10 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ddgs/translate": { "get": { "summary": "Translate Search", "description": "Translates text between languages using DuckDuckGo Translate.", "operationId": "search-query-autocomplete_get_ddgs_translate", "tags": [ "DuckDuckGo search" ], "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Terms to search, map, translate, or use for the selected operation.", "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "description": "Source language code for translation.", "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "description": "Target language code for translation.", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" }, "translations": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Translate Search", "description": "Translates text between languages using DuckDuckGo Translate.", "operationId": "search-query-autocomplete_post_ddgs_translate", "tags": [ "DuckDuckGo search" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "keywords": { "description": "Dynamic source value; no concrete response example is published." }, "requestID": { "type": "string", "format": "uuid" }, "timestamp": { "type": "string", "format": "date-time" }, "translations": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string", "default": "en" } }, "required": [ "keywords" ], "example": { "to": "fr", "from": "en", "keywords": "open source security" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } }, "security": [ { "ApiKeyAuth": [] } ] }