# Advertiser ads API 2 endpoints on 2 platforms return the same Ad object. The ads one advertiser has run. Every call costs $0.0020; a failed call is free. ## Advertiser ads on each platform | Platform | Endpoint | Path | A page | Returns | Price | | --- | --- | --- | --- | --- | --- | | Google Ads | [Google advertiser's ads](https://dataxapi.com/apis/google/advertisers/ads/list.md) | `GET /v1/google/advertisers/ads/list` | 40 | Ad list | $0.0020 / call | | Meta Ad Library | [Meta advertiser's ads](https://dataxapi.com/apis/meta/advertisers/ads/list.md) | `GET /v1/meta/advertisers/ads/list` | 30 | Ad list | $0.0020 / call | Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing. ## The Ad object Every endpoint above returns these fields, with the same names and types. | Field | Type | Description | | --- | --- | --- | | `id` | text | ID; pass it unchanged to the ad's get endpoint | | `url` | link | The ad's page in the platform's ad library | | `format` | text | Format of the creative; other is a format of the platform's own | | `title` | text | Headline | | `text` | text | Body text | | `landing_url` | link | Where a click on the ad leads | | `advertiser.id` | text | Advertiser ID | | `advertiser.name` | text | Advertiser's name | | `advertiser.url` | link | The advertiser's page on the platform | | `advertiser.avatar_url` | link | The advertiser's picture or logo | | `images` | list of link | Addresses of the ad's images | | `videos` | list of link | Addresses of the ad's videos; they expire | | `first_shown_at` | time | When the ad was first shown | | `last_shown_at` | time | When the ad was last shown; for an ad still running, when the platform last saw it | [The object's own page →](https://dataxapi.com/docs/objects/ad/) ### Which platform fills which field A field an endpoint cannot give is listed in `meta.unavailable` on every answer, so a gap is never a surprise. | Platform | `title` | `text` | `landing_url` | `advertiser.url` | `advertiser.avatar_url` | `videos` | | --- | --- | --- | --- | --- | --- | --- | | Google Ads | not available | not available | not available | not available | not available | not available | | Meta Ad Library | available | available | available | available | available | available | ## The same call on two platforms Same parameter names, same paging, same answer. Only the path changes. ```bash # Google Ads curl -G "https://api.dataxapi.com/v1/google/advertisers/ads/list" \ --data-urlencode "id=AR16735076323512287233" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" # Meta Ad Library: one word changes curl -G "https://api.dataxapi.com/v1/meta/advertisers/ads/list" \ --data-urlencode "id=182162001806727" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" ``` ### 200 · application/json Google advertiser's ads: From a response recorded 2026-10-12 21:59 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up. ```jsonc { "code": "ok", "request_id": "b9918ef3-6208-4850-af75-8aeda3dd491a", "data": { "items": [ { "id": "AR14547762939695648498/CR16461126525097854516", "url": "https://adstransparency.google.com/advertiser/AR14547762939695648498/creative/CR16461126525097854516", "format": "image", "advertiser": { "id": "AR15686017776974616421", "name": "Lumen Outdoor" }, "images": [], "first_shown_at": "2023-07-11T16:20:02.000Z", "last_shown_at": "2026-10-12T21:35:00.000Z" }, // … 39 more ] }, "page": { "next_cursor": "c1.1CWjCp9ZBAq_fgH7qoredLVGrA5b_HMkWHgRd8A0", "cursor_expires_at": "2026-10-12T22:59:05.000Z", "has_more": true, "returned": 40 }, "warnings": [], "meta": { "capability": "google.advertisers.ads.list", "result_status": "complete", "fetched_at": "2026-10-12T21:59:05.000Z", "cached": false, "replayed": false, "unavailable": { "title": "capability", "text": "capability", "landing_url": "capability", "advertiser.url": "platform", "advertiser.avatar_url": "platform", "videos": "capability" }, "billing": { "amount": "0.002", "currency": "USD", "balance_after": "9.998" } } } ``` ## What comes back - [The Ad object](https://dataxapi.com/docs/objects/ad/): Fields 14, Endpoints that return it 11, Platforms 4 ## Questions about the Advertiser ads API ### How much does it cost? $0.0020 a call on Google Ads, Meta Ad Library. You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum. ### How do I get every page? Pass `page.next_cursor` back as `cursor` until `page.has_more` is false. Each page is one call at the same price. ### Does every platform fill every field? No. 6 of the 14 fields are missing on at least one platform; the table on this page says which. A field an endpoint cannot give is named in `meta.unavailable` on every answer, never filled with a guess. ### Do I need an account on the platform? No. One DataXAPI key reads all 2 platforms. No platform account and no cookie. ## Other data types [Comment replies API](https://dataxapi.com/roles/comments-replies-list/), [Hashtag posts API](https://dataxapi.com/roles/topics-posts-list/), [Trending topics API](https://dataxapi.com/roles/trends-list/), [Account profile API](https://dataxapi.com/roles/accounts-get/), [Account posts API](https://dataxapi.com/roles/accounts-posts-list/), [Comments API](https://dataxapi.com/roles/posts-comments-list/), [Post detail API](https://dataxapi.com/roles/posts-get/), [Post search API](https://dataxapi.com/roles/posts-search/), [Trending posts API](https://dataxapi.com/roles/posts-trending/), [Account search API](https://dataxapi.com/roles/accounts-search/), [Post metrics API](https://dataxapi.com/roles/posts-metrics/), [Community posts API](https://dataxapi.com/roles/communities-posts-list/), [Ad detail API](https://dataxapi.com/roles/ads-get/), [Advertiser search API](https://dataxapi.com/roles/advertisers-search/), [Ad library search API](https://dataxapi.com/roles/ads-search/), [Video transcript API](https://dataxapi.com/roles/transcripts-get/), [Followers API](https://dataxapi.com/roles/accounts-followers-list/), [Community profile API](https://dataxapi.com/roles/communities-get/), [Product detail API](https://dataxapi.com/roles/products-get/), [Product reviews API](https://dataxapi.com/roles/products-reviews-list/), [Product search API](https://dataxapi.com/roles/products-search/), [Creator search API](https://dataxapi.com/roles/creators-search/), [Creator profile API](https://dataxapi.com/roles/creators-get/), [Creator audience API](https://dataxapi.com/roles/creators-audience-get/), [Creator metrics API](https://dataxapi.com/roles/creators-metrics/), [Creator posts API](https://dataxapi.com/roles/creators-posts-list/), [All 21 platforms →](https://dataxapi.com/apis/) --- Last checked 2026-10-21 11:10 UTC. Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/roles/advertisers-ads-list/)