Instagram API
  1. media
Instagram API
  • geographies
    • Get recent media from a custom geo-id.
      GET
  • locations
    • Search for a location by geographic coordinate.
      GET
    • Get information about a location.
      GET
    • Get a list of recent media objects from a given location.
      GET
  • media
    • Get a list of currently popular media.
      GET
    • Search for media in a given area.
      GET
    • Get information about a media object.
      GET
    • Get information about a media object.
      GET
  • comments
    • Get a list of recent comments on a media object.
      GET
    • Create a comment on a media object.
      POST
    • Remove a comment.
      DELETE
  • likes
    • Remove a like on this media by the current user.
      DELETE
    • Get a list of users who have liked this media.
      GET
    • Set a like on this media by the current user.
      POST
  • tags
    • Search for tags by name.
      GET
    • Get information about a tag object.
      GET
    • Get a list of recently tagged media.
      GET
  • users
    • Search for a user by name.
      GET
    • See the authenticated user's feed.
      GET
    • See the list of media liked by the authenticated user.
      GET
    • Get basic information about a user.
      GET
    • Get the most recent media published by a user.
      GET
  • relationships
    • List the users who have requested this user's permission to follow.
    • Get the list of users this user is followed by.
    • Get the list of users this user follows.
    • Get information about a relationship to another user.
    • Modify the relationship between the current user and the target user.
  1. media

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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.instagram.com/v1/media/search?lat=&lng='
Response 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
id
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
tags
array[string]
optional
List of tags assigned to this media
type
enum<string> 
optional
Type of this media entry
Allowed values:
imagevideo
user
object (UserShortInfo) 
optional
user_has_liked
boolean 
optional
Indicates whether authenticated user has liked this media or not
users_in_photo
array[object (UserInPhoto) {2}] 
optional
Users located on this media entry
videos
object (VideosData) 
optional
meta
object (MetaData) 
optional
code
integer <int32>
optional
HTTP result code
Modified at 2023-08-15 03:55:31
Previous
Get a list of currently popular media.
Next
Get information about a media object.
Built with