100 free credits. No credit card required.Start building
Logo
Baidu logoBaidu API

Get Baidu results with one API

Search the web with Baidu and get each result's position, title, link, domain and snippet as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Baidu logo
/v1/baidu

1 active endpoint. Web search.

  • GET /v1/baidu/search

What Baidu endpoints does SocialCrawl ship?

One read endpoint for Baidu's organic results, 10, 20 or 50 a page, as deep as Baidu's 750th result.

Web search

1 credit
/v1/baidu/search

Baidu's organic results for a query, 10, 20 or 50 a page, as deep as Baidu's 750th result, each with its position, title, link, the source and date Baidu shows and domain. Choose 10, 20 or 50 results a page; each result names its source, and Baidu's own count and related searches come with the page. Standard tier (1 credit).

query, limit, page

Baidu API1 endpoint supported
View docs
Search

Returns Baidu's organic results for a query, 10, 20 or 50 a page, each with its title, link, source, snippet and date, plus related searches.

Use it to see what Chinese searchers find for a query or to track a site's rank on Baidu.

1 credit

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"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Baidu API works

Baidu is a normal SocialCrawl data surface. You call GET /v1/baidu/search with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Baidu account is needed. The same key works across SocialCrawl platforms.

GET with query params

Search takes query, limit, page. Formats are validated before any charge.

Pay in credits, not seats

Every Baidu search page costs 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Search pages carry a next_cursor while there is more.

The usual integration chain

Most products search once for the terms they track, then page through as deep as they need.

01Search
GET /v1/baidu/search?query=…

the first results page with positions and links

See what ranks for the query, and where a site sits.

02Page through the results
GET /v1/baidu/search?query=…&cursor=…

the next page from next_cursor

Reach deeper positions for the same query.

request
GET /v1/baidu/search?query=%E7%83%AD%E6%B3%B5
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
response envelope
{
  "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
}

What lands in data

The rows match GET /v1/bing/search and /v1/duckduckgo/search, so one parser reads every engine.

SearchResultsearch

items[] with position, title, url, displayed_url, domain, site_name, snippet, date; next_cursor, total_results, related_searches

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Baidu is not a sidecar.

  1. 01

    Edge receives the call

    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).

  2. 02

    Validate, then debit

    Registry lookup finds the baidu 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.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public results page is read live, with a retry when a read hangs and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    The results are mapped to the shared web search rows, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search: 1 credit a page
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • 10, 20 or 50 a page, to result 750
  • Organic results only
  • landings.platformBrief.platforms.baidu.api.billingRules.7
  • landings.platformBrief.platforms.baidu.api.billingRules.8

How SocialCrawl gets Baidu data

Baidu results pages are public. We normalize them into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Baidu is for this API

Baidu web results, the leading search engine in mainland China.

How SocialCrawl reaches it

Public data is read on request and normalized server-side, within each source's published usage rules.

What leaves our edge

The shared web search rows: position, title, link, address, domain, snippet and date, the same as Bing and DuckDuckGo.

What we do not ship live

No ads, no account data and no search history.

field map sketch
position, title, link→ items[].position, title, urlposition, title, link
address shown, domain→ items[].displayed_url, domainaddress shown, domain
snippet, date shown→ items[].snippet, datesnippet, date shown

What this API is used for

The jobs this API is most often used for.

1active Baidu endpoints in the registry
1credit per Baidu search page

Rank tracking and market research in China

Callers search the terms they track on a schedule and record where each site sits. Baidu results in the same rows as Bing and DuckDuckGo, from the same key as the rest of the catalog.

Live misses read the public results page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Rank tracking

Python, scheduled jobs

search the tracked terms each day and record a site's position on Baidu.

Engine comparison

Node, dashboards

run the same query on Baidu, Bing and DuckDuckGo and compare who ranks where.

AI agents

TypeScript, tool calls

give an agent Baidu results as a search tool, with links it can read next.

How to call the Baidu API

Every Baidu search page is 1 credit. Cache hits are free.

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 logoBaidu on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Baidu API return?

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.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Baidu API cover?
It covers 1 endpoint: Search. It returns Baidu's organic web results in the same unified JSON as the other 94 platforms.
What does each result include?
Its position, title, link, the address as Baidu shows it, the domain, the snippet and the date when Baidu prints one. The rows match the Bing and DuckDuckGo search endpoints.
How many results come back per call?
10, 20 or 50 a page, as deep as Baidu's 750th result. Pass the returned cursor for the next page.
Does it include ads?
No. Only the organic results are returned.
How much does it cost?
Each results page costs 1 credit, cache hits are free, and bad parameters return 400 without a charge. You start with 100 free credits.
Is scraping Baidu data legal?
SocialCrawl returns publicly available Baidu data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Baidu's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Baidu scraping API vs the official Baidu API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Baidu endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Baidu API reference in the docs

🤖 AI agent or LLM? Read this page as markdown