postmates.com APIpostmates.com ↗
Access Postmates restaurant feeds, menus, item details, and search via 7 endpoints. Get store ratings, hours, delivery info, and full menu structures by location.
curl -X GET 'https://api.parse.bot/scraper/e8eb408e-fcea-460e-a5ef-7ae0b05d7e73/get_restaurant_feed?address=350+5th+Ave%2C+New+York%2C+NY' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a location-based feed of restaurants and stores available for delivery. Requires a delivery address to determine nearby options. Returns dining modes, sort/filter options, and a list of feed items including store carousels and regular store listings.
| Param | Type | Description |
|---|---|---|
| address | string | Delivery address to search near (e.g. '1600 Pennsylvania Ave NW, Washington, DC'). Defaults to Washington DC if not provided. |
{
"type": "object",
"fields": {
"feedItems": "array of restaurant/store feed entries including carousels and regular store listings",
"diningModes": "array of available dining modes (DELIVERY, PICKUP) with availability status",
"sortAndFilters": "array of sort and filter options with their values"
},
"sample": {
"data": {
"feedItems": [
{
"type": "REGULAR_CAROUSEL",
"uuid": "a22c790f-fe2a-4fa2-b269-a2600520ef70"
}
],
"diningModes": [
{
"mode": "DELIVERY",
"title": "Delivery",
"isSelected": true,
"isAvailable": true
}
],
"sortAndFilters": [
{
"type": "sort",
"uuid": "1c7cf7ef-730f-431f-9072-26bc39f7c021",
"label": "Sort"
}
]
},
"status": "success"
}
}About the postmates.com API
The Postmates API covers 7 endpoints for browsing and querying restaurant and store data on postmates.com, from location-based feeds to individual menu item customizations. The get_restaurant_feed endpoint returns nearby stores with dining modes and filter options, while get_menu_item_details exposes per-item pricing in cents, descriptions, and customization groups — giving you the full data chain from discovery to item selection.
Restaurant Discovery and Search
The get_restaurant_feed endpoint accepts a delivery address and returns a structured feed including store carousels, individual store listings, available diningModes (DELIVERY and PICKUP), and sortAndFilters options. The search_restaurants endpoint takes a query keyword and the same address parameter, and optionally a vertical filter (ALL, RESTAURANTS, SHOP, ALCOHOL) to narrow results by category. Each search result includes store ratings, delivery info, and image URLs. For typeahead behavior, get_search_suggestions returns both store-level suggestions (with UUIDs) and plain text keyword suggestions as the user types.
Menu and Item Data
Once you have a store UUID — from feed results or search — get_restaurant_details returns the full store record: title, location (address, city, latitude, longitude), hours by day range, a rating object with ratingValue and reviewCount, categories, and the complete catalogSectionsMap containing all menu sections and items. The get_restaurant_menu endpoint returns the same menu structure with explicit sectionsMap and catalogSectionsMap fields, mapping section UUIDs to arrays of subsection entries with their catalogItems.
Item-Level Details and Category Browsing
get_menu_item_details requires three UUIDs: item_uuid, store_uuid, and section_uuid, all obtainable from the menu response. It returns price in cents, title, itemDescription, and customizationsList — an array of customization groups with options. The optional subsection_uuid parameter, when provided, returns the item in full subsection context including any relevant modifiers. The get_categories endpoint requires no location input and returns top-level browsable categories organized under browseHomeFeed and verticalSearchHomeResults, mapped by vertical type.
- Build a restaurant discovery app that shows nearby delivery and pickup options for a given address using
get_restaurant_feed. - Populate a food search interface with real-time autocomplete using
get_search_suggestionsstore and keyword results. - Display full menus with section structure and item prices from
get_restaurant_menufor any Postmates store. - Show modifier and customization options for menu items using
customizationsListfromget_menu_item_details. - Filter restaurant search results by vertical (RESTAURANTS, SHOP, ALCOHOL) via
search_restaurantsto build category-specific storefronts. - Aggregate store ratings and review counts across categories using
ratingValueandreviewCountfromget_restaurant_details. - Build a category browsing page using
get_categorieswithout requiring any location input.
| 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.
Does Postmates have an official developer API?+
What does `get_restaurant_feed` return, and can I filter by dining mode?+
get_restaurant_feed returns feedItems (store carousels and individual store listings), diningModes (DELIVERY and PICKUP with availability status), and sortAndFilters options. The available filters are returned as part of the response itself, not as input parameters — you pass an address to establish location context, and the feed reflects what's available there.Does the API expose order placement or cart functionality?+
Are user reviews or written review text available from any endpoint?+
rating object returned by get_restaurant_details includes ratingValue and reviewCount at the store level. Individual written reviews and review text are not currently returned by any endpoint. You can fork this API on Parse and revise it to add a reviews endpoint if that data is needed.How do I get the UUIDs needed for `get_menu_item_details`?+
store_uuid comes from feed or search results. section_uuid is the top-level key in catalogSectionsMap from get_restaurant_menu. item_uuid comes from the catalogItems array within those sections. The optional subsection_uuid is the catalogSectionUUID field on each subsection entry in the same structure.