↑ ↓ to move ↵ to open
Blinkit API reference

Blinkit Sample Merchant Coverage

blinkit.merchant.coverage

Check points across an area you choose to see which merchant IDs serve each one, with location and delivery time.

At a glance

Endpoint ID
blinkit.merchant.coverage
Price
1 credit per 25 results per call; failed calls are free
Runs for up to
180 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
blinkit__merchant__coverage
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "blinkit.merchant.coverage",  "input": {    "bounds": {      "east": 77.7,      "north": 12.98,      "south": 12.9,      "west": 77.6    },    "grid_step_km": 3,    "sampling_limit": 12  }}'

Input

  • Send the area to check in bounds, as its south, north, west and east edges. South must be below north and west below east. The area can be at most 10,000 square km and each side at most 200 km.
  • grid_step_km sets the spacing between checked points, from 1.5 to 20 km, 5 by default. sampling_limit caps how many points are checked, from 1 to 200, 25 by default.
FieldTypeRequiredWhat it doesExample
bounds object yes Geographic bounds of the requested area. {…}
grid_step_km number no From 1.5 to 20. Default: 5. 3
sampling_limit integer no From 1 to 200. Default: 25. 12

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "sampling": {    "attempted_points": 12,    "completed_points": 12,    "coordinates_scope": "sampled_delivery_points",    "elapsed_ms": 18071,    "grid_complete": false,    "grid_points": 20,    "grid_step_km": 3,    "selected_points": 12,    "serviceable_points": 12,    "bounds": {      "east": 77.7,      "north": 12.98,      "south": 12.9,      "west": 77.6    },    "points": [      {        "latitude": 12.9,        "longitude": 77.6,        "observed_at": "2026-10-04T14:27:49.240370066Z",        "status": "serviceable"      },      {        "latitude": 12.9,        "longitude": 77.65,        "observed_at": "2026-10-04T14:27:52.22980404Z",        "status": "serviceable"      }    ]  },  "results": [    {      "merchant_id": "30614",      "observations": [        {          "city": "Bengaluru",          "latitude": 12.9,          "locality": "HSR Layout",          "longitude": 77.65,          "observed_at": "2026-10-04T14:27:53.601089011Z",          "pincode": "560102",          "fulfillment": [            {              "eta_minutes": 8,              "type": "express"            }          ]        }      ]    },    {      "merchant_id": "30632",      "observations": [        {          "city": "Bengaluru",          "latitude": 12.953333333333333,          "locality": "Marathahalli",          "longitude": 77.7,          "observed_at": "2026-10-04T14:28:03.193491645Z",          "pincode": "560037",          "fulfillment": [            {              "eta_minutes": 19,              "type": "longtail"            }          ]        }      ]    }  ]}

Fields

FieldTypeWhat it isExample
results[].merchant_id string Store serving this location. 30614
results[].observations array How many of the checked delivery points this merchant serves. 1 records
results[].observations[].city string City of the point where the store was seen. Bengaluru
results[].observations[].fulfillment array Delivery types and times at that point. 1 records
results[].observations[].latitude number Latitude of the point checked. 12.9
results[].observations[].locality string Area name of the point, such as HSR Layout. HSR Layout
results[].observations[].longitude number Longitude of the point checked. 77.65
results[].observations[].observed_at string When the point was checked, in UTC. 2026-10-04T14:27:53.601089011Z
results[].observations[].pincode string Pincode of the point checked. 560102
results array The results returned. 29 records
sampling object How the area was checked: points, bounds and results. 11 fields
sampling.attempted_points integer How many points in the area were checked. 12
sampling.bounds object The area checked, as north, south, east and west edges. 4 fields
sampling.bounds.east number The area's eastern edge, as longitude. 77.7
sampling.bounds.north number The area's northern edge, as latitude. 12.98
sampling.bounds.south number The area's southern edge, as latitude. 12.9
sampling.bounds.west number The area's western edge, as longitude. 77.6
sampling.completed_points integer How many checks finished. 12
sampling.coordinates_scope string What the coordinates stand for, such as the points checked. sampled_delivery_points
sampling.elapsed_ms integer How long the check took, in milliseconds. 18,071
sampling.grid_complete boolean Whether every grid point was checked. false
sampling.grid_points integer How many points the area's grid has. 20
sampling.grid_step_km integer Distance between grid points, in kilometres. 3
sampling.points array Each point checked, with its result. 12 records
sampling.points[].latitude number Latitude of the point checked. 12.9
sampling.points[].longitude number Longitude of the point checked. 77.6
sampling.points[].observed_at string When the point was checked, in UTC. 2026-10-04T14:27:49.240370066Z
sampling.points[].status string The point's result: serviceable, unserviceable or failed. serviceable
sampling.selected_points integer How many points were chosen in the area. 12
sampling.serviceable_points integer How many points Blinkit delivers to. 12

What to know

  • Each merchant lists the checked delivery points it serves. The coordinates are those points, not physical stores.
  • The response says whether the whole grid was checked, how many points were done and why it stopped. A capped or interrupted grid does not cover the whole area or every address in a pincode. Physical store addresses, opening hours and delivery radii are not returned.

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Blinkit endpoints

Something missing or unclear? Ask the team that builds the Blinkit endpoints.