InsightSocial API
Facebook

Adlibrary › Ad

GET
/v1/facebook/adlibrary/ad

Returns one ad from the Facebook Ad Library: creative, CTA and link, run dates, display format, and the advertiser's page URL, likes and categories.

Use it when you have an ad id or URL. Spend and reach are political-ads-only, and Facebook publishes no per-ad impression count.

100 credits per call.

Re-running the exact same call within 6h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

id?string

Facebook Ad Library ad ID. Ad ids rotate as campaigns end, so take a current one from /v1/facebook/adlibrary/company/ads or /v1/facebook/adlibrary/search/ads rather than reusing an old one. Provide at least one of: id, url.

url?string

Facebook Ad Library URL for the ad (https://www.facebook.com/ads/library?id=...). A page URL is rejected with a 400. Provide at least one of: id, url.

trim?boolean

Set to true for a trimmed down version of the response

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/v1/facebook/adlibrary/ad"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Adlibrary › Ad › Transcript GET

Returns the spoken words of a Facebook Ad Library video ad, from Facebook's captions when available or transcribed from the video itself. Use it when you need what an ad says out loud; adlibrary/ad returns the creative and spend but not the speech. **200 credits** per call. Re-running the exact same call within 6h is free.

Adlibrary › Company › Ads GET

Returns the ads one company or page is running in the Facebook Ad Library, each with its creative, status, spend, and targeting info. Use it when you know the advertiser by pageId or company name; to find ads by keyword across advertisers, use adlibrary/search/ads. **100 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).