Instagram

Post

A post or reel: its caption, counts, author, images and videos, tagged accounts, place, sound and topics.

GET/v1/instagram/posts1 credit

Headers

Get your API key

x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

codestringoptionalquery

A post's or reel's code: the part after /p/ or /reel/ in its link. Give code or url.

example: Dehl7Xohfah

urlstringoptionalquery

A post's or reel's link: instagram.com/p/<code> or /reel/<code>. Give code or url.

max 300 chars

Response fields

dataobject

The result: one object, or a list for the endpoints that return several.

data.idstring

Instagram's id for the post: digits.

data.codestring

The post's code: the part after /p/ or /reel/ in its link.

data.urlstring

The post's link.

data.typestringnullable

What it holds: image, video, carousel (several images or videos) or other.

data.is_reelbooleannullable

Whether it is a reel.

data.captionstringnullable

Its caption, with its hashtags and mentions.

data.created_atstringnullable

When it was posted.

format: date-time

data.likesintegernullable

Likes.

data.comment_countintegernullable

Comments.

data.playsintegernullable

How many times a reel was played, where the list gives it: a profile's reels and a topic's posts.

data.thumbnailstringnullable

Its image, or a video's cover. The link is signed, and expires after a while.

data.video_urlstringnullable

A video's file. The link is signed, and expires after a while.

data.widthintegernullable

Its width, in pixels.

data.heightintegernullable

Its height, in pixels.

data.authorstringnullable

Its author's handle. A collaboration's first author.

data.author_idstringnullable

Its author's id.

data.author_namestringnullable

Its author's display name.

data.author_verifiedbooleannullable

Whether its author is verified.

data.mediaarraynullable

Its images and videos, in order: a carousel's items, or the one image or video.

data.media[].idstringnullable

Instagram's id for the item.

data.media[].typestringnullable

image or video.

data.media[].urlstring

The file's link: the video, else the image. It is signed, and expires after a while.

data.media[].widthintegernullable

Its width, in pixels.

data.media[].heightintegernullable

Its height, in pixels.

data.media[].descriptionstringnullable

Instagram's description of the image, for screen readers.

data.taggedstring[]nullable

The handles tagged in it.

data.coauthorsstring[]nullable

A collaboration's authors' handles.

data.locationobjectnullable

The place it was tagged at.

data.location.idstringnullable

The place's id, for the locations endpoints.

data.location.namestringnullable

Its name.

data.location.latitudenumbernullable

Its latitude.

data.location.longitudenumbernullable

Its longitude.

data.audioobjectnullable

A reel's sound.

data.audio.idstringnullable

The sound's id.

data.audio.titlestringnullable

Its title: "Original audio" for one made with the reel.

data.audio.artiststringnullable

Who made it: a handle for an original sound, else the artist's name.

data.topicsstring[]nullable

The topics Instagram links it to: names for the topics endpoint.

data.descriptionstringnullable

Instagram's description of the image, for screen readers.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/instagram/posts?code=Dehl7Xohfah' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "code": "string",    "url": "string",    "type": "string",    "is_reel": true,    "caption": "string",    "created_at": "2019-08-24T14:15:22Z",    "likes": 0,    "comment_count": 0,    "plays": 0,    "thumbnail": "string",    "video_url": "string",    "width": 0,    "height": 0,    "author": "string",    "author_id": "string",    "author_name": "string",    "author_verified": true,    "media": [      {        "id": "string",        "type": "string",        "url": "string",        "width": 0,        "height": 0,        "description": "string"      }    ],    "tagged": [      "string"    ],    "coauthors": [      "string"    ],    "location": {      "id": "string",      "name": "string",      "latitude": 0,      "longitude": 0    },    "audio": {      "id": "string",      "title": "string",      "artist": "string"    },    "topics": [      "string"    ],    "description": "string"  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

Topic

Instagram's page for a topic or a hashtag: its summary, related searches, and the posts and reels it shows.

Post comments

A post's or reel's first comments, in Instagram's order: the 12 to 15 its page shows logged out. There is no next page.