100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Baidu logoBaidu API

Baidu 결과 데이터 API

SocialCrawl API 키로 Baidu에서 웹을 검색하고 결과마다 순위, 제목, 링크, 도메인, 스니펫을 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.

Baidu logo
/v1/baidu

활성 엔드포인트는 1개입니다. 웹 검색을 지원합니다.

  • GET /v1/baidu/search

Baidu 엔드포인트

Baidu의 자연 검색 결과를 페이지당 10, 20, 50개씩 Baidu의 750번째 결과까지 읽는 엔드포인트 1개입니다.

웹 검색

1 크레딧
/v1/baidu/search

검색어에 대한 Baidu의 자연 검색 결과를 페이지당 10, 20, 50개씩 Baidu의 750번째 결과까지 반환하며, 결과마다 순위, 제목, 링크, Baidu가 표시한 출처와 날짜, 도메인이 담깁니다. 페이지당 10, 20, 50개를 고르며, 결과마다 출처가 담기고 Baidu의 전체 결과 수와 관련 검색어가 함께 옵니다. 표준 티어(1 크레딧)입니다.

query, limit, page

Baidu API1개 엔드포인트 지원
문서 보기
Search

검색어에 대한 Baidu의 자연 검색 결과를 페이지당 10, 20, 50개씩 제목, 링크, 출처, 스니펫, 날짜와 관련 검색어와 함께 반환합니다.

중국 사용자가 검색어로 무엇을 찾는지 보거나 Baidu에서 사이트 순위를 추적할 때 사용하세요.

1크레딧

GET/v1/baidu/search?query=%E7%83%AD%E6%B3%B5

query · The search, up to 500 characters, for example heat pump efficiency.

$ curl https://www.socialcrawl.dev/v1/baidu/search?query=%E7%83%AD%E6%B3%B5 \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Baidu API 동작

Baidu도 SocialCrawl의 일반 데이터 표면입니다. API 키로 GET /v1/baidu/search를 호출하고, 실시간 조회에만 크레딧을 쓰며, 하나의 JSON 응답 형식을 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. Baidu 계정은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

쿼리 파라미터로 GET 호출

검색은 query, limit, page를 받습니다. 과금 전에 형식을 검증합니다.

좌석이 아닌 크레딧 과금

Baidu 검색 페이지마다 1 크레딧입니다. 캐시 적중은 0 크레딧입니다.

하나의 JSON 응답 형식

모든 응답은 success, data, credits_used, credits_remaining, request_id, cached로 같은 형태입니다. 다음 결과가 있으면 검색 페이지에 next_cursor가 담깁니다.

일반적인 연동 흐름

대부분 제품은 추적하는 검색어를 한 번 검색한 뒤 필요한 깊이까지 페이지를 넘깁니다.

01검색
GET /v1/baidu/search?query=…

순위와 링크가 담긴 첫 결과 페이지

검색어에 무엇이 오르는지와 사이트 위치를 확인합니다.

02다음 페이지 읽기
GET /v1/baidu/search?query=…&cursor=…

next_cursor로 받는 다음 페이지

같은 검색어의 더 깊은 순위까지 확인합니다.

요청
GET /v1/baidu/search?query=%E7%83%AD%E6%B3%B5
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
응답 봉투
{
  "success": true,
  "data": {
    "items": [
      {
        "position": 1,
        "title": "…",
        "url": "https://…",
        "domain": "…",
        "snippet": "…"
      }
    ],
    "next_cursor": "2"
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data에 담기는 내용

결과 행은 GET /v1/bing/search, /v1/duckduckgo/search와 같아 파서 하나로 모든 검색엔진을 읽습니다.

SearchResultsearch

items[]에 position, title, url, displayed_url, domain, site_name, snippet, date와 next_cursor, total_results, related_searches

게이트웨이 내부 처리

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기를 따릅니다. Baidu는 별도 부가 기능이 아닙니다.

  1. 01

    엣지에서 호출 수신

    Next.js catch-all 경로가 Hono social API로 전달합니다. request_id를 발급하고 키를 인증한 뒤 속도 제한(분당 600회)과 동시성(키당 50건)을 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 baidu 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 실행합니다. 잘못된 입력은 과금 없이 400을 반환합니다. 유효한 호출은 조회 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 조회

    platform, resource, params로 결정적 캐시 키를 만듭니다. 적중하면 즉시 반환하고 credits_used는 0입니다. 미스이면 공개 결과 페이지를 실시간으로 읽으며, 응답이 멈춘 조회는 다시 시도하고 소스가 불안정하면 서킷 브레이커가 작동합니다.

  4. 04

    정규화 후 반환

    결과를 공통 웹 검색 행으로 매핑하고 검증한 뒤, 성공 응답으로 감싸 과금 감사용으로 기록합니다.

운영에서 중요한 과금 규칙

  • search: 페이지당 1 크레딧
  • 캐시 적중: 0 크레딧
  • 빈 결과나 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • 페이지당 10, 20, 50개, 750번째 결과까지
  • 자연 검색 결과만 제공
  • landings.platformBrief.platforms.baidu.api.billingRules.7
  • landings.platformBrief.platforms.baidu.api.billingRules.8

Baidu 데이터 수집 방식

Baidu 결과 페이지는 공개 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 공급사 SDK를 익힐 필요가 없습니다.

이 API에서 Baidu의 의미

중국 본토의 대표 검색엔진인 Baidu의 웹 검색 결과입니다.

SocialCrawl의 수집 방식

공개 데이터를 요청 시 각 소스의 공개 이용 규칙 안에서 읽어 서버에서 정규화합니다.

엣지에서 나가는 데이터

순위, 제목, 링크, 주소, 도메인, 스니펫, 날짜를 담은 공통 웹 검색 행으로, Bing, DuckDuckGo와 같습니다.

실시간으로 제공하지 않는 데이터

광고, 계정 데이터, 검색 기록은 제공하지 않습니다.

필드 매핑
position, title, link→ items[].position, title, url순위, 제목, 링크
address shown, domain→ items[].displayed_url, domain표시 주소, 도메인
snippet, date shown→ items[].snippet, date스니펫, 표시 날짜

이 API의 활용 분야

이 API가 가장 많이 쓰이는 작업입니다.

1active Baidu endpoints in the registry
1Baidu 검색 페이지당 크레딧

중국 시장의 순위 추적과 시장 조사

호출하는 쪽은 추적하는 검색어를 주기적으로 검색하고 사이트마다 순위를 기록합니다. Baidu 결과를 Bing, DuckDuckGo와 같은 행으로 카탈로그 전체와 같은 키로 제공합니다.

캐시 미스는 공개 결과 페이지를 요청 시 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 처리됩니다.

활용 사례

팀이 이 데이터를 활용하는 대표적인 방식과 주로 쓰는 기술 스택입니다.

순위 추적

Python, 예약 작업

추적하는 검색어를 매일 search로 호출해 Baidu의 사이트 순위를 기록합니다.

검색엔진 비교

Node, 대시보드

같은 검색어를 Baidu, Bing, DuckDuckGo에서 호출해 순위를 비교합니다.

AI 에이전트

TypeScript, 도구 호출

Baidu 결과를 에이전트의 검색 도구로 제공해 이어서 읽을 링크를 줍니다.

Baidu API 호출 방법

Baidu 검색 페이지마다 1 크레딧입니다. 캐시 적중은 무료입니다.

curl "https://www.socialcrawl.dev/v1/baidu/search?query=%E7%83%AD%E6%B3%B5" \
  -H "x-api-key: sc_your_api_key_here"
Baidu logoSocialCrawl의 Baidu

카탈로그 전체와 같은 키

엔드포인트

Baidu API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
SocialCrawl 바이두 API는 무엇을 제공하나요?
1개 엔드포인트, Search를 제공해요. Baidu의 자연 검색 결과를 다른 94개 플랫폼과 같은 통합 JSON으로 받아요.
결과마다 무엇이 담기나요?
순위, 제목, 링크, Baidu가 표시한 주소, 도메인, 스니펫, 표시된 날짜가 담겨요. Bing, DuckDuckGo 검색 엔드포인트와 같은 형태예요.
호출 한 번에 몇 개가 오나요?
페이지당 10, 20, 50개씩 Baidu의 750번째 결과까지 받아요. 다음 페이지는 받은 cursor를 넣으면 돼요.
광고도 포함되나요?
아니요. 광고 없이 자연 검색 결과만 순서대로 와요.
비용은 얼마인가요?
결과 페이지마다 1 크레딧이고 캐시 적중은 무료예요. 잘못된 파라미터는 과금 없이 400으로 응답해요. 무료 100 크레딧으로 시작해요.
Baidu 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Baidu 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Baidu 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Baidu 스크래핑 API와 공식 Baidu API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Baidu 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

Baidu API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요