SocialCrawl API 키 하나로 DuckDuckGo의 웹, 뉴스, 동영상, 이미지 결과와 즉답, 자동완성, 순위 확인을 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.
활성 엔드포인트는 7개입니다. 검색, 순위, 뉴스, 동영상, 이미지, 즉답, 자동완성을 지원합니다.
DuckDuckGo 결과를 읽는 엔드포인트는 7개입니다. 웹 검색, 도메인 순위 확인, 뉴스와 동영상과 이미지 검색, 즉답, 검색어 자동완성을 지원합니다.
/v1/duckduckgo/searchDuckDuckGo의 자연 검색 결과를 순서대로 반환합니다. 결과마다 순위(페이지를 넘겨도 이어서 계산), 제목, 링크, 표시 주소, 도메인, 스니펫, 날짜가 있으며 DuckDuckGo가 제로클릭 요약 상자를 보여 주면 함께 반환합니다. 커서로 다음 페이지를 읽으며 한 검색에서 DuckDuckGo가 보여 주는 결과는 최대 약 200개입니다. 표준 티어(1 크레딧)입니다.
query, region, safe_search, time_range, limit, cursor
/v1/duckduckgo/rank도메인 또는 URL 경로가 특정 검색어에서 DuckDuckGo에 노출되는지, 최고 순위와 일치하는 모든 결과를 호출 한 번으로 최대 200위까지 확인합니다. 고급 티어(5 크레딧)입니다.
query, url, region, safe_search, time_range, depth, all_matches, include_subdomains
/v1/duckduckgo/newsDuckDuckGo 뉴스 기사를 매체, 발췌문, 게재 시간, 이미지와 함께 반환합니다. 표준 티어(1 크레딧)입니다.
query, region, safe_search, time_range, limit
/v1/duckduckgo/videosDuckDuckGo 동영상 결과를 설명, 길이, 매체, 업로더, 게재 시간, 조회 수, 썸네일과 함께 반환합니다. 표준 티어(1 크레딧)입니다.
query, region, safe_search, time_range, limit
/v1/duckduckgo/imagesDuckDuckGo 이미지 결과를 이미지, 썸네일, 크기, 출처 페이지, 도메인과 함께 반환합니다. 크기, 색상, 유형, 레이아웃, 라이선스로 거를 수 있습니다. 표준 티어(1 크레딧)입니다.
query, size, color, type, layout, license, region, safe_search, time_range, limit
/v1/duckduckgo/instant-answer주제에 대한 DuckDuckGo 즉답을 반환합니다. 제목, 요약과 출처, 이미지, 직접 답변이나 정의, 공식 웹사이트, 관련 주제가 포함됩니다. 표준 티어(1 크레딧)입니다.
query
/v1/duckduckgo/suggestions입력 중인 검색어에 대해 DuckDuckGo가 제안하는 자동완성 문구를 반환합니다. 표준 티어(1 크레딧)입니다.
query, region
DuckDuckGo 검색 결과를 순서대로 순위, 제목, 링크, 표시 주소, 도메인, 요약문, 날짜와 함께 반환하고 표시되는 경우 즉답 상자도 담습니다.
Google 밖의 검색 엔진 결과가 필요할 때 사용하세요. 한 검색당 최대 200개 정도까지 나옵니다.
1크레딧
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"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다DuckDuckGo도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/duckduckgo/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 DuckDuckGo 계정이나 개발자 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
모든 경로가 query를 받습니다. region, safe_search, time_range 같은 필터로 결과를 좁힙니다. 순위 확인은 url도 받습니다. 과금 전에 형식을 검증합니다.
순위 확인은 5 크레딧입니다. 나머지 DuckDuckGo 경로는 1 크레딧입니다. 캐시 히트는 0입니다.
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
대부분 제품은 대상을 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
GET /v1/duckduckgo/suggestions?query=…DuckDuckGo가 제안하는 자동완성
자동완성으로 사람들이 검색어를 어떻게 입력하는지 확인합니다.
GET /v1/duckduckgo/search?query=…제로클릭 상자가 있는 순서대로의 자연 검색 결과
커서로 더 읽을 수 있으며 한 검색은 최대 약 200개 결과를 보여 줍니다.
GET /v1/duckduckgo/rank?query=…&url=…도메인의 최고 순위와 일치하는 모든 결과, 최대 200위까지
호출 한 번으로 전체 깊이를 스캔합니다.
GET /v1/duckduckgo/news?query=…매체와 게재 시간이 있는 뉴스 기사
time_range로 하루, 한 주, 한 달, 한 해로 좁힙니다.
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
}아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.
items[]에 position, title, url, displayed_url, domain, snippet, date
도메인 노출 여부, 최고 순위, 일치하는 모든 결과
매체, 발췌문, 게재 시간, 이미지가 있는 기사
이미지, 썸네일, 크기, 출처 페이지, 도메인
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. DuckDuckGo은 사이드카가 아닙니다.
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
레지스트리에서 duckduckgo 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 페이지를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.
DuckDuckGo 결과를 안정적인 필드 이름의 구조화된 검색 행으로 반환하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
DuckDuckGo 결과는 공개 읽기 데이터입니다. SocialCrawl이 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
공개 웹, 뉴스, 동영상, 이미지 결과와 즉답, 검색어 자동완성입니다.
결과 페이지를 요청 시점에 읽어 서버에서 정규화합니다. 브라우저나 프록시를 직접 관리할 필요가 없습니다.
구조화된 검색 행, 순위 확인, 즉답입니다.
로그인 또는 개인화된 결과와 광고 데이터는 제공하지 않습니다.
이 API가 가장 많이 사용되는 작업입니다.
SEO 순위 추적과 독립 검색 리서치
호출은 키워드 검색에서 시작해 자사와 경쟁 도메인의 순위를 시간에 따라 확인하는 방향으로 이어집니다. 최대 200위까지 호출 한 번으로 스캔하는 순위 확인을 5 크레딧에 제공하며 웹, 뉴스, 동영상, 이미지 검색을 같은 키로 호출합니다.
라이브 미스는 요청 시점에 결과 페이지를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
rank로 키워드 묶음에서 도메인의 위치를 추적합니다.
time_range를 지정한 search와 news로 주제가 어떻게 다뤄지는지 확인합니다.
suggestions와 instant-answer로 검색창과 사실 조회 기능을 만듭니다.
검색은 1 크레딧입니다. 순위 확인은 5 크레딧입니다. 캐시 히트는 무료입니다.
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"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요