GETSearch1 credit
Search locations
GET https://api.instagramapi.dev/v1/search/locationsReturns locations/places matching a query.
Build this with an AI agent
Paste this prompt into Claude, Codex, or any coding agent.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | yes | Search text. |
Example request
curl "https://api.instagramapi.dev/v1/search/locations?q=new%20york" \
-H "Authorization: Bearer $INSTAGRAMAPI_KEY"Try it
Live request · uses 1 creditExample responses
Switch tabs to see the body shape for success and each error status.
{
"data": {
"items": [
{
"id": "317742662473550",
"name": "New York",
"category": "",
"address": "",
"city": "",
"lat": 40.7288,
"lng": -73.9972,
"external_id": "317742662473550"
}
],
"next_cursor": null
},
"meta": {
"endpoint": "search/locations",
"request_id": "req_3f8a1c9e",
"credits_charged": 1,
"credits_remaining": 4987,
"ms": 412
}
}Response fields
Fields returned under data on a 200 response. Every response also includes a meta object with billing info.
| Field | Type | Description |
|---|---|---|
| items | array<object> | Matching places. |
| items[].id | string | Numeric location id. |
| items[].name | string | The place's name. |
| items[].category | string | The place's category (e.g. City, Restaurant). |
| items[].address | string | Street address, when known. |
| items[].city | string | City, when known. |
| items[].lat | number | Latitude. |
| items[].lng | number | Longitude. |
| items[].external_id | string | Facebook Places id for the location. |
| next_cursor | null | Always null. This endpoint returns a single page and isn't paginated. |