Inbox · Instagram
Returns the posts an Instagram account is tagged in, one page at a time.
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the analytics resource group disabled get 403 resource_group_disabled. Authentication
Path parameters
| Name | Type | Notes |
|---|---|---|
accountIdrequired | string |
Query parameters
| Name | Type | Notes |
|---|---|---|
limit | integer | Default 251 to 50 |
cursor | string | Up to 1000 characters |
Example
curl -X GET "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/tags?limit=25" \
-H "Authorization: Bearer $POZY_API_KEY"const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/tags?limit=25", {
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/tags",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
params={
"limit": 25,
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
dataarray of objectrequired11 child fields
idstringrequiredcaptionstringrequiredCan be null.
mediaTypestringrequiredCan be null.
mediaProductTypestringrequiredCan be null.
mediaUrlstringrequiredCan be null.
thumbnailUrlstringrequiredCan be null.
permalinkstringrequiredCan be null.
timestampstringrequiredCan be null.
usernamestringrequiredCan be null.
likeCountintegerrequiredCan be null.
commentsCountintegerrequiredCan be null.
nextCursorstringrequiredCan be null.
200 response
{
"data": [
{
"id": "6bfebd43ddc270f6d2c56fc5",
"caption": "Hello from Pozy",
"mediaType": "string",
"mediaProductType": "string",
"mediaUrl": "https://pozy.ai/media/example-1.jpg",
"thumbnailUrl": "https://pozy.ai/media/example-1.jpg",
"permalink": "string",
"timestamp": "2026-10-02T09:00:00.000Z",
"username": "acme",
"likeCount": 42,
"commentsCount": 42
}
],
"nextCursor": "string"
}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 storiesGETGet Instagram publishing limitGETSearch Instagram audioGETGet Instagram audio metadataGETLook up a public Instagram Business accountGETList the collaborators of an Instagram postGETList the live broadcasts of an Instagram accountGETGet a post that mentions an Instagram account in its captionGETGet a comment that mentions an Instagram accountGETGet Instagram story insights