Skip to main content
New

The YouTube API is live.

Try it

Facebook Ad Library data API.

Search Ad Library ads, open an ad or advertiser, and read political ad reports through 9 documented endpoints.

  • 100 free API credits included
  • No payment card required
  • Failed requests cost 0 credits
GETapi.tapline.sh/v1/facebook/ad-library/ads
1
{
2
  "ads": [
3
    {
4
      "ad_archive_id": "1702938977100376",
5
      "ad_id": null,
6
      "text": {
7
        "title": "{{product.name}}",
8
        "body": "Bring sports more fully into your day with the Nike App.",
9
        "caption": "itunes.apple.com",
10
        "link_description": null,
11
        "extra_texts": []
12
      },
13
      "url": "https://www.facebook.com/ads/library/?id=1702938977100376",
14
      "page": {
15
        "page_id": "15087023444",
16
        "profile_id": null,
17
        "username": null,
18
        "name": "Nike",
19
        "url": "https://www.facebook.com/nike/",
20
        "metrics": {
21
          "like_count": 39496334,
22
          "follower_count": null,
23
          "talking_about_count": null
24
        },
25
        "status": {
26
          "is_deleted": false
27
        },
28
        "instagram": null,
29
        "category": "Sportswear, Product/service",
30
        "entity_type": {
31
          "code": null,
32
          "label": null
33
        },
34
        "verification": {
35
          "code": null,
36
          "label": null
37
        },
38
        "profile_picture_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.35426-6/431756959_712871054375981_2401799800446082357_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zSpeVOwljsQQ7kNvwGcxpTD&_nc_oc=AdoCY9PdFahUsdb1QQHE4AKcIQ9ekyUKODlPKd2LFz0K9KWHl1O_8QLanOENl5USabA&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQN4un47gp2wgMlJEm3m7Eff-xdqusV66R8BOYVfgZuoaQ&oe=6AE42EC6"
39
      },
40
      "regulation": {
41
        "brazil_tax_id": null,
42
        "is_financial_services_ad": false,
43
        "has_limited_financial_delivery": false,
44
        "has_limited_taiwan_anti_scam_delivery": false,
45
        "country_iso_code": null,
46
        "eu_certificates": [],
47
        "additional_info": null
48
      },
49
      "collation": {
50
        "id": null,
51
        "count": null
52
      },
53
      "categories": [
54
        {
55
          "code": "UNKNOWN",
56
          "label": "Uncategorized"
57
        }
58
      ],
59
      "disclaimer": {
60
        "type": {
61
          "code": null,
62
          "label": null
63
        },
64
        "paid_for_by": null,
65
        "verification": null
66
      },
67
      "creative": {
68
        "link_url": "http://itunes.apple.com/app/id1095459556",
69
        "extra_links": [],
70
        "branded_content": null,
71
        "display_format": {
72
          "code": "DPA",
73
          "label": "Dynamic product ad"
74
        },
75
        "cta_type": {
76
          "code": "INSTALL_MOBILE_APP",
77
          "label": "Install now"
78
        },
79
        "cards": [
80
          {
81
            "title": "Cosmic Unity 3 Basketball Shoes",
82
            "body": "Bring sports more fully into your day with the Nike App.",
83
            "caption": "itunes.apple.com",
84
            "link_description": "₱5,039",
85
            "link_url": "https://www.nike.com/ph/t/cosmic-unity-3-basketball-shoes-hcwmW0/DV2757-100",
86
            "cta_type": {
87
              "code": "INSTALL_MOBILE_APP",
88
              "label": "Install Now"
89
            },
90
            "image": {
91
              "original_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.35426-6/431644642_737508601479774_8272309847273720820_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=4dc0foVgD-8Q7kNvwFlCrxp&_nc_oc=Adqeoyb_P1A0JDyFYSEbzoPavHeHlLF9Of4SbycqAaSnwvLDB6FFbfm0DNFoWHA36oE&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQMLesen6ytvb96rRXelATeeXCzudzN1ganygDJkv3T2XA&oe=6AE42CC3",
92
              "resized_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.35426-6/431644642_737508601479774_8272309847273720820_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=4dc0foVgD-8Q7kNvwFlCrxp&_nc_oc=Adqeoyb_P1A0JDyFYSEbzoPavHeHlLF9Of4SbycqAaSnwvLDB6FFbfm0DNFoWHA36oE&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQPgnxbDAfhlwFpvDwIkH3w6uzCJqpki8ByLxthotMNJMg&oe=6AE42CC3",
93
              "watermarked_resized_url": null,
94
              "crops": []
95
            },
96
            "video": null
97
          },
98
          {
99
            "title": "Nike Run Swift 3 Women's Road Running Shoes",
100
            "body": "Bring sports more fully into your day with the Nike App.",
101
            "caption": "itunes.apple.com",
102
            "link_description": "₱3,995",
103
            "link_url": "https://www.nike.com/ph/t/run-swift-3-road-running-shoes-2fHbzp/DR2698-002",
104
            "cta_type": {
105
              "code": "INSTALL_MOBILE_APP",
106
              "label": "Install Now"
107
            },
108
            "image": {
109
              "original_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/431679131_949214166636263_7090981238489979310_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=vZxSPZnd-gkQ7kNvwGePyKg&_nc_oc=Adp4d3ZMrLrDPrp06Fyv5voZFjuB3ptY-AtvTBfeqMvFML09wukd62ViL_2kphNuxD4&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQPpbsrIrvWWcr9hX5ZWRkGFziDJjP2VoZmjPkkQlDJgbQ&oe=6AE44211",
110
              "resized_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/431679131_949214166636263_7090981238489979310_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=vZxSPZnd-gkQ7kNvwGePyKg&_nc_oc=Adp4d3ZMrLrDPrp06Fyv5voZFjuB3ptY-AtvTBfeqMvFML09wukd62ViL_2kphNuxD4&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQPcp81WqdPmtFe-kRI_TblAs9hElbu0ZCZRWCXMUht0YQ&oe=6AE44211",
111
              "watermarked_resized_url": null,
112
              "crops": []
113
            },
114
            "video": null
115
          }
116
        ],
117
        "is_reshared": false,
118
        "root_reshared_post": null,
119
        "event": null,
120
        "images": [],
121
        "extra_images": [],
122
        "videos": [],
123
        "extra_videos": []
124
      },
125
      "performance": {
126
        "spend": null,
127
        "impressions": null,
128
        "reach": null,
129
        "impressions_bucket": null
130
      },
131
      "delivery": {
132
        "total_active_seconds": null,
133
        "is_active": true,
134
        "start_at": "2025-04-07T07:00:00Z",
135
        "end_at": null,
136
        "last_seen_at": "2026-10-25T07:00:00Z",
137
        "publisher_platforms": [
138
          {
139
            "code": "FACEBOOK",
140
            "label": "Facebook"
141
          },
142
          {
143
            "code": "INSTAGRAM",
144
            "label": "Instagram"
145
          }
146
        ],
147
        "targeted_or_reached_countries": []
148
      },
149
      "moderation": {
150
        "report_count": null,
151
        "hide_data_status": {
152
          "code": "NONE",
153
          "label": "All data shown"
154
        },
155
        "gated_type": {
156
          "code": "ELIGIBLE",
157
          "label": "Shown"
158
        },
159
        "is_eligible_for_beneficiary_payer_disclosure": false,
160
        "contains_sensitive_content": false,
161
        "state_media_label": null,
162
        "contains_digital_created_media": false
163
      }
164
    },
165
    {
166
      "ad_archive_id": "1559738104701476",
167
      "ad_id": null,
168
      "text": {
169
        "title": "{{product.name}}",
170
        "body": "Encuentra tu mejor estilo.
Llegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
171
        "caption": "play.google.com",
172
        "link_description": null,
173
        "extra_texts": []
174
      },
175
      "url": "https://www.facebook.com/ads/library/?id=1559738104701476",
176
      "page": {
177
        "page_id": "15087023444",
178
        "profile_id": null,
179
        "username": null,
180
        "name": "Nike",
181
        "url": "https://www.facebook.com/nike/",
182
        "metrics": {
183
          "like_count": 39496334,
184
          "follower_count": null,
185
          "talking_about_count": null
186
        },
187
        "status": {
188
          "is_deleted": false
189
        },
190
        "instagram": null,
191
        "category": "Sportswear, Product/service",
192
        "entity_type": {
193
          "code": null,
194
          "label": null
195
        },
196
        "verification": {
197
          "code": null,
198
          "label": null
199
        },
200
        "profile_picture_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/400027547_358739853502630_8144226094621458298_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=a5xDOKxdyVcQ7kNvwFRKkuT&_nc_oc=AdokXp2PeFpMeG7vJp142_AfwRrMideICklPzyTjkqQw3n6Jo9Swa963QZK47Bate7U&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQMZrFrXeWk6rNaB_kzLhrVtOgHuAy6bclucGZuN8phNdw&oe=6AE457B7"
201
      },
202
      "regulation": {
203
        "brazil_tax_id": null,
204
        "is_financial_services_ad": false,
205
        "has_limited_financial_delivery": false,
206
        "has_limited_taiwan_anti_scam_delivery": false,
207
        "country_iso_code": null,
208
        "eu_certificates": [],
209
        "additional_info": null
210
      },
211
      "collation": {
212
        "id": null,
213
        "count": null
214
      },
215
      "categories": [
216
        {
217
          "code": "UNKNOWN",
218
          "label": "Uncategorized"
219
        }
220
      ],
221
      "disclaimer": {
222
        "type": {
223
          "code": null,
224
          "label": null
225
        },
226
        "paid_for_by": null,
227
        "verification": null
228
      },
229
      "creative": {
230
        "link_url": "http://play.google.com/store/apps/details?id=com.nike.omega",
231
        "extra_links": [],
232
        "branded_content": null,
233
        "display_format": {
234
          "code": "DPA",
235
          "label": "Dynamic product ad"
236
        },
237
        "cta_type": {
238
          "code": "INSTALL_MOBILE_APP",
239
          "label": "Install now"
240
        },
241
        "cards": [
242
          {
243
            "title": "Camiseta de tirantes estampada cropped para mujer Nike Dri-FIT One - Negro",
244
            "body": "Encuentra tu mejor estilo.
Llegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
245
            "caption": "play.google.com",
246
            "link_description": "$584",
247
            "link_url": "https://www.nike.com/mx/t/camiseta-de-tirantes-estampada-cropped-dri-fit-one-Rbwdbp?cp=54413048966_soc_",
248
            "cta_type": {
249
              "code": "INSTALL_MOBILE_APP",
250
              "label": "Install Now"
251
            },
252
            "image": {
253
              "original_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/399930460_249559881434186_1655395527070305162_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Tdcp-_KTho4Q7kNvwGrqR81&_nc_oc=AdpOEymJTX7xfcdmruVB9OFfTfpObTDoop1tC-PULnlp8XB5zxAwiuodgp7WZ3mQZs0&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQM2BCjV1NmzfC2Gv3yXD8dSY2FQmnov219TwtZhmMVT9w&oe=6AE42BC4",
254
              "resized_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/399930460_249559881434186_1655395527070305162_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Tdcp-_KTho4Q7kNvwGrqR81&_nc_oc=AdpOEymJTX7xfcdmruVB9OFfTfpObTDoop1tC-PULnlp8XB5zxAwiuodgp7WZ3mQZs0&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQPcvf7fsB3LPA63G-oyNphdGHGpEohRFtFWd0cBE_YzOA&oe=6AE42BC4",
255
              "watermarked_resized_url": null,
256
              "crops": []
257
            },
258
            "video": null
259
          },
260
          {
261
            "title": "Shorts Dri-FIT de 18 cm versátiles sin forro para hombre Nike Form - Negro",
262
            "body": "Encuentra tu mejor estilo.
Llegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
263
            "caption": "play.google.com",
264
            "link_description": "$854",
265
            "link_url": "https://www.nike.com/mx/t/shorts-dri-fit-de-18-900-versátiles-sin-forro-form-1Kl48s?cp=54413048966_soc_",
266
            "cta_type": {
267
              "code": "INSTALL_MOBILE_APP",
268
              "label": "Install Now"
269
            },
270
            "image": {
271
              "original_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/399960590_1003889420725694_6884301960231990928_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=WunkeakHfWAQ7kNvwH3ggpj&_nc_oc=Adpq2NqFdwCszOs7u12GF35n-myhusOW3OIQdBNuGSMbMLGL_qxcc6jsRYB-CVko84o&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQMe91hifQ1RqLFuGphQueMupPVvzcJO70H9sLmyD5I8HA&oe=6AE44E91",
272
              "resized_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.35426-6/399960590_1003889420725694_6884301960231990928_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=WunkeakHfWAQ7kNvwH3ggpj&_nc_oc=Adpq2NqFdwCszOs7u12GF35n-myhusOW3OIQdBNuGSMbMLGL_qxcc6jsRYB-CVko84o&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=bJ3oSSrrrJTCXLfxtR8KTQ&_nc_ss=7b180&oh=00_AQNqy9F6_AHTa1yHquCvUPMFAIS5BRNe-BRfwWr2k_krLg&oe=6AE44E91",
273
              "watermarked_resized_url": null,
274
              "crops": []
275
            },
276
            "video": null
277
          }
278
        ],
279
        "is_reshared": false,
280
        "root_reshared_post": null,
281
        "event": null,
282
        "images": [],
283
        "extra_images": [],
284
        "videos": [],
285
        "extra_videos": []
286
      },
287
      "performance": {
288
        "spend": null,
289
        "impressions": null,
290
        "reach": null,
291
        "impressions_bucket": null
292
      },
293
      "delivery": {
294
        "total_active_seconds": null,
295
        "is_active": true,
296
        "start_at": "2025-04-25T07:00:00Z",
297
        "end_at": null,
298
        "last_seen_at": "2026-10-25T07:00:00Z",
299
        "publisher_platforms": [
300
          {
301
            "code": "FACEBOOK",
302
            "label": "Facebook"
303
          },
304
          {
305
            "code": "INSTAGRAM",
306
            "label": "Instagram"
307
          }
308
        ],
309
        "targeted_or_reached_countries": []
310
      },
311
      "moderation": {
312
        "report_count": null,
313
        "hide_data_status": {
314
          "code": "NONE",
315
          "label": "All data shown"
316
        },
317
        "gated_type": {
318
          "code": "ELIGIBLE",
319
          "label": "Shown"
320
        },
321
        "is_eligible_for_beneficiary_payer_disclosure": false,
322
        "contains_sensitive_content": false,
323
        "state_media_label": null,
324
        "contains_digital_created_media": false
325
      }
326
    }
327
  ],
328
  "pagination": {
329
    "next_cursor": "eyJ2IjoxLCJyIjoic2FtcGxlIiwiYiI6IjRmNTNjZGExOGMyYmFhMGMiLCJhIjoiQVFIVHpGejZaaEV6MlZRaWlqMVJlVDI0RUFiR0pLSWlwYWxWRXZkM0Zxd1RJbFFzZDJRRmxzRnZyTWtIODlVYUVMNk8ifQ",
330
    "has_more": true
331
  }
332
}

Facebook Ad Library API endpoints.

Search ads by keyword or advertiser, then open an ad, its versions, or the advertiser behind it.

GETAd Search3 credits
GETAd Details3 credits
GETAd Transparency3 credits
GETAd Versions3 credits
GETAdvertiser Search3 credits
GETAdvertiser Profile3 credits
GETAdvertiser Audience3 credits
GETAd Library Report3 credits
GETReport Advertisers3 credits

Facebook Ad Library live demo.

Run a live request. No account or API key needed.

Ad Search
Ads·Advertisers

Live Ad Library data · 5 free runs per operation each day

Ad Search

Use Run to run this request against the live Facebook Ad Library. No API key needed.

Run a request to fetch a live response.
03Pricing

Start free.
Scale when you need to.

Use one credit pool across every live Tapline API. Upgrade only when you need more requests or a higher rate limit.

 

Free

$0
No card required
100 API credits
All endpointsNo charge for failed requests1 req/s
 

Pay As You Go

$9
one-time payment
From 5,000 credits
All endpointsCredits never expire5 req/s
Buy credits
 

Starter

$39
/ month
billed $468/yrSave $120/yr
100,000 credits/mo
All endpointsEmail support5 req/s
 

Enterprise

Custom
Priced to your workload
More than 4,000,000 credits/mo
Higher rate limitsCustom endpointsAnnual contracts
Talk to us

Facebook Ad Library API questions.

Yes. The live demo above needs no account or API key. You can run each operation up to five times per day and inspect the same response shape your integration receives.

Ten ads per page for a keyword or one advertiser, with the ad text, creative, call to action, platforms, and delivery dates. Filter by country, status, ad category, media type, platform, language, and delivery dates.

An ad's creative and delivery dates, who paid for it, every version that ran under one creative, and an advertiser's profile with its first page of active ads. The audience endpoint shows how an advertiser targeted its political and issue ads.

A country's political and issue ad totals, top advertisers, and spend by location for a period. Without a date you get the newest published day. The advertisers endpoint lists everyone in the report with their spend and ad count.

List endpoints return pagination.next_cursor. Send it back as cursor with the same inputs for the next page.

3 credits for every endpoint. Credits are charged when Tapline reaches the target and receives a valid response about the requested resource. This includes responses showing that the resource is private, restricted, unavailable, or does not exist. Requests that fail because Tapline is blocked by the target, times out, or encounters an internal error cost 0 credits. New accounts include 100 free credits.

No. Tapline is not affiliated with, endorsed by, or sponsored by Facebook or Meta.

Get started

Start with Facebook Ad Library data.

Try the live demo. Sign up for 100 free credits when you are ready.