Meituan & Dianping Scraper — China Cities, Districts, Business Areas & Shops

Build a China location dataset without a browser cookie. Export city IDs, pinyin, province names, coordinates, districts and business areas (商圈) as JSON, CSV or Excel. Filter by province, city or district and choose exactly the record type you need.

Start with geography. The separate Dianping shops mode needs your own valid session cookie and remains best effort. It is not a cookie-free leads database. Review text is not implemented; a shop's review count is a different field.

Run the Actor · Current prices · Get help

Choose your first export

Your task	Setting	What you get
Join a China dataset to city identifiers	geoOutput: "cities"	One row per city, with name, pinyin, province and coordinates
Prepare a district coverage worksheet	geoOutput: "districts"	One row per district in your selected cities
Research business-area coverage	geoOutput: "areas"	One row per business area, linked to its city and district
Export both cities and their areas	geoOutput: "mixed"	City and area rows; includeAreas: false skips areas
Explore Dianping shop profiles or deals	mode: "shops"	Best-effort authenticated shop data; first test with a small cap

Geography has no per-record charge, but the configured Actor start fee still applies. See Pricing before running; any platform/proxy charges shown there also apply. No cookie, proxy or browser is used by geography mode.

1. Two-city catalog — smallest first run

{
  "mode": "geo",
  "geoCities": ["北京", "上海"],
  "geoOutput": "cities",
  "maxItems": 10
}

After the run, open Dataset, CSV export, or JSON export. Read Export summary (SUMMARY in the default key-value store) for the number of records and whether the cap was reached. CSV opens in Excel; Apify's dataset export menu also offers Excel format.

Example city row (schema illustration; coordinates and source coverage can change):

{"source":"city","cityId":1,"cityName":"北京","pinyin":"beijing","province":"北京","latitude":39.9049873,"longitude":116.4052887,"isOpen":true}

2. Beijing districts — a clean coverage worksheet

{
  "mode": "geo",
  "geoCities": ["beijing"],
  "geoOutput": "districts",
  "maxItems": 100
}

Output fields: source, cityId, cityName, districtId, districtName, areaId, areaName. District rows have source: "district", areaId: 0 and an empty areaName. These are Meituan's location groupings, not an official administrative boundary dataset.

3. Business areas in one district

{
  "mode": "geo",
  "geoCities": ["北京"],
  "geoOutput": "areas",
  "districtNames": ["朝阳区"],
  "maxItems": 1000
}

Each row contains the city, district and business-area identifiers and names. Business areas do not include polygons, shop counts or competitor-density estimates.

4. Province or nationwide city catalog

{
  "mode": "geo",
  "geoCities": [],
  "provinceNames": ["广东"],
  "geoOutput": "cities",
  "maxItems": 5000
}

Remove provinceNames to request the full live city catalog. An explicit empty geoCities: [] means all cities. If you omit both geoCities and provinceNames, city defaults to Beijing. The source's coverage changes; no fixed city count is guaranteed.

Export completeness and validation

• Unknown city or province names fail explicitly, before geography rows are written.
• Cities accept Chinese names, pinyin or Meituan ID strings. Province/district names use exact Chinese spelling from the source.
• City and province filters are combined as an intersection.
• An unknown district is reported as an error. If other districts already yielded data, the dataset is partial and SUMMARY.status says partial.
• maxItems limits all output rows. limitReached: true means completeness has not been established: increase the cap or split your export. It does not mean more data necessarily exists.
• Identical records are emitted once per run. A source outage triggers bounded retries, then an explicit failure rather than a successful empty fallback.

Dianping shops — cookie required, best effort

{
  "mode": "shops",
  "city": "北京",
  "searchKeywords": ["咖啡"],
  "cookie": "REPLACE_WITH_YOUR_OWN_DIANPING_COOKIE",
  "maxItems": 10,
  "fetchShopDetails": false,
  "maxDealsPerShop": 0
}

Replace the placeholder with your own valid Dianping browser cookie. Open dianping.com, complete any verification yourself, then copy your session's cookie from browser developer tools into the secret cookie input. Never post cookies in issues, reviews or screenshots. A cookie does not guarantee access: sessions can expire and the source may still request verification or block a proxy. Use only data you are authorized to access.

Search supports Chinese keywords, category and sorting. Direct shopUrls must be Dianping shop links. Set fetchShopDetails to enrich search rows or maxDealsPerShop to request available group-buy deals. Fields may be absent when the source does not provide them. A shop's allCommentNum is a count, not review text.

Verification scope: geography is the recommended first-run path. Changes to cookie handling and search batching are covered by regression tests; authenticated shops/deals have not yet completed end-to-end verification for this release. Test access before planning a production workflow around them.

Input reference

Input	Default	Purpose
mode	auto	auto, geo or shops; auto uses shops only when both cookie and shop queries exist
geoCities	omitted	Geography selection; omitted uses city, explicit [] means all
geoOutput	mixed	cities, districts, areas or mixed
provinceNames	[]	Exact Chinese province filter
districtNames	[]	Exact district filter for area/district rows
includeAreas	true	Only affects mixed output
maxItems	100	Total output cap; raise for a full export
city	北京	Shops city, or default geography city
searchKeywords	[]	Dianping search terms; Chinese terms recommended
shopUrls	[]	Direct Dianping shop pages
cookie	empty	Your own valid session; required for shops
category / sort	all / default	Dianping search filters
fetchShopDetails	false	Enrich search rows where possible
maxDealsPerShop	0	Maximum deals requested per shop
proxyConfiguration	residential configuration	Only used in shops; proxy access and cost depend on your account

Pricing: check the live tab before running

As checked on 28 October 2026, the configured events are:

Event	USD	Trigger
Actor start	0.005	Per GB of allocated RAM, minimum one event; applies to geography too
poi-scraped	0.0015	Delivered search shop row, including optional enrichment
shop-detail-scraped	0.004	Delivered direct shop-detail row
deal-scraped	0.0004	Delivered deal

No price change is introduced by this release. Future prices shown in the live Pricing tab take precedence. A start fee may apply even if a run yields no records. Geography sends no custom per-record charge events. These event prices are not a promise about total platform or proxy costs.

Automate exports

Save a working input as an Apify Task, then schedule it in Apify Console. Use the Actor's API tab for authenticated API examples or the Apify MCP server for an AI workflow. Always inspect SUMMARY before treating an export as complete; retain the run date alongside CSV snapshots when comparing coverage over time. The Actor does not infer historical changes.

Help and troubleshooting

Symptom	What to do
Wrong/unknown city	Use an exact Chinese name, pinyin or city ID; no silent nationwide fallback
Only 100 rows	Raise maxItems; check SUMMARY.limitReached
No area rows	Choose areas or enable includeAreas for mixed output; some districts may have none
Geography source unavailable	Retry later; previously exported rows may be partial
No shop data	Check your own cookie and source access; a successful process is not proof of captured shops
Cookie required	Use geography, or provide a session for shops; no substitute shop records are fabricated

For support, open an issue with the non-secret input fields, run ID, expected record type and relevant error. Remove cookies, proxy passwords and API tokens. Useful feedback is a reproducible failing case, not a rating request.

中文说明

优先体验免 Cookie 的中国城市、行政区和商圈数据导出，适合选址准备、地域分组和数据关联。 可按省、市、区筛选，输出 CSV / JSON / Excel。地理模式不按条收费，但启动费仍可能产生。 全国城市表需明确设置 geoCities: []、geoOutput: "cities"，并提高 maxItems。 点评店铺模式需要本人有效 Cookie，目前仍属尽力抓取；不承诺绕过验证，不提供评论正文。

Changelog

• 0.3 — Focused city/district/business-area exports; province/district filters; explicit all-city selection; duplicate suppression; completeness summary and export links. Fix Dianping cookie domain, credentialed proxy handling and early search-batch truncation.
• 0.2 — Geography mode and Dianping-backed shop routes.