API resource

Instagram lookups

Research through your connected Instagram account: the public profile and recent media of any Business or Creator account by username (competitors, collaborators), media you are tagged or mentioned in, a post's collaborators and your live broadcasts.

Look up a public Instagram Business account

GET/v1/accounts/{accountId}/instagram/business-discovery

Works on: Instagram

Returns the public profile and most recent media of any Instagram Business or Creator account, looked up by username through one of your connected Instagram accounts. Useful for competitor and market research. Personal accounts and private accounts cannot be looked up. Requires an Instagram account connected via Facebook Login. Meta serves business discovery on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (instagram_business_discovery_requires_facebook_login) and must be reconnected choosing the Facebook option.

Path parameters

accountIdstringrequired

The ID of a connected Instagram account (Facebook Login).

Query parameters

usernamestringrequired

Instagram handle to look up, with or without the leading @. Case-insensitive.

limitinteger

How many of the most recent media to return.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/instagram/business-discovery?username=%3Cusername%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "profile": {
    "id": "string",
    "username": "string",
    "name": "string",
    "biography": "string",
    "website": "string",
    "profilePictureUrl": "string",
    "followersCount": 0,
    "followsCount": 0,
    "mediaCount": 0
  },
  "media": [
    {
      "id": "string",
      "caption": "string",
      "mediaType": "string",
      "mediaProductType": "string",
      "timestamp": "2026-10-10T00:00:00.000Z",
      "permalink": "string",
      "likeCount": 0,
      "commentsCount": 0,
      "mediaUrl": "string",
      "thumbnailUrl": "string",
      "viewCount": 0,
      "children": [
        {}
      ]
    }
  ]
}

List the live broadcasts of an Instagram account

GET/v1/accounts/{accountId}/instagram/live-media

Works on: Instagram

Returns the live videos the connected Instagram account is broadcasting right now. Meta only returns broadcasts in progress at the time of the request, so the list is empty when nothing is live (a 200, not an error). Pair the returned id with comments flagged as live (the live_comments webhook field) or with a live_comment comment automation. ### Requires Facebook Login The Instagram account must be connected via Facebook Login. Meta documents the live_media edge on graph.facebook.com only.

Path parameters

accountIdstringrequired

The ID of a connected Instagram account (Facebook Login).

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/instagram/live-media" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "id": "string",
      "mediaType": "BROADCAST",
      "mediaProductType": "LIVE",
      "username": "string",
      "timestamp": "string"
    }
  ]
}

List the posts an Instagram account is tagged in

GET/v1/accounts/{accountId}/instagram/tags

Works on: Instagram

Returns the media where other Instagram users photo-tagged the connected account, newest first. Private media is never returned. Cursor-paginated: pass nextCursor from the previous response as cursor to read the next page. nextCursor is null when there are no more pages. Meta does not say whether a page is the last one, so the final page can come back empty with nextCursor null. Requires an Instagram account connected via Facebook Login.

Path parameters

accountIdstringrequired

The ID of a connected Instagram account (Facebook Login).

Query parameters

limitinteger

Page size.

cursorstring

The nextCursor of the previous page.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/instagram/tags" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "id": "string",
      "caption": "string",
      "mediaType": "IMAGE",
      "mediaProductType": "FEED",
      "mediaUrl": "string",
      "thumbnailUrl": "string",
      "permalink": "string",
      "timestamp": "string",
      "username": "string",
      "likeCount": 0,
      "commentsCount": 0
    }
  ],
  "nextCursor": "string"
}

List the collaborators of an Instagram post

GET/v1/accounts/{accountId}/instagram/media/{mediaId}/collaborators

Works on: Instagram

Returns the accounts invited as collaborators on one of the connected account's own posts (feed image, Reel or carousel), with whether each invitation was accepted or is still pending. Use it to check who accepted a collab post after publishing it. Requires an Instagram account connected via Facebook Login. Meta serves this edge on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (instagram_collaborators_require_facebook_login) and must be reconnected choosing the Facebook option.

Path parameters

accountIdstringrequired

The ID of a connected Instagram account (Facebook Login).

mediaIdstringrequired

Instagram media ID of a post published by this account (digits only, e.g. the platformPostId of a published post).

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/instagram/media/18045678901234567/collaborators" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "id": "string",
      "username": "string",
      "inviteStatus": "accepted"
    }
  ]
}

Get a post that mentions an Instagram account in its caption

GET/v1/accounts/{accountId}/instagram/mentions/media/{mediaId}

Works on: Instagram

Returns a post in which another Instagram user @mentioned the connected account in the caption. Meta sends the media ID in its mention notification and offers no list of mentions, so this reads one mention by ID. Mentions in Stories are not supported by Meta. Requires an Instagram account connected via Facebook Login. Meta serves mentions on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (instagram_mentions_require_facebook_login) and must be reconnected choosing the Facebook option.

Path parameters

accountIdstringrequired

The ID of a connected Instagram account (Facebook Login).

mediaIdstringrequired

Instagram media ID of the post that mentions the account (digits only).

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/instagram/mentions/media/18045678901234567" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "id": "string",
  "caption": "string",
  "mediaType": "IMAGE",
  "mediaUrl": "string",
  "timestamp": "string",
  "username": "string",
  "likeCount": 0,
  "commentsCount": 0
}

Get a comment that mentions an Instagram account

GET/v1/accounts/{accountId}/instagram/mentions/comments/{commentId}

Works on: Instagram

Returns a comment in which another Instagram user @mentioned the connected account, with the post it was left on. Meta sends the comment ID in its mention notification and offers no list of mentions, so this reads one mention by ID. Meta answers an error when comments are disabled on that post. ### Requires Facebook Login The Instagram account must be connected via Facebook Login. Meta serves mentions on graph.facebook.com only. Accounts connected with classic Instagram Login receive a 400 (instagram_mentions_require_facebook_login) and must be reconnected choosing the Facebook option.

Path parameters

accountIdstringrequired

The ID of a connected Instagram account (Facebook Login).

commentIdstringrequired

Instagram comment ID of the comment that mentions the account (digits only).

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/instagram/mentions/comments/17958467203124567" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "id": "string",
  "text": "string",
  "timestamp": "string",
  "likeCount": 0,
  "media": {
    "id": "string"
  }
}