/doordash/stores

POST /api/doordash/stores

Price: 20 credits

Get full DoorDash (doordash.com) store/restaurant details by store id (or store URL): name, description, price range, rating and review count, address, phone, website, cuisines, delivery fee, ETA, opening hours, DoorDash ordering hours, photos, one menu with categories, items, prices, dietary tags and item ratings, the list of the store's menus, plus a review summary (star breakdown) and a few customer reviews.

How to use it

Fetch a single DoorDash (doordash.com) store by id (e.g. '19906') or a full store URL. The categories hold the menu named in menu_id and menu_name; menus lists every menu of the store (for example breakfast, lunch and dinner), and each other one is fetched by passing its id as menu_id. A convenience or retail store (e.g. 28586914) returns its header, hours and one menus entry but no categories, also when that menu id is passed; a store with a very large catalog (e.g. 34744855) returns its header only: everything below the header, menus included, is empty.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• store string required — DoorDash store id or a full store URL (examples: "19906", "https://www.doordash.com/store/katzs-delicatessen-new-york-19906/"; minLength: 1)
• menu_id string nullable — DoorDash menu id of this store, one of the ids in menus; omitted, the store's current menu (examples: "1117216"; pattern: ^\d+$)

Response

• @type string (default: "DoordashStore")
• id string required
• name string required
• url string nullable
• description string nullable
• price_range integer nullable
• price_range_display string nullable
• rating number nullable
• rating_count integer nullable
• rating_count_display string nullable
• currency string nullable
• timezone string nullable
• store_bio string nullable
• image string nullable
• square_cover string nullable
• banner string nullable
• images array (default: [])
• phone string nullable
• website string nullable
• business_id string nullable
• business_name string nullable
• cuisines array (default: [])
• is_convenience boolean nullable
• is_open boolean nullable
• is_inactive boolean nullable
• operation_status string nullable
• offers_delivery boolean (default: false)
• offers_pickup boolean (default: false)
• is_dashpass_partner boolean (default: false)
• delivery_fee_text string nullable — The delivery-fee text DoorDash shows a visitor who has not entered an address, typically a first-order promotion such as '$0 delivery fee, first order'.
• delivery_minutes string nullable
• pickup_minutes string nullable
• asap_minutes integer nullable
• photo_count_text string nullable
• address object nullable
  • @type string (default: "DoordashAddress")
  • street string nullable
  • city string nullable
  • state string nullable
  • display_address string nullable
  • country_code string nullable
  • latitude number nullable
  • longitude number nullable
• hours array (default: [])
  • @type string (default: "DoordashHours")
  • day string required
  • slots array (default: [])
• ordering_hours array (default: [])
  • @type string (default: "DoordashHours")
  • day string required
  • slots array (default: [])
• menu_id string nullable
• menu_name string nullable
• menus array (default: [])
  • @type string (default: "DoordashMenu")
  • id string required
  • name string nullable
  • hours string nullable
• category_count integer (default: 0)
• item_count integer (default: 0)
• categories array (default: [])
  • @type string (default: "DoordashMenuCategory")
  • id string required
  • name string required
  • description string nullable
  • items array (default: [])
    • @type string (default: "DoordashMenuItem")
    • id string required
    • name string required
    • description string nullable
    • price number nullable — The item's listed price in the store currency, as DoorDash lists it. Without a promotion it is the price charged per item. On a percent-off promotion it is the price before the discount (equal to strikethrough_price). On a 'N for $X' promotion it is the bundle price $X. The amount charged per item under a promotion is charged_unit_price.
    • display_price string nullable — The price text as DoorDash shows it: the charged amount on a percent-off promotion ('$28.80'), the bundle text on a 'N for $X' promotion ('2 for $14.00'), '$7.19+' when the price depends on an option.
    • strikethrough_price number nullable — Present only on promoted items: the amount DoorDash shows crossed out, the undiscounted price of one item on a percent-off promotion and of the whole bundle quantity on a 'N for $X' promotion (28.0 beside '2 for $14.00').
    • charged_unit_price number nullable — The amount actually charged per item. Equal to price without a promotion; the discounted amount shown in display_price on a percent-off promotion; $X divided by N on a 'N for $X' promotion (7.0 for '2 for $14.00').
    • image string nullable
    • callout string nullable
    • rating_display string nullable
    • like_percent integer nullable
    • rating_count integer nullable
    • serving_size string nullable
    • dietary_tags array (default: [])
    • badges array (default: [])
• review_summary object nullable
  • @type string (default: "DoordashReviewSummary")
  • average_rating number nullable
  • rating_count integer nullable
  • review_count integer nullable
  • stars_breakdown array (default: [])
    • @type string (default: "DoordashStarBucket")
    • stars integer required
    • rating_count integer (default: 0)
• reviews array (default: [])
  • @type string (default: "DoordashReview")
  • consumer_review_uuid string required
  • reviewer_display_name string nullable
  • reviewer_id string nullable
  • num_stars integer nullable
  • review_text string nullable
  • marked_up_review_text string nullable
  • reviewed_at integer nullable
  • is_verified boolean (default: false)
  • source string nullable
  • items array (default: [])

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — Store not found (well-formed id but no such store on DoorDash), or menu_id is not one of its menus Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.