Search for a location by geographic coordinate.

GET

/locations/search

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.instagram.com/v1/locations/search'

Response Example

{
    "data": [
        {
            "id": "string",
            "latitude": 0,
            "longitude": 0,
            "name": "string"
        }
    ],
    "meta": {
        "code": 0
    }
}

Request

Query Params

distance

integer

optional

Default is 1000m (distance=1000), max distance is 5000.

facebook_places_id

string

optional

Returns a location mapped off of a Facebook places id. If used, a Foursquare id and lat, lng are not required.

foursquare_id

string

optional

Returns a location mapped off of a foursquare v1 api location id. If used, you are not required to use
lat and lng. Note that this method is deprecated; you should use the new foursquare IDs with V2 of their API.

lat

number

optional

Latitude of the center search coordinate. If used, lng is required.

lng

number

optional

Longitude of the center search coordinate. If used, lat is required.

foursquare_v2_id

string

optional

Returns a location mapped off of a foursquare v2 api location id. If used, you are not required to use
lat and lng.

Responses

🟢200List of found locations.

application/json

Body

data

array[object (LocationInfo) {4}]

optional

List of found locations

string

optional

ID of this location (in some responses it has a type of 'integer')

latitude

number <double>

optional

Location latitude

longitude

number <double>

optional

Location longitude

name

string

optional

Location name