Ads · Ad Accounts
Returns comments on an ad, one page at a time. Works with Meta Ads and TikTok Ads.
GET
https://api.pozy.ai/v1/ads/{adId}/commentsFacebook and Instagram and TikTokgetAdComments
Guides: Meta Ads, TikTok Ads
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 |
|---|---|---|
adIdrequired | string |
Query parameters
| Name | Type | Notes |
|---|---|---|
placement | string | One of facebook, instagram |
limit | integer | Default 251 to 100 |
since | string (date) | |
until | string (date) | |
cursor | string |
Example
curl -X GET "https://api.pozy.ai/v1/ads/6f40fa2fb0a7e728dd1a73b7/comments?limit=25" \
-H "Authorization: Bearer $POZY_API_KEY"const res = await fetch("https://api.pozy.ai/v1/ads/6f40fa2fb0a7e728dd1a73b7/comments?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/ads/6f40fa2fb0a7e728dd1a73b7/comments",
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
statusstringrequiredOne of
success.commentsarray of objectrequiredpaginationobjectrequiredhasMorebooleancursorstring
metaobjectrequired14 child fields
platformstringrequiredOne of
facebook,instagram,tiktok.placementstringOne of
facebook,instagram.adIdstringrequiredplatformAdIdstringeffectiveStoryIdstringtiktokItemIdstringCan be null.
sincestring (date)untilstring (date)facebookAccountIdstringCan be null.
instagramUserIdstringinstagramPermalinkstringinstagramAccountIdstringaccountIdstringrequiredlastUpdatedstring (date-time)required
200 response
{
"status": "success",
"comments": [
{}
],
"pagination": {
"hasMore": true,
"cursor": "string"
},
"meta": {
"platform": "facebook",
"placement": "facebook",
"adId": "6f40fa2fb0a7e728dd1a73b7",
"platformAdId": "64149c3e561c1c5ac800f87a",
"effectiveStoryId": "6f34cc4206080764d84040a4",
"tiktokItemId": "6194c6395799073f3c47a197",
"since": "2026-10-01",
"until": "2026-10-01",
"facebookAccountId": "6f0d7b312e6dab1ad6b6ee17",
"instagramUserId": "665a608ca13236ff56e25aae",
"instagramPermalink": "string",
"instagramAccountId": "6854a8d52899647077038bdb",
"accountId": "696e0b682d0a31188e7a2ba9",
"lastUpdated": "2026-10-02T09:00:00.000Z"
}
}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 Ad Accounts
POSTReply to an ad commentPOSTHide or unhide an ad commentDELDelete an ad commentGETList TikTok Business CentersGETAd account change / audit logGETA/B tests and lift studiesGETList Instagram ad identitiesGETList Instagram posts to boostGETList advertisable appsGETGet iOS 14 campaign limitsGETBusinesses listGETBusiness usersGETPage users of a businessPOSTAssign a user to a PageDELRemove a user from a PageGETList ad labelsPOSTCreate a Google Ads labelPATCHUpdate a Google Ads labelDELRemove a Google Ads labelPOSTAttach a Google Ads labelDELDetach a Google Ads labelGETList high-demand periodsPOSTSchedule a budget increaseGETList value rule setsPOSTCreate a value rule setGETRead a value rule setPUTReplace a value rule setDELDelete a value rule setGETList negative keyword listsPOSTCreate a negative keyword listGETGet a negative keyword listPUTRename a negative keyword listDELDelete a negative keyword listPUTReplace negative list keywordsGETList account calloutsPOSTAdd account calloutsPUTUpdate account calloutsDELRemove account calloutGETList account sitelinksPOSTAdd account sitelinksPUTUpdate account sitelinksDELRemove account sitelinkGETList account snippetsPOSTAdd account snippetsPUTUpdate account snippetsDELRemove account snippetGETGet manager account hierarchyPOSTInvite a client account to a managerPATCHAccept, decline, cancel or end a manager linkGETGet ad account billingPOSTSet up ad account billing (monthly invoicing)GETList user access invitationsPOSTInvite a user to an ad account by emailDELRevoke a user access invitationGETList invitations awaiting multi-party approvalDELWithdraw an invitation awaiting multi-party approvalGETAd account usersPOSTAssign a user to an ad accountDELRemove a user from an ad accountGETAd account financesGETCheck an ad account before creating adsGETRead an ad account's campaigns and ad sets liveGETList ad accountsPOSTCreate ad accountPATCHUpdate ad account settingsGETGet ad account DSA defaultsGETGet DSA recommendationsGETList custom conversionsPOSTCreate custom conversionGETList TikTok ad pixels