Search Instagram locations

Search Instagram locations by name to get their ids, names and coordinates.

GET/v2/instagram/locations/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

Place name, such as `times square`.

min 1 chars · max 512 chars

Response fields
17

Endpoint-specific response payload.

Places matching the query, in Instagram's relevance order. Each `id` works with `GET /v2/instagram/locations/{locationId}` and its `/media`. Matching is fuzzy, so a query with no real match can still return loosely related places. One set per query: there is no next page.

datalocations[]id
string

Location id.

pattern: ^\d+$

datalocations[]name
stringnullable

Place name.

datalocations[]lat
numbernullable

Latitude.

datalocations[]lng
numbernullable

Longitude.

datalocations[]category
stringnullable

Place category.

datalocations[]address
stringnullable

Street address. Often null.

datalocations[]city
stringnullable

City. Often null.

datalocations[]description
stringnullable

Short description of the place. Null when none is shown.

datalocations[]imageUrl
stringnullable

Picture of the place. Null when none is shown. Instagram CDN URL; it expires after a while.

datalocations[]facebookPlacesId
stringnullable

Facebook Places id of the same place. Null when none is linked.

pattern: ^\d+$

datalocations[]url
string

Public location page URL.

Metadata about the API response.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v2

Code example

curl "https://api.socialfetch.dev/v2/instagram/locations/search?query=times%20square" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Places matching the query.