Fetch DuckDuckGo web, news, video and image results, instant answers, suggestions and rank checks as structured JSON with one SocialCrawl API key. Reads are priced in credits.
7 active endpoints. Search, rank, news, videos, images, answers and suggestions.
Seven read endpoints for DuckDuckGo results. Search the web, check where a domain ranks, search news, videos and images, read an instant answer, and get search suggestions.
/v1/duckduckgo/searchDuckDuckGo's organic results in order. Each has its position (counted across pages), title, link, displayed address, domain, snippet and date, plus the zero-click summary box when DuckDuckGo shows one. Pass the cursor for the next page; DuckDuckGo lists about 200 results for a search at most. Standard tier (1 credit).
query, region, safe_search, time_range, limit, cursor
/v1/duckduckgo/rankWhether a domain or a URL path ranks on DuckDuckGo for a search, its best position and every matching result, scanning up to 200 positions in one call. Advanced tier (5 credits).
query, url, region, safe_search, time_range, depth, all_matches, include_subdomains
/v1/duckduckgo/newsDuckDuckGo News articles with publisher, excerpt, publication time and image. Standard tier (1 credit).
query, region, safe_search, time_range, limit
/v1/duckduckgo/videosDuckDuckGo Videos results with description, duration, publisher, uploader, publication time, view count and thumbnail. Standard tier (1 credit).
query, region, safe_search, time_range, limit
/v1/duckduckgo/imagesDuckDuckGo Images results with the image, thumbnail, size, source page and domain. Filter by size, colour, type, layout and licence. Standard tier (1 credit).
query, size, color, type, layout, license, region, safe_search, time_range, limit
/v1/duckduckgo/instant-answerDuckDuckGo's instant answer for a topic: heading, summary and its source, image, a direct answer or definition, the official website and related topics. Standard tier (1 credit).
query
/v1/duckduckgo/suggestionsThe completions DuckDuckGo suggests for a partial query. Standard tier (1 credit).
query, region
Returns DuckDuckGo's organic results in order with position, title, link, displayed address, domain, snippet, and date, plus the zero-click summary box when shown.
Use it for web results from a search engine outside Google. A search lists about 200 results at most.
1 credit
query · The search, for example best running shoes.
$ curl https://www.socialcrawl.dev/v1/duckduckgo/search?query=best+running+shoes \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseDuckDuckGo is a normal SocialCrawl data surface. You call GET /v1/duckduckgo/… with an API key, spend credits on live misses, and get a single JSON envelope back.
Send your key in the x-api-key header. No DuckDuckGo account or developer app is needed for public reads. The same key works across SocialCrawl platforms.
Every route takes a query. Filters such as region, safe_search and time_range narrow the results. A rank check also takes a url. Formats are validated before any charge.
Rank checks cost 5 credits. Every other DuckDuckGo route costs 1 credit. Cache hits cost 0.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.
Most products find an entity first, then deepen into detail and reviews only when needed.
GET /v1/duckduckgo/suggestions?query=…Completions DuckDuckGo suggests
Suggestions show how people phrase the search.
GET /v1/duckduckgo/search?query=…Organic results in order, with the zero-click box
Pass the cursor for more; a search lists about 200 results at most.
GET /v1/duckduckgo/rank?query=…&url=…Best position and every match for a domain, up to 200 deep
One call scans the whole depth.
GET /v1/duckduckgo/news?query=…News articles with publisher and publication time
Narrow with time_range to a day, week, month or year.
GET /v1/duckduckgo/search?query=best+running+shoes®ion=us-en
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/duckduckgo/rank?query=best+running+shoes&url=runnersworld.com{
"success": true,
"data": {
"items": [
{
"position": 1,
"title": "Example result",
"url": "https://www.example.com/page",
"displayed_url": "example.com",
"domain": "example.com",
"snippet": "Example snippet"
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.
items[] with position, title, url, displayed_url, domain, snippet, date
whether the domain ranks, its best position and every matching result
articles with publisher, excerpt, publication time and image
image, thumbnail, size, source page and domain
Same request lifecycle as every other /v1 platform endpoint. DuckDuckGo is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
Registry lookup finds the duckduckgo route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public page is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.
DuckDuckGo results are returned as structured search rows with stable field names, validated, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
DuckDuckGo results are public read data. We normalize them so your code does not learn a second vendor SDK.
Public web, news, video and image results, instant answers and search suggestions.
Result pages are read on request and normalized server-side. You never manage a browser or a proxy.
Structured search rows, rank checks and instant answers.
No signed-in or personalized results, and no ad data.
The jobs this API is most often used for.
SEO rank tracking and independent search research
Callers search a keyword first, then check ranks for their own and competing domains over time. A rank check that scans up to 200 positions in one call for 5 credits, next to web, news, video and image search under the same key.
Live misses read the result page on request. Repeat calls hit cache and cost 0 credits.
Common ways teams put this data to work, and the stack each one tends to run.
rank to track where a domain sits for a keyword set.
search and news with time_range to see how a topic is covered.
suggestions and instant-answer to power search boxes and fact lookups.
Search is 1 credit. A rank check is 5. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/duckduckgo/search?query=best+running+shoes®ion=us-en" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/duckduckgo/rank?query=best+running+shoes&url=runnersworld.com" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl