Media

GET /media/search

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

  • Base URL
    https://api.instagram.com/v1
  • URL
    https://api.instagram.com/v1/media/search
  • Auth
    • OAuth 2
      Implicit: https://instagram.com/oauth/authorize/
      Scopes: basic, comments, relationships, likes
    • or API key in query parameter access_token

Query parameters

LATnumber

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

MIN_TIMESTAMPinteger

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

LNGnumber

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

MAX_TIMESTAMPinteger

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

DISTANCEinteger

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

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.