DuckDuckGo API. Search results and answers as JSON.
Web, news, video and image results, where a site ranks, instant answers and suggestions, in any DuckDuckGo region. One consistent shape and one credit per request.
- 7 endpoints
- 63 regions
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
DuckDuckGo data as JSON. You build the product.
Live DuckDuckGo data in one response shape, with platform changes handled for you.
DuckDuckGo, plus every other platform
One key and one response envelope for DuckDuckGo and 86 more platforms.
API key
sk_live_••••••••
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
- Requests
- 480
- Credits
- 480
Balance
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
lookupStatus: found
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What DuckDuckGo data can you get?
7 endpoints, one API key. Every response comes back as live JSON in the same envelope.
- +1 more search endpoints
Search
Answers
Browse all 7 DuckDuckGo endpoints
Example request
GET /v1/duckduckgo/search. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with DuckDuckGo data
Monitoring, enrichment, research and content workflows on DuckDuckGo data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
200 OK1.82s
{
"handle": "charlidamelio",
"displayName": "Charli D'Amelio",
"followers": 48300000,
"following": 1284
}
Step 3: Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”
Jade P. · Founder, inko “Live profile data on every request. We never flag accounts from a stale cache.”
Hannah Webb · Founder, Scam Finder “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Owen Pritchard · Founder, IP Flare
DuckDuckGo API: common questions
Is there a DuckDuckGo search API?
Yes. GET /v1/duckduckgo/search returns DuckDuckGo's web results for a query as JSON: position, title, URL, shown address and snippet for each result, sponsored results apart, and a cursor for the next page. Authenticate with your Social Fetch API key in x-api-key.
How does the rank check work?
GET /v1/duckduckgo/rank reads DuckDuckGo's results for the query page by page until the site appears, the depth is reached (up to 200 results) or the results end. It returns the site's best position and result, and lookupStatus not_found with checkedResults when the site is not there. It costs one credit however many pages it reads.
Which regions can I search?
Any of DuckDuckGo's 63 regions, picked with country and, where a country has several, language: country=GB is the UK, country=CH&language=fr is Switzerland in French. A country DuckDuckGo has no region for answers 400 and is not charged.
Are ads mixed into the results?
No. Sponsored results are returned in ads with their title, the advertiser's domain, the address shown and the ad text. results holds only the organic results, and positions count only those.
Can I page through news, videos and images?
Yes. Each page holds about 30 articles, 60 videos or 100 images; pass page.nextCursor as cursor for the next one. Use time to narrow news to the past day, week, month or year, and videos to the past day, week or month.
What does an instant answer include?
For a topic DuckDuckGo knows: its heading, a summary with its source and URL, facts such as dates and places, the official website, a direct answer for questions like 2+2, a definition for words, and related topics. A topic with nothing answers lookupStatus not_found.
How much does the DuckDuckGo API cost?
Every DuckDuckGo route charges one credit per completed request, and each page of web results is billed separately. Read meta.creditsCharged on every response. New accounts start with 100 free credits.
Can I use the DuckDuckGo routes from agents or MCP?
Yes. Every DuckDuckGo route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs.
The DuckDuckGo API in detailHow the DuckDuckGo routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for DuckDuckGo
Social Fetch exposes 7 routes under /v1/duckduckgo. GET /v1/duckduckgo/search returns a page of web results with titles, links, shown addresses and snippets, with sponsored results kept apart in ads, and pages with a cursor. GET /v1/duckduckgo/rank checks where a site ranks for a query, reading up to 200 results deep and stopping at the first match. GET /v1/duckduckgo/news, GET /v1/duckduckgo/videos and GET /v1/duckduckgo/images search DuckDuckGo News, Videos and Images, with image filters for size, colour, type, layout, licence and date. GET /v1/duckduckgo/instant-answer returns DuckDuckGo's summary, facts and direct answer for a topic, and GET /v1/duckduckgo/search/suggest completes a partial query.
A region is a country plus a language: country=GB, or country=CH&language=fr. Without a country the results are DuckDuckGo's US English region. time limits web, news and image results to the past day, week, month or year.
Every response uses the { data, meta } envelope. Web, news, video and image search page with cursor: pass page.nextCursor to get the next page. A rank check that does not find the site answers lookupStatus: not_found, with how many results it checked.
How to call the DuckDuckGo API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_...). New accounts get 100 free credits, enough to try every DuckDuckGo route.2. Pick the route and the region
Use
GET /v1/duckduckgo/search?query=marathon%20training%20plan&country=GBfor web results, orGET /v1/duckduckgo/rank?query=marathon%20training%20plan&domain=halhigdon.comfor a rank check. Sendx-api-keyon every request.3. Page and bill
Follow
page.nextCursorwhilepage.hasMoreis true, and readmeta.creditsChargedfor the charge.
What each DuckDuckGo route returns
- Web results with
position,title,url,displayUrlandsnippet, positions counting across pages, repeats dropped. - Sponsored results apart in
ads, with the advertiser's domain. - Rank checks up to 200 results deep: the site's best
position, the matching result and every position on the page it was found. - News with source, publication time and image; videos with duration, publisher, uploader, views and thumbnail.
- Images with size, format, thumbnail and source page, filtered by size, colour, type, layout, licence and date.
- Instant answers with summary, source, facts, direct answers, definitions and related topics.
- Search suggestions for the start of a query, in any of 63 regions.
How much does the DuckDuckGo API cost?
Every DuckDuckGo route charges one credit per completed request, shown on each endpoint page. A rank check is one request however deep it reads. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official DuckDuckGo API
DuckDuckGo offers no API for its web, news, video or image results. Social Fetch reads what DuckDuckGo shows every visitor and returns it as one JSON shape, with regions, time windows and paging handled the same way on every route.
Pull your first DuckDuckGo data.
Run a live DuckDuckGo request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub
