Facebook Ad Library API — Advertiser Profile Lookup
Documentation menu
FetchLayer FetchLayer API

Get an advertiser's profile

Read an advertiser's public Ad Library profile: page name and alias, category, verification status, follower count, linked Instagram account and follower count, about text, and — for political pages — spend broken down by disclaimer.

POST /advertiser-profile Advertisers
https://api.fetchlayer.dev/facebook-ad-library/advertiser-profile
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

advertiser string required

Advertiser page id, Ad Library advertiser URL, or facebook.com page URL.

country string optional

Two-letter country code, or ALL.

Response Fields

advertiser-profile

Get an advertiser's profile

profile object

The advertiser’s public profile record.

profile.pageId string

Page id.

profile.pageName string

Public page name.

profile.pageCategory string

Category the page lists itself under.

profile.pageVerification string

Verification status of the page.

profile.likes number

Follower count.

profile.igUsername string

Linked Instagram handle, when the page has one.

profile.igFollowers number

Follower count on the linked Instagram account.

profile.isPoliticalPage boolean

Whether the page runs political or issue ads.

profile.spendByDisclaimer object[]

Political spend grouped by "paid for by" disclaimer.

Request

curl -X POST "https://api.fetchlayer.dev/facebook-ad-library/advertiser-profile" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"advertiser":"987654321"}'

Response

{
  "profile": {
    "pageId": "987654321",
    "pageName": "Acme Software",
    "pageCategory": "Software company",
    "likes": 120400,
    "igUsername": "acmesoftware",
    "isPoliticalPage": false
  }
}