Advertiser object

2 endpoints on 2 platforms return the Advertiser object with the same 4 fields, so code written for one platform reads the others unchanged. A call costs $0.0020. It is a preview structure and may still change.

Preview object · Updated 2026-10-17Open in ChatGPTOpen in Claude

An Advertiser is who runs ads, as a platform's ad library knows them: a Facebook page in the Meta Ad Library, an advertiser in the Google Ads Transparency Center. It has an id and a name, with a picture on Meta and the region it is registered in on Google.

Its id goes unchanged to the advertiser's ads endpoint, which returns Ad items whose advertiser.id points back. It is not an Account: on Meta, the Facebook page's handle and the linked Instagram account are named under ext.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

ID; pass it unchanged to the advertiser's ads endpoint

name text

Name

avatar_url link standard

Picture or logo

region text

Code of the country or region the advertiser is registered in

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on
avatar_urlGoogle Ads
regionMeta Ad Library
One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Advertiser

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
Meta advertiser searchGET/v1/meta/advertisers/search$0.0020
Google advertiser searchGET/v1/google/advertisers/search$0.0020

Example

One item from meta.advertisers.search, as recorded 2026-10-12 21:44 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Advertiser · meta.advertisers.search
{
  "id": "109302004765630",
  "name": "Lumen Outdoor",
  "avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/487718865_122396809446085_n.jpg"
}

The whole response is on the endpoint's page →

Related

Other objects