GETSearch1 credit

Search locations

GET https://api.instagramapi.dev/v1/search/locations

Returns locations/places matching a query.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

NameTypeRequiredDescription
qstringyesSearch 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 credit

Example 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.

FieldTypeDescription
itemsarray<object>Matching places.
items[].idstringNumeric location id.
items[].namestringThe place's name.
items[].categorystringThe place's category (e.g. City, Restaurant).
items[].addressstringStreet address, when known.
items[].citystringCity, when known.
items[].latnumberLatitude.
items[].lngnumberLongitude.
items[].external_idstringFacebook Places id for the location.
next_cursornullAlways null. This endpoint returns a single page and isn't paginated.