Baidu Maps Scraper

Search Baidu Maps by POI keyword and city/region and export normalized place records. The Actor uses Baidu's structured search response when it is available and falls back to the rendered result cards when the response shape changes.

Input

Field	Required	Default	Description
query	yes	餐厅	Primary POI search term. Chinese keywords usually return the best coverage.
queries	no	[]	Up to 19 additional search terms processed in the same run.
region	yes	北京	City or region appended through the Baidu Maps search interface.
maxItems	no	100	Maximum records across all queries.
maxPages	no	10	Maximum pages processed for each query.
maxConcurrency	no	3	Concurrent independent query searches, from 1 to 5.
market	no	zh-CN	Locale used in normalized search context fields.
maxRequestRetries	no	3	Bounded retries for temporary browser, network, and proxy failures.
navigationTimeoutSecs	no	60	Per-navigation timeout.
requestHandlerTimeoutSecs	no	120	Per-query handler timeout.
proxyConfiguration	no	no proxy	Standard Apify or custom proxy configuration.
debug	no	false	Logs sanitized endpoint and payload shapes; never response bodies or credentials.

Output

The dataset schema documents 79 typed fields. Every record includes the stable common contract: id, type, resultType, position, page, name, nameLocal, region, country, source, engineId, searchQuery, query, searchUrl, market, language, scrapedAt, and searchMetadata.

Depending on what Baidu exposes for an individual POI, records can also include:

• Baidu identity: uid, poiId, category, categoryCode, categories, and tags.
• Location: address components, numeric latitude/longitude, and coord. Projected map coordinates are never mislabeled as geographic degrees.
• Contact: phone, website, and email.
• Reputation and pricing: rating, review counts, price, numeric price, price level, and currency.
• Operations: opening hours, open status, business status, verification/claim status, and chain information.
• Media and features: description, thumbnail, images/photos, facilities, and payment options.
• Navigation and provenance: POI URLs, canonical URL, domain, source, extraction mode, and normalized search context.

Unavailable optional fields are omitted rather than emitted as null, empty strings, empty arrays, or empty objects.

Pagination, limits, and deduplication

Pagination is performed inside the same live Baidu Maps SPA page so search and session state are preserved. Records are deduplicated by Baidu UID when available, otherwise by a stable SHA-256 key derived from name, address, query, and region. maxItems is enforced across all queries.

An explicit no-results response completes successfully with an empty dataset. Selector/API drift raises an error instead of silently reporting success. Verification and CAPTCHA responses fail closed and are never stored.

Proxy and access boundaries

Residential proxy configuration can improve ordinary geographic availability and rate-limit resilience. The Actor does not solve or bypass interactive verification, authentication, account restrictions, or other access controls. If Baidu presents an explicit challenge, the run stops with an empty dataset.

Example

{
  "query": "咖啡厅",
  "queries": ["酒店", "公园"],
  "region": "北京",
  "maxItems": 50,
  "maxPages": 3,
  "maxConcurrency": 3,
  "market": "zh-CN",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "countryCode": "CN"
  }
}