Yes. The Free tier on Parse includes 100 API calls per month at no cost with a 5 request-per-minute rate limit. Paid tiers add more credits and higher rate limits: Hobby ($30/month, 1,000 credits, 20 req/min) and Developer ($100/month, 5,000 credits, 250 req/min).

What are the rate limits?

Rate limits are per Parse account, not per API: 5 requests/minute on Free, 20 on Hobby, and 250 on Developer. Exceeding the limit returns a 429 status code. The same limit applies regardless of which marketplace API you call.

How do I authenticate?

Send your Parse API key in the X-API-Key header on every request. Get a key by signing up at parse.bot — no credit card required for the free tier.

Discover/m.ceair.com API

live

m.ceair.com APIm.ceair.com ↗

Search China Eastern flights, check real-time flight status, and retrieve city/airport codes via the m.ceair.com API. 3 endpoints, structured JSON responses.

Travel maps geo weather

Endpoints

Updated

3mo ago

Try it

arr_city*

Arrival city code (e.g., BJS for Beijing, HGH for Hangzhou). Use get_cities to find valid …

dep_city*

Departure city code (e.g., SHA for Shanghai, CKG for Chongqing). Use get_cities to find va…

dep_date*

Departure date in YYYY-MM-DD format

adult_num

Number of adult passengers

trip_type

Trip type: OW (one-way) or RT (round-trip)

→ api.parse.bot/scraper/43fdabd8-4ad8-451f-94fa-d37591a26ef9/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Use it in your codegrab a free API key at signup

curl -X POST 'https://api.parse.bot/scraper/43fdabd8-4ad8-451f-94fa-d37591a26ef9/search_flights' \
  -H 'X-API-Key: $PARSE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "arr_city": "BJS",
  "dep_city": "SHA",
  "dep_date": "2026-02-26"
}'

All endpoints · 3 totalclick to expand

Search for available flights between departure and arrival cities on a specific date. Uses city codes (e.g., SHA for Shanghai, BJS for Beijing). Use get_cities to look up valid city codes. Returns flight segments with pricing, cabin classes, schedules, and aircraft details.

Input

Param	Type	Description
arr_cityrequired	string	Arrival city code (e.g., BJS for Beijing, HGH for Hangzhou). Use get_cities to find valid codes.
dep_cityrequired	string	Departure city code (e.g., SHA for Shanghai, CKG for Chongqing). Use get_cities to find valid codes.
dep_daterequired	string	Departure date in YYYY-MM-DD format
adult_num	integer	Number of adult passengers
trip_type	string	Trip type: OW (one-way) or RT (round-trip)

Response

{
  "type": "object",
  "fields": {
    "data": "object containing flightItems array with flight segments, cabin info, and pricing",
    "resultCode": "string (S200 for success)"
  },
  "sample": {
    "data": "{\"resultCode\": \"S200\", \"bizCode\": null, \"geeToken\": null, \"resultMsg\": \"\\u8bf7\\u6c42\\u6210\\u529f\\u3002\", \"timeStamp\": 1772034494126, \"transactionId\": \"d94b2ac3-9ab5-4b48-90b8-531e4547ab0d\", \"traceId\": \"808365748da73189\", \"debug\": {}, \"data\": {\"acceptFilters\": null, \"flightItems\": [{\"flightInfos\": [{\"flightSegments\": [{\"flightInfoId\": \"20260226SHAPEKMU5099\", \"flightFareIds\": [], \"orgCode\": \"SHA\", \"orgName\": \"Hongqiao International Airport\", \"orgShortName\": \"Hongqiao\", \"destCode\": \"PEK\", \"destName\": \"Capital International Airport\", \"destShortName\": \"Capital\", \"orgCtryCode\": \"CN\", \"orgCtryName\": \"China\", \"destCtryCode\": \"CN\", \"destCtryName\": \"China\", \"destCityCode\": \"BJS\", \"destCityName\": \"Beijing\", \"orgCityCode\": \"SHA\", \"orgCityName\": \"Shanghai\", \"stopDuration\": null, \"stopEng\": null, \"stopNum\": null, \"stopInfo\": null, \"stopAirportName\": null, \"stopNumName\": null, \"planeType\": \"919\", \"airlineCode\": \"MU\", \"airlineCodeName\": \"China Eastern Airlines\", \"flightNo\": \"5099\", \"codesharefg\": false, \"northernFlag\": false, \"fltDate\": \"2026-02-26\", \"orgTime\": \"07:00\", \"carrierCode\": \"MU\", \"carrierCodeName\": \"China Eastern Airlines\", \"carrierNo\": \"5099\", \"arriDate\": \"2026-02-26\", \"destTime\": \"09:20\", \"arriTerm\": \"T2\", \"depTerm\": \"T2\", \"fltSpanTime\": 140, \"isMeal\": \"B\", \"domesticOrInter\": \"D\", \"wifiOpenStatus\": false, \"searchOneId\": null, \"allCabins\": \"LYMJERBCDXKQN\", \"icaoType\": \"C919\", \"flightType\": \"QUICK,PETC\", \"flightCrossDay\": null, \"economySoldOutFlag\": \"0\", \"earlyFlightFlag\": false, \"tripId\": null, \"sequenceId\": \"1\", \"mediaFlag\": true, \"planeStatus\": 1, \"tailNo\": \"B658E\", \"colorSprayFlag\": false, \"grayFlag\": false, \"delayFlag\": false, \"estDeptTimeLoc\": null, \"estArrTimeLoc\": null, \"fareFileNo\": null, \"tourCode\": null, \"oriAirType\": \"1\", \"oriAddress\": null, \"desAirType\": \"1\", \"desAddress\": null, \"segmentNum\": \"1\"}], \"flightFareIds\": [\"EC31F84802EA9807F9E91E8E5A2464B3-BEC874607D45135F93DAE141D945AC8D\"], \"crossDay\": \"0\", \"duration\": 140, \"transferMinTimes\": [], \"domesticOrInter\": \"D\", \"flightSort\": {\"stop\": null, \"price\": 151.0, \"priceWithTax\": 161.1, \"priceForReschedule\": 161.1, \"depTime\": \"07:00\", \"arrTime\": \"09:20\", \"duration\": 140, \"depDate\": \"2026-02-26\", \"arrDate\": \"2026-02-26\", \"index\": 1, \"subIndex\": null, \"flyMin\": 140, \"transfer\": 0, \"stopover\": 0, \"ifOriginFlight\": false, \"ifMCAB\": false, \"specificSequence\": 2147483647, \"epidemicOderFlag\": null, \"standby\": null}, \"standby\": false, \"fstSegEconmySoldOutFlag\": \"0\", \"northernFlag\": \"false\", \"baggageInterLineFlag\": null, \"whetherTransProcessOnce\": false, \"epidemicOderFlag\": false, \"epidemicOderMsg\": null, \"tripLabelIds\": null}], \"cabinInfoDescs\": [{\"ccode\": \"Q\", \"ctype\": \"J\", \"muCabinLevel\": \"J\", \"cabinLevelName\": \"Business Class\", \"cabinDetail\": null, \"fareLevel\": \"\", \"fareInfoDescList\": [{\"paxType\": \"ADT\", \"passengerId\": null, \"lprice\": \"468.00\", \"taxPrice\": \"10.1\", \"totalPrice\": \"478.1\", \"oriTotalPrice\": null, \"rescheduleTotalPrice\": null, \"priceSource\": \"STANDARD\", \"productCode\": \"COMMON_J\", \"brandLevel\": null, \"oriBrandLevel\": null, \"fareFrom\": null, \"xProductIds\": null, \"fareTp\": \"1\", \"xCode\": null, \"lockCabinFlagMap\": null, \"labelKey\": null}], \"taxFeeInfoDesc\": {\"adtTaxFeeDiffInfo\": null, \"chdTaxFeeDiffInfo\": null, \"infTaxFeeDiffInfo\": null}}, {\"ccode\": \"R\", \"ctype\": \"Y\", \"muCabinLevel\": \"Y\", \"cabinLevelName\": \"Economy Class\", \"cabinDetail\": null, \"fareLevel\": \"\", \"fareInfoDescList\": [{\"paxType\": \"ADT\", \"passengerId\": null, \"lprice\": \"151.00\", \"taxPrice\": \"10.1\", \"totalPrice\": \"161.1\", \"oriTotalPrice\": null, \"rescheduleTotalPrice\": null, \"priceSource\": \"STANDARD\", \"productCode\": \"COMMON_Y\", \"brandLevel\": null, \"oriBrandLevel\": null, \"fareFrom\": null, \"xProductIds\": null, \"fareTp\": \"1\", \"xCode\": null, \"lockCabinFlagMap\": null, \"labelKey\": null}], \"taxFeeInfoDesc\": {\"adtTaxFeeDiffInfo\": null, \"chdTaxFeeDiffInfo\": null, \"infTaxFeeDiffInfo\": null}}]}, {\"flightInfos\": [{\"flightSegments\": [{\"flightInfoId\": \"20260226SHAPEKMU5101\", \"flightFareIds\": [], \"orgCode\": \"SHA\", \"orgName\": \"Hongqiao International Airport\", \"orgShortName\": \"Hongqiao\", \"destCode\": \"PEK\", \"destName\": \"Capital International Airport\", \"destShortName\": \"Capital\", \"orgCtryCode\": \"CN\", \"orgCtryName\": \"China\", \"destCtryCode\": \"CN\", \"destCtryName\": \"China\", \"destCityCode\": \"BJS\", \"destCityName\": \"Beijing\", \"orgCityCode\": \"SHA\", \"orgCityName\": \"Shanghai\", \"stopDuration\": null, \"stopEng\": null, \"stopNum\": null, \"stopInfo\": null, \"stopAirportName\": null, \"stopNumName\": null, \"planeType\": \"33J\", \"airlineCode\": \"MU\", \"airlineCodeName\": \"China Eastern Airlines\", \"flightNo\": \"5101\", \"codesharefg\": false, \"northernFlag\": false, \"fltDate\": \"2026-02-26\", \"orgTime\": \"08:00\", \"carrierCode\": \"MU\", \"carrierCodeName\": \"China Eastern Airlines\", \"carrierNo\": \"5101\", \"arriDate\": \"2026-02-26\", \"destTime\": \"10:15\", \"arriTerm\": \"T2\", \"depTerm\": \"T2\", \"fltSpanTime\": 135, \"isMeal\": \"B\", \"domesticOrInter\": \"D\", \"wifiOpenStatus\": true, \"searchOneId\": null, \"allCabins\": \"YJCDBQI\", \"icaoType\": \"Airbus332(Wide)\", \"flightType\": \"QUICK,PETC\", \"flightCrossDay\": null, \"economySoldOutFlag\": \"0\", \"earlyFlightFlag\": false, \"tripId\": null, \"sequenceId\": \"1\", \"mediaFlag\": false, \"planeStatus\": 1, \"tailNo\": \"B5975\", \"colorSprayFlag\": false, \"grayFlag\": false, \"delayFlag\": false, \"estDeptTimeLoc\": null, \"estArrTimeLoc\": null, \"fareFileNo\": null, \"tourCode\": null, \"oriAirType\": \"1\", \"oriAddress\": null, \"desAirType\": \"1\", \"desAddress\": null, \"segmentNum\": \"1\"}], \"flightFareIds\": [\"F1363A27869FD01B4947BF2285BDF120-BEC874607D45135F93DAE141D945AC8D\"], \"crossDay\": \"0\", \"duration\": 135, \"transferMinTimes\": [], \"domesticOrInter\": \"D\", \"flightSort\": {\"stop\": null, \"price\": 309.0, \"priceWithTax\": 319.1, \"priceForReschedule\": 319.1, \"depTime\": \"08:00\", \"arrTime\": \"10:15\", \"duration\": 135, \"depDate\": \"2026-02-26\", \"arrDate\": \"2026-02-26\", \"index\": 1, \"subIndex\": null, \"flyMin\": 135, \"transfer\": 0, \"stopover\": 0, \"ifOriginFlight\": false, \"ifMCAB\": false, \"specificSequence\": 2147483647, \"epidemicOderFlag\": null, \"standby\": null}, \"standby\": false, \"fstSegEconmySoldOutFlag\": \"0\", \"northernFlag\": \"false\", \"baggageInterLineFlag\": null, \"whetherTransProcessOnce\": false, \"epidemicOderFlag\": false, \"epidemicOderMsg\": null, \"tripLabelIds\": null}], \"cabinInfoDescs\": [{\"ccode\": \"B\", \"ctype\": \"Y\", \"muCabinLevel\": \"Y\", \"cabinLevelName\": \"Economy Class\", \"cabinDetail\": null, \"fareLevel\": \"\", \"fareInfoDescList\": [{\"paxType\": \"ADT\", \"passengerId\": null, \"lprice\": \"309.00\", \"taxPrice\": \"10.1\", \"totalPrice\": \"319.1\", \"oriTotalPrice\": null, \"rescheduleTotalPrice\": null, \"priceSource\": \"STANDARD\", \"productCode\": \"COMMON_Y\", \"brandLevel\": null, \"oriBrandLevel\": null, \"fareFrom\": null, \"xProductIds\": null, \"fareTp\": \"1\", \"xCode\": null, \"lockCabinFlagMap\": null, \"labelKey\": null}], \"taxFeeInfoDesc\": {\"adtTaxFeeDiffInfo\": null, \"chdTaxFeeDiffInfo\": null, \"infTaxFeeDiffInfo\": null}}, {\"ccode\": \"I\", \"ctype\": \"J\", \"muCabinLevel\": \"J\", \"cabinLevelName\": \"Business Class\", \"cabinDetail\": null, \"fareLevel\": \"\", \"fareInfoDescList\": [{\"paxType\": \"ADT\", \"passengerId\": null, \"lprice\": \"406.00\", \"taxPrice\": \"10.1\", \"totalPrice\": \"416.1\", \"oriTotalPrice\": null, \"rescheduleTotalPrice\": null, \"priceSource\": \"STANDARD\", \"productCode\": \"COMMON_J\", \"brandLevel\": null, \"oriBrandLevel\": null, \"fareFrom\": null, \"xProductIds\": null, \"fareTp\": \"1\", \"xCode\": null, \"lockCabinFlagMap\": null, \"labelKey\": null}], \"taxFeeInfoDesc\": {\"adtTaxFeeDiffInfo\": null, \"chdTaxFeeDiffInfo\": null, \"infTaxFeeDiffInfo\": null}}]}, {\"flightInfos\": [{\"flightSegments\": [{\"flightInfoId\": \"20260226PVGPEKMU5151\", \"flightFareIds\": [], \"orgCode\": \"PVG\", \"orgName\": \"Pudong International Airport\", \"orgShortName\": \"Pudong\", \"destCode\": \"PEK\", \"destName\": \"Capital International Airport\", \"destShortName\": \"Capital\", \"orgCtryCode\": \"CN\", \"orgCtryName\": \"China\", \"destCtryCode\": \"CN\", \"destCtryName\": \"China\", \"destCityCode\": \"BJS\", \"destCityName\": \"Beijing\", \"orgCityCode\": \"SHA\", \"orgCityName\": \"Shanghai\", \"stopDuration\": null, \"stopEng\": null, \"stopNum\": null, \"stopInfo\"...",
    "status": "success",
    "_truncated": "Use get_full_output(test_index=8) for complete data."
  }
}

About the m.ceair.com API

The m.ceair.com API provides 3 endpoints covering China Eastern Airlines flight search, real-time flight status, and city/airport lookup. Use search_flights to query available routes between city codes with pricing and cabin class data, get_flight_status to retrieve live departure and arrival updates including terminal and weather details, and get_cities to resolve the full list of supported domestic and international city codes.

Flight Search

The search_flights endpoint accepts a required departure city code (dep_city), arrival city code (arr_city), and departure date (dep_date in YYYY-MM-DD format). Optional parameters include adult_num for passenger count and trip_type set to OW (one-way) or RT (round-trip). A successful response (resultCode: S200) returns a data object containing a flightItems array. Each item includes flight segments, available cabin classes, schedule times, pricing, and aircraft details.

Flight Status

The get_flight_status endpoint takes a flight number (flight_no, digits only — for example 5137 rather than MU5137), a date in YYYY-MM-DD format, and an optional carrier code such as MU for China Eastern. On success, the response includes an aocFlightList array where each entry carries departure and arrival times, terminal assignments, aircraft type, current flight status, and weather information at origin and destination.

City and Airport Reference

The get_cities endpoint requires no parameters and returns a complete reference dataset. The data object is split into domesticCity and foreignCity sections. Each section contains a hotCityList for frequently used cities and a cityGroup array organized alphabetically. Entries include city codes, airport codes, railway station identifiers where applicable, and country information. This endpoint is the canonical way to resolve valid input codes before calling search_flights or get_flight_status.

Common use cases

Build a flight price tracker for China Eastern routes using search_flights to monitor fare changes by cabin class.
Power a travel itinerary app that resolves Chinese city names to airline codes via get_cities before querying available flights.
Display live departure and arrival boards for China Eastern flights using terminal and status fields from get_flight_status.
Alert travelers to delays or gate changes by polling get_flight_status for specific flight numbers and comparing current status fields.
Populate an airport autocomplete widget with domestic and international city codes returned by get_cities.
Aggregate China Eastern schedules into a multi-carrier comparison tool using search_flights response fields for timing and pricing.

Pricing & limitsSee full pricing →

Tier	Price	Credits/month	Rate limit
Free	$0/mo	100	5 req/min
Hobby	$30/mo	1,000	20 req/min
Developer	$100/mo	5,000	250 req/min

One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.

Frequently asked questions

Does China Eastern Airlines have an official developer API?+

China Eastern does not publish a public developer API for flight search or status data. The ceair.com and m.ceair.com sites are consumer-facing properties without a documented third-party API program.

What does `get_flight_status` return beyond basic on-time information?+

The aocFlightList array in the response includes departure and arrival times, terminal assignments, aircraft type, weather conditions at both origin and destination, and a current status string — not just a simple on-time or delayed flag.

Does `search_flights` return booking or seat reservation functionality?+

No. The endpoint returns flight availability data — segments, cabin classes, schedules, pricing, and aircraft details — but does not expose booking, seat selection, or payment flows. You can fork this API on Parse and revise it to add an endpoint targeting the booking surface if that data is needed.

Are codeshare or partner airline flights included in `search_flights` results?+

The endpoint queries China Eastern's own inventory. Coverage of codeshare partners operated under other carrier codes is not guaranteed. You can fork the API on Parse and revise it to target additional carrier codes or data sources for broader alliance coverage.

How should I find the correct city code before calling `search_flights`?+

Call get_cities first. It returns both domesticCity and foreignCity sections with city codes and airport codes for all supported locations. The hotCityList entries cover the most-traveled cities, while cityGroup provides an alphabetical index of the full set.

Page content last updated May 21, 2026. Spec covers 3 endpoints from m.ceair.com.