Search for media in a given area.

GET

/media/search

media

Search for media in a given area. The default time span is set to 5 days. The time span must not exceed 7 days.
Defaults time stamps cover the last 5 days. Can return mix of image and video types.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.instagram.com/v1/media/search?lat=&lng='

Response Example

{
    "data": [
        {
            "attribution": "string",
            "caption": {
                "created_time": "string",
                "from": {
                    "full_name": "string",
                    "id": "string",
                    "profile_picture": "string",
                    "username": "string"
                },
                "id": "string",
                "text": "string"
            },
            "comments": {
                "count": 0,
                "data": [
                    {
                        "created_time": "string",
                        "from": {
                            "full_name": "string",
                            "id": "string",
                            "profile_picture": "string",
                            "username": "string"
                        },
                        "id": "string",
                        "text": "string"
                    }
                ]
            },
            "created_time": "string",
            "filter": "string",
            "id": "string",
            "images": {
                "low_resolution": {
                    "height": 0,
                    "url": "string",
                    "width": 0
                },
                "standard_resolution": {
                    "height": 0,
                    "url": "string",
                    "width": 0
                },
                "thumbnail": {
                    "height": 0,
                    "url": "string",
                    "width": 0
                }
            },
            "likes": {
                "count": 0,
                "data": [
                    {
                        "full_name": "string",
                        "id": "string",
                        "profile_picture": "string",
                        "username": "string"
                    }
                ]
            },
            "link": "string",
            "location": {
                "id": "string",
                "latitude": 0,
                "longitude": 0,
                "name": "string"
            },
            "tags": [
                "string"
            ],
            "type": "image",
            "user": {
                "full_name": "string",
                "id": "string",
                "profile_picture": "string",
                "username": "string"
            },
            "user_has_liked": true,
            "users_in_photo": [
                {
                    "position": {
                        "x": 0,
                        "y": 0
                    },
                    "user": {
                        "full_name": "string",
                        "id": "string",
                        "profile_picture": "string",
                        "username": "string"
                    }
                }
            ],
            "videos": {
                "low_resolution": {
                    "height": 0,
                    "url": "string",
                    "width": 0
                },
                "standard_resolution": {
                    "height": 0,
                    "url": "string",
                    "width": 0
                }
            }
        }
    ],
    "meta": {
        "code": 0
    }
}

Request

Query Params

lat

number

required

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

lng

number

required

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

min_timestamp

integer

optional

A unix timestamp. All media returned will be taken later than this timestamp.

max_timestamp

integer

optional

A unix timestamp. All media returned will be taken earlier than this timestamp.

distance

integer

optional

Default is 1km (distance=1000), max distance is 5km.

Responses

🟢200Found media resources (without likes information) in a given area.

application/json

Body

data

array[object (MediaEntry) {16}]

optional

Found media entries; some end-points do not return likes informtaion

attribution

string

optional

??? Unknown ???

caption

object (CaptionData)

optional

comments

object (CommentsCollection)

optional

created_time

string

optional

Media creation UNIX timestamp

filter

string

optional

Filter of this media entry

string

optional

ID of a media entry

images

object (ImagesData)

optional

likes

object (LikesCollection)

optional

link

string

optional

Fixed URL of this media entry

location

object (LocationInfo)

optional