An advertiser's public Ad Library profile: page name and alias, category, verification, follower count, linked Instagram account and its followers, about text, and political spend 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 (5–17 digits), Ad Library advertiser URL, facebook.com/<username> page URL, the page’s username with or without @ (even when it differs from the page’s name), or its full name. A page id of any other length, such as 20 digits, is a 400; a well-formed id that matches no advertiser is a 404. A URL or handle names that exact page. A name must be the page’s own username or full name (ignoring case and punctuation) — a page that merely contains it is not used; no match is a 404, and a name several pages share is a 400 listing their page ids. The page id is fastest and exact.

country string optional

Two-letter country code, or ALL.

format string optional

json or markdown, lowercase; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON. (default: json)

timeoutMs integer optional

Time limit for the whole request, in milliseconds (1000–120000), counted from its arrival, time spent waiting in the queue included; a value outside that range is a 400. When it runs out, a paged request returns what it has with nextCursor and a note, billed for the pages it delivered; a request with nothing to return yet fails with a 503 you can retry, marked with the response header X-Timeout-Source: caller. Left out, the request runs as long as it needs.

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 | null

Public page name.

profile.pageCategory string | null

Category the page lists itself under.

profile.pageVerification string | null

Verification status of the page.

profile.likes integer | null

Follower count.

profile.igUsername string | null

Linked Instagram handle; null when the page has none.

profile.igFollowers integer | null

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":"15087023444"}'

Response

{
  "profile": {
    "pageId": "15087023444",
    "pageName": "Nike",
    "pageCategory": "Sportswear Store",
    "pageVerification": "BLUE_VERIFIED",
    "likes": 39536847,
    "igUsername": "nike",
    "igFollowers": 291207857,
    "isPoliticalPage": false
  }
}

{
  "error": "Invalid API key"
}