Blinkit Resolve Location
blinkit.location
Resolve a pincode, place name or coordinates, see whether Blinkit serves it and get the merchants attached to that point.
At a glance
- Endpoint ID
blinkit.location- Price
- 1 credit per call; failed calls are free
- Runs for up to
- 60 seconds
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.location", "input": { "pincode": "560102" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "blinkit.location", "input": { "pincode": "560102" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "blinkit.location", "input": { "pincode": "560102" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
- Send one kind of location: pincode, a place name in query, or latitude and longitude together. Here the place name goes in query; the catalog endpoints call it location_query.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
latitude |
number | one of | Latitude of the delivery address. From -90 to 90. | |
longitude |
number | one of | Longitude of the delivery address. From -180 to 180. | |
pincode |
string | one of | Six-digit Indian pincode; surrounding whitespace is allowed and trimmed. Do not combine with coordinates. | 560102 |
query |
string | one of | Free-text Indian place, locality, city, address, or pincode to resolve. |
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:
{ "city": "Bengaluru", "latitude": 12.911862, "locality": "HSR Layout", "longitude": 77.6445923, "merchant_id": "40589", "resolution": "pincode_representative_point", "serviceable": true, "location_info": { "city": "Bengaluru", "country": "India", "district": "Bangalore Division", "formatted_address": "4th Cross Rd, Sector 5, HSR Layout, Bengaluru, Karnataka 560102, India", "locality": "HSR Layout", "postal_code": "560102", "state": "Karnataka" }, "merchants": [ { "id": "35940", "fulfillment_types": [ "instant" ] }, { "id": "40589", "fulfillment_types": [ "express" ] } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
city |
string | City the pincode resolves to. | Bengaluru |
locality |
string | Locality of the representative delivery point. | HSR Layout |
serviceable |
boolean | Whether Blinkit delivers to this point. | true |
merchant_id |
string | Store serving this location. | 40589 |
merchants |
array | Merchants serving this delivery point. | 4 records |
merchants[].fulfillment_types |
array | How the merchant delivers, such as instant. | instant |
merchants[].id |
string | Blinkit's merchant ID. | 35940 |
latitude |
number | Latitude of the delivery point this response is priced for. | 12.91 |
longitude |
number | Longitude of the delivery point this response is priced for. | 77.64 |
location_info |
object | The resolved address for the location. | 7 fields |
location_info.city |
string | City the pincode resolves to. | Bengaluru |
location_info.country |
string | Country of the location. | India |
location_info.district |
string | District of the location. | Bangalore Division |
location_info.formatted_address |
string | The full address Blinkit resolved. | 4th Cross Rd, Sector 5, HSR Layout, Bengaluru, Karnataka 560102… |
location_info.locality |
string | Locality of the representative delivery point. | HSR Layout |
location_info.postal_code |
string | Pincode of the location. | 560102 |
location_info.state |
string | State of the location. | Karnataka |
resolution |
string | How the location was found, such as from a pincode. | pincode_representative_point |
What to know
- Keep serviceability separate from product availability. The resolved point and merchant IDs describe that delivery point, not every address in its pincode.
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.