UnifAPI Docs

List posts for an Instagram topic

Returns posts and Reels that Instagram groups under a topic such as `harry potter`. Paginate with `cursor`.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/instagram/topics/{topic}/posts

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

topic*string

Topic text, e.g. harry potter.

Length1 <= length <= 500

Query Parameters

cursor?string

Opaque pagination cursor from a previous response's pagination.next_cursor. Omit for the first page.

Length1 <= length <= 16384

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/instagram/topics/string/posts"
{  "request_id": "string",  "data": [    {      "id": "string",      "shortcode": "string",      "url": "string",      "kind": "string",      "media_type": "string",      "caption": "string",      "alt_text": "string",      "created_at": 0,      "owner": {        "id": "string",        "username": "string",        "display_name": "string",        "avatar_url": "string",        "is_verified": true,        "is_private": true      },      "like_count": 0,      "comment_count": 0,      "play_count": 0,      "share_count": 0,      "save_count": 0,      "is_likes_hidden": true,      "image_url": "string",      "thumbnail_url": "string",      "video_url": "string",      "duration": 0,      "dimensions": {        "width": 0,        "height": 0      },      "carousel": [        {          "id": "string",          "media_type": "string",          "image_url": "string",          "video_url": "string",          "duration": 0,          "dimensions": {            "width": 0,            "height": 0          },          "alt_text": "string"        }      ],      "audio": {        "id": "string",        "title": "string",        "artist": "string",        "is_original": true,        "artist_handle": "string"      },      "coauthors": [        {          "id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        }      ],      "tagged_users": [        {          "id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        }      ],      "location": {        "id": "string",        "name": "string",        "lat": 0,        "lng": 0      },      "is_paid_partnership": true,      "sponsors": [        {          "id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        }      ],      "is_comments_disabled": true,      "is_pinned": true,      "story": {        "expires_at": 0,        "link_stickers": [          {            "url": "string",            "display_url": "string"          }        ],        "mentions": [          {            "id": "string",            "username": "string",            "display_name": "string",            "avatar_url": "string",            "is_verified": true,            "is_private": true          }        ],        "shared_media": {          "id": "string",          "shortcode": "string"        }      }    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}