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.

50 credits per call.

get/v1/facebook/adlibrary/ad

Request

Base URL: https://api.insightsocial.app
URL: https://api.insightsocial.app/v1/facebook/adlibrary/ad
Auth: API key in header x-api-key

Query parameters

idstring

Example:1702938977100376

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.

urlstring

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.

trimboolean

Set to true for a lighter record with fewer fields.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required

platformstring required

endpointstring required

schema_version'2' required

unavailablestring[] required

credits_usedinteger required

credits_remaininginteger required

request_idstring required

cachedboolean required

idempotent_replayboolean required

charge_reasonstring required

free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.