Topic
Instagram's page for a topic or a hashtag: its summary, related searches, and the posts and reels it shows.
GET/v1/instagram/topics1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
2topicstringoptionalqueryA topic, such as harry potter, or a hashtag, with or without the #. Give topic or url.
min 1 chars · max 100 chars · example: harry potter
urlstringoptionalqueryA topic's link, instagram.com/popular/<topic>, or a hashtag's, instagram.com/explore/tags/<tag>. Give topic or url.
max 300 chars
Response fields
35dataobjectThe result: one object, or a list for the endpoints that return several.
data.namestringThe topic, as Instagram writes it in the link: harry-potter.
data.urlstringIts page's link.
data.descriptionstringnullableInstagram's summary of the topic, written for it.
data.relatedstring[]nullableRelated searches.
data.postsarrayThe posts and reels Instagram shows for it.
data.posts[].idstringInstagram's id for the post: digits.
data.posts[].codestringThe post's code: the part after /p/ or /reel/ in its link.
data.posts[].urlstringThe post's link.
data.posts[].typestringnullableWhat it holds: image, video, carousel (several images or videos) or other.
data.posts[].is_reelbooleannullableWhether it is a reel.
data.posts[].captionstringnullableIts caption, with its hashtags and mentions.
data.posts[].created_atstringnullableWhen it was posted.
format: date-time
data.posts[].likesintegernullableLikes.
data.posts[].comment_countintegernullableComments.
data.posts[].playsintegernullableHow many times a reel was played, where the list gives it: a profile's reels and a topic's posts.
data.posts[].thumbnailstringnullableIts image, or a video's cover. The link is signed, and expires after a while.
data.posts[].video_urlstringnullableA video's file. The link is signed, and expires after a while.
data.posts[].widthintegernullableIts width, in pixels.
data.posts[].heightintegernullableIts height, in pixels.
data.posts[].authorstringnullableIts author's handle. A collaboration's first author.
data.posts[].author_idstringnullableIts author's id.
data.posts[].author_namestringnullableIts author's display name.
data.posts[].author_verifiedbooleannullableWhether its author is verified.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether 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/topics?topic=harry+potter' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": { "name": "string", "url": "string", "description": "string", "related": [ "string" ], "posts": [ { "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 } ] }, "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 }}