Endpoint Playground

Try the Grubhub Offers API

Test Crawlora's Grubhub Offers API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /grubhub/offers
Platform: Grubhub
Auth: apiKey
Credits: 1 credit/request
Required params: restaurant_id, latitude, longitude

Grubhub Offers API documentation Grubhub platform page Crawlora API pricing Try Grubhub Availability API Try Grubhub Restaurant API Try Grubhub Restaurant Menu API Try Grubhub Restaurant Reviews API Try Grubhub Search API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/grubhub/offers?restaurant_id=<restaurant_id>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
restaurant_id	string	Yes	Grubhub restaurant id
latitude	number	Yes	Diner location latitude
longitude	number	Yes	Diner location longitude

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "restaurant_id": "1338141",
    "offers": [
      {
        "entitlement_id": "6b4aee10-a242-11f1-ae11-9fd715717d12",
        "entitlement_type": "UNIFIED_REWARD",
        "offer_type": "ENTERPRISE_REWARD",
        "title": "Free Double Cheeseburger",
        "description": "Get a free Double Cheeseburger (up to a $10 value) on your delivery order when you spend $20+. ...",
        "pill_text": "$10 off",
        "end_date": "2026-10-01T03:55:00.000Z",
        "amount": {
          "value": 0,
          "type": "MENU_ITEM",
          "currency": "USD",
          "order_minimum": 20,
          "amount_maximum": 10
        },
        "redeem_item_count": 1
      }
    ],
    "count": 1,
    "source_url": "https://api-gtm.grubhub.com/offers/availability/1338141?orderType=STANDARD&locationMode=DELIVERY&whenFor=2026-09-01T08%3A00%3A00.000Z&isSubscriber=false&deliveryLatitude=40.75368499&deliveryLongitude=-73.99916077&nonAnchorCart=false&featureFlags=includeLockedOffers",
    "fetched_at": "2026-09-01T08:00:00Z"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestgrubhub.offersResponseDocGrubhub

GET /grubhub/offers

Get one Grubhub restaurant's currently active promotions

Returns the promotional offers a Grubhub restaurant is currently running -- free items, BOGO deals, spend-and-save discounts -- the same data that drives the "2 offers available" badge on the site's own restaurant cards. An empty list is the common, legitimate case: most restaurants have no active promotion at any given moment. `amount.value` is 0 for a free-item offer since the item itself is the value, not a monetary discount; `amount.amount_maximum` then caps the item's dollar value, and `amount.order_minimum` is the spend threshold required to unlock it.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

restaurant_id

requiredstring

Grubhub restaurant idlatitude

requirednumber

Diner location latitudelongitude

requirednumber

Diner location longitude

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "restaurant_id": "1338141",
    "offers": [
      {
        "entitlement_id": "6b4aee10-a242-11f1-ae11-9fd715717d12",
        "entitlement_type": "UNIFIED_REWARD",
        "offer_type": "ENTERPRISE_REWARD",
        "title": "Free Double Cheeseburger",
        "description": "Get a free Double Cheeseburger (up to a $10 value) on your delivery order when you spend $20+. ...",
        "pill_text": "$10 off",
        "end_date": "2026-10-01T03:55:00.000Z",
        "amount": {
          "value": 0,
          "type": "MENU_ITEM",
          "currency": "USD",
          "order_minimum": 20,
          "amount_maximum": 10
        },
        "redeem_item_count": 1
      }
    ],
    "count": 1,
    "source_url": "https://api-gtm.grubhub.com/offers/availability/1338141?orderType=STANDARD&locationMode=DELIVERY&whenFor=2026-09-01T08%3A00%3A00.000Z&isSubscriber=false&deliveryLatitude=40.75368499&deliveryLongitude=-73.99916077&nonAnchorCart=false&featureFlags=includeLockedOffers",
    "fetched_at": "2026-09-01T08:00:00Z"
  }
}

Endpoint details

Method: GET
Path: /grubhub/offers
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Grubhub
Parameters: 4 documented fields

Request parameters

restaurant_id:querylatitude:querylongitude:queryx-api-key:header

Response schema fields

codedatadata.countdata.fetched_atdata.offersdata.offers[].amountdata.offers[].amount.amount_maximumdata.offers[].amount.currencydata.offers[].amount.order_minimumdata.offers[].amount.typedata.offers[].amount.valuedata.offers[].description

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "restaurant_id": "1338141",
    "offers": [
      {
        "entitlement_id": "6b4aee10-a242-11f1-ae11-9fd715717d12",
        "entitlement_type": "UNIFIED_REWARD",
        "offer_type": "ENTERPRISE_REWARD",
        "title": "Free Double Cheeseburger",
        "description": "Get a free Double Cheeseburger (up to a $10 value) on your delivery order when you spend $20+. ...",
        "pill_text": "$10 off",
        "end_date": "2026-10-01T03:55:00.000Z",
        "amount": {
          "value": 0,
          "type": "MENU_ITEM",
          "currency": "USD",
          "order_minimum": 20,
          "amount_maximum": 10
        },
        "redeem_item_count": 1
      }
    ],
    "count": 1,
    "source_url": "https://api-gtm.grubhub.com/offers/availability/1338141?orderType=STANDARD&locationMode=DELIVERY&whenFor=2026-09-01T08%3A00%3A00.000Z&isSubscriber=false&deliveryLatitude=40.75368499&deliveryLongitude=-73.99916077&nonAnchorCart=false&featureFlags=includeLockedOffers",
    "fetched_at": "2026-09-01T08:00:00Z"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/grubhub/offers?restaurant_id=<restaurant_id>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Check ordering availability for a batch of Grubhub restaurants Get one Grubhub restaurant's detail Get one Grubhub restaurant's menu with prices Get one Grubhub restaurant's reviews and rating histogram Search Grubhub restaurants near a location

Endpoint Playground

Try the Grubhub Offers API

Endpoint facts

Method: GET
API path: /grubhub/offers
Platform: Grubhub
Auth: apiKey
Credits: 1 credit/request
Required params: restaurant_id, latitude, longitude

Prefilled cURL

curl "https://api.crawlora.net/api/v1/grubhub/offers?restaurant_id=<restaurant_id>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
restaurant_id	string	Yes	Grubhub restaurant id
latitude	number	Yes	Diner location latitude
longitude	number	Yes	Diner location longitude

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "restaurant_id": "1338141",
    "offers": [
      {
        "entitlement_id": "6b4aee10-a242-11f1-ae11-9fd715717d12",
        "entitlement_type": "UNIFIED_REWARD",
        "offer_type": "ENTERPRISE_REWARD",
        "title": "Free Double Cheeseburger",
        "description": "Get a free Double Cheeseburger (up to a $10 value) on your delivery order when you spend $20+. ...",
        "pill_text": "$10 off",
        "end_date": "2026-10-01T03:55:00.000Z",
        "amount": {
          "value": 0,
          "type": "MENU_ITEM",
          "currency": "USD",
          "order_minimum": 20,
          "amount_maximum": 10
        },
        "redeem_item_count": 1
      }
    ],
    "count": 1,
    "source_url": "https://api-gtm.grubhub.com/offers/availability/1338141?orderType=STANDARD&locationMode=DELIVERY&whenFor=2026-09-01T08%3A00%3A00.000Z&isSubscriber=false&deliveryLatitude=40.75368499&deliveryLongitude=-73.99916077&nonAnchorCart=false&featureFlags=includeLockedOffers",
    "fetched_at": "2026-09-01T08:00:00Z"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestgrubhub.offersResponseDocGrubhub

GET /grubhub/offers

Get one Grubhub restaurant's currently active promotions

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

restaurant_id

requiredstring

Grubhub restaurant idlatitude

requirednumber

Diner location latitudelongitude

requirednumber

Diner location longitude

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "restaurant_id": "1338141",
    "offers": [
      {
        "entitlement_id": "6b4aee10-a242-11f1-ae11-9fd715717d12",
        "entitlement_type": "UNIFIED_REWARD",
        "offer_type": "ENTERPRISE_REWARD",
        "title": "Free Double Cheeseburger",
        "description": "Get a free Double Cheeseburger (up to a $10 value) on your delivery order when you spend $20+. ...",
        "pill_text": "$10 off",
        "end_date": "2026-10-01T03:55:00.000Z",
        "amount": {
          "value": 0,
          "type": "MENU_ITEM",
          "currency": "USD",
          "order_minimum": 20,
          "amount_maximum": 10
        },
        "redeem_item_count": 1
      }
    ],
    "count": 1,
    "source_url": "https://api-gtm.grubhub.com/offers/availability/1338141?orderType=STANDARD&locationMode=DELIVERY&whenFor=2026-09-01T08%3A00%3A00.000Z&isSubscriber=false&deliveryLatitude=40.75368499&deliveryLongitude=-73.99916077&nonAnchorCart=false&featureFlags=includeLockedOffers",
    "fetched_at": "2026-09-01T08:00:00Z"
  }
}

Endpoint details

Method: GET
Path: /grubhub/offers
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Grubhub
Parameters: 4 documented fields

Request parameters

restaurant_id:querylatitude:querylongitude:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "restaurant_id": "1338141",
    "offers": [
      {
        "entitlement_id": "6b4aee10-a242-11f1-ae11-9fd715717d12",
        "entitlement_type": "UNIFIED_REWARD",
        "offer_type": "ENTERPRISE_REWARD",
        "title": "Free Double Cheeseburger",
        "description": "Get a free Double Cheeseburger (up to a $10 value) on your delivery order when you spend $20+. ...",
        "pill_text": "$10 off",
        "end_date": "2026-10-01T03:55:00.000Z",
        "amount": {
          "value": 0,
          "type": "MENU_ITEM",
          "currency": "USD",
          "order_minimum": 20,
          "amount_maximum": 10
        },
        "redeem_item_count": 1
      }
    ],
    "count": 1,
    "source_url": "https://api-gtm.grubhub.com/offers/availability/1338141?orderType=STANDARD&locationMode=DELIVERY&whenFor=2026-09-01T08%3A00%3A00.000Z&isSubscriber=false&deliveryLatitude=40.75368499&deliveryLongitude=-73.99916077&nonAnchorCart=false&featureFlags=includeLockedOffers",
    "fetched_at": "2026-09-01T08:00:00Z"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/grubhub/offers?restaurant_id=<restaurant_id>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"