Inbox · Instagram

Get a post that mentions an Instagram account in its caption

Fetches a post that mentions an Instagram account in its caption.

GEThttps://api.pozy.ai/v1/accounts/{accountId}/instagram/mentions/media/{mediaId}

getInstagramMentionedMedia

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the engagement resource group disabled get 403 resource_group_disabled. Authentication

Path parameters

Name	Type	Notes
`accountId`required	string
`mediaId`required	string	Up to 32 charactersMatches `^[0-9]+$`

Example

curl -X GET "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/mentions/media/69eaa09f981d518a7e5ab560" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/mentions/media/69eaa09f981d518a7e5ab560", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/mentions/media/69eaa09f981d518a7e5ab560",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

Response

200 on success

idstringrequired
captionstringrequired
Can be null.
mediaTypestringrequired
Can be null.
mediaUrlstringrequired
Can be null.
timestampstringrequired
Can be null.
usernamestringrequired
Can be null.
likeCountintegerrequired
Can be null.
commentsCountintegerrequired
Can be null.

200 response

{
  "id": "6bfebd43ddc270f6d2c56fc5",
  "caption": "Hello from Pozy",
  "mediaType": "string",
  "mediaUrl": "https://pozy.ai/media/example-1.jpg",
  "timestamp": "2026-10-02T09:00:00.000Z",
  "username": "acme",
  "likeCount": 42,
  "commentsCount": 42
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400	invalid_request_error	A parameter or body field is missing or invalid. `param` names it.
401	authentication_error	The API key is missing, revoked or expired.
403	permission_error	The key is scoped to other profiles or has this resource group disabled.
404	not_found	Nothing with that id exists in your workspace.
429	rate_limit_error	Too many requests this minute. Wait for `Retry-After` seconds.

Every code is listed in Errors.

More in Instagram

GETList active Instagram stories GETGet Instagram publishing limit GETSearch Instagram audio GETGet Instagram audio metadata GETLook up a public Instagram Business account GETList the collaborators of an Instagram post GETList the live broadcasts of an Instagram account GETList the posts an Instagram account is tagged in GETGet a comment that mentions an Instagram account GETGet Instagram story insights