GET /v1/ads/{ad_id}
One ad in full
One ad in full: Ad Library link, brand and shop, ad copy, format, dates, versions, EU reach history (Meta's total per read day; countries and age x gender as shares of Meta's breakdown), the verbatim script sentence by sentence with each sentence's section (Hook, Problem, Proof, Offer, CTA…, and who labelled it), change history and the source of every field. Costs 2 credits.
Cost: 2 credits per call. A call that returns nothing costs 0.
Parameters
Parameter Type What it does ad_id required string Meta Ad Library id
Errors 400A parameter is refused (the answer lists the accepted values). Not billed. 401Missing, unknown or revoked API key. 402Not enough credits for this call. Credits never expire; top up with a pack. 404Not in Poseidon. 429Too many requests for this key. Wait Retry-After seconds. Not billed. 503Server busy or a query took too long. Retry. Not billed.
Request
curl -s "https://api.askposeidon.app/v1/ads/862034243491035" \
-H "Authorization: Bearer $POSEIDON_API_KEY"Response
{
"data": {
"ad_id": "862034243491035",
"library_url": "https://www.facebook.com/ads/library/?id=862034243491035",
"brand": {
"page_id": "2218331548432159",
"name": "Epycure",
"shop_domain": "epycure.com",
"shop_url": "https://epycure.com",
"shop_platform": "shopify",
"niche_of_search": "weight loss"
},
"brand_shop_check": "confirmed e-commerce shop",
"format": "VIDEO",
"platforms": [
"FACEBOOK",
"INSTAGRAM"
],
"active": true,
"status_read_on": "2026-11-12",
"first_seen_on": "2026-11-11",
"start_date": "2026-03-08",
"days_live": 249,
"versions": 1,
"in_eu": true,
"landing_url": "https://epycure.com/products/boost-metabolisme",
"ad_copy": {
"body": "Imaginez-vous retrouver confiance en vous, prendre plaisir à manger équilibré et bouger votre corps pour prendre soin de votre santé, pas pour compenser vos écarts.\n\nLe Boost métabolisme a été spécialement formulé avec du Morosil® pour vous accompagner dans votre remise en forme en relançant votre métabolisme ralenti à cause des régimes restrictifs, en déstockant les graisses accumulées et en limitant les fringales pour une perte de poids saine et durable.\nLes résultats des études cliniques* parlent d’eux-mêmes :\n＋ Perte moyenne de 3 kg\n＋ Diminution de 7 cm de tour de taille\n＋ Diminution de 6 cm de tour de cuisse\n______\nMorosil® est une marque déposée de Bionap srl.\n*Efficacité prouvée dans 2 études cliniques menées en double aveugle avec placebo sur 60 volontaires (IMC compris entre 25 et 35 kg/m²) pendant 12 semaines, à la dose de 400 mg par jour.”",
"title": "Jusqu'à -7kg en 3 mois",
"cta": "Acheter"
},
"eu_reach": {
"label": "EU reach (Meta's total)",
"history": [
{
"day": "2026-11-12",
"total": 2766753,
"source": "Meta Ad Library (public ad page, read by Poseidon)"
}
],
"targeting_latest": {
"age_min": 18,
"age_max": 65,
"gender": "Women"
},
"country_share_history": {
"FR": [
{
"day": "2026-11-12",
"share_of_meta_breakdown": 1.0
}
]
},
"age_gender_share_latest": {
"day": "2026-11-12",
"note": "shares of Meta's age x gender breakdown of this read (all cells add up to 1), not numbers of people",
"rows": {
"FR": [
{
"age": "18-24",
"male_share": 0.0064,
"female_share": 0.1476,
"unknown_share": 0.0015
},
{
"age": "25-34",
"male_share": 0.0231,
"female_share": 0.4202,
"unknown_share": 0.003
}
]
}
}
},
"script": {
"media_type": "video",
"duration_s": 64.74538,
"language": "fr",
"transcribed_by": "speech-to-text (Whisper)",
"media_read_from": "Meta Ad Library (public ad page, read by Poseidon)",
"transcribed_on": "2026-11-12",
"sentences": [
{
"kind": "speech",
"n": 1,
"start_ms": 0,
"end_ms": 3280,
"text": "J'ai perdu 10 kilos en 3 mois, comment t'expliques que ça marche aussi bien ?",
"section": "Hook",
"labelled_by": "AI section labelling (Claude Fable)"
},
{
"kind": "speech",
"n": 2,
"start_ms": 3280,
"end_ms": 6040,
"text": "Mais en fait, on ne vend pas de rêve, on vend de la science.",
"section": "Proof",
"labelled_by": "AI section labelling (Claude Fable)"
},
{
"kind": "speech",
"n": 3,
"start_ms": 6040,
"end_ms": 12280,
"text": "Et c'est justement la force qu'on a chez Epicure Laboratoire, c'est de s'attacher à chaque fois à sélectionner des actifs qui ont fait l'objet d'études cliniques.",
"section": "Proof",
"labelled_by": "AI section labelling (Claude Fable)"
},
{
"kind": "speech",
"n": 4,
"start_ms": 12280,
"end_ms": 14480,
"text": "Donc là, par exemple, tu me parles du boost métabolisme.",
"section": "Product",
"labelled_by": "AI section labelling (Claude Fable)"
},
{
"kind": "speech",
"n": 5,
"start_ms": 14480,
"end_ms": 16480,
"text": "Il contient un actif phare qui est le morosil.",
"section": "Product",
"labelled_by": "AI section labelling (Claude Fable)"
},
{
"kind": "speech",
"n": 6,
"start_ms": 16480,
"end_ms": 25200,
"text": "Et c'est ce morosil qui a fait l'objet de plusieurs études cliniques qui ont prouvé l'efficacité de cet actif sur le déstockage de graisse et en particulier au niveau du ventre et des hanches.",
"section": "Proof",
"labelled_by": "AI section labelling (Claude Fable)"
}
]
},
"sources": [
{
"source": "Meta Ad Library (public ad page, read by Poseidon)",
"read_on": "2026-11-12",
"fields": [
"body",
"countries"
]
}
]
},
"meta": {
"endpoint": "get_ad",
"api_version": "1.1.0",
"credits_charged": 2,
"credits_left": 525,
"answered_at": "2026-11-12T22:11:37+00:00",
"coverage": "Ads delivered in the EU or UK only. The only number of people shown is Meta's EU total reach (eu_reach, \"EU reach (Meta's total)\"), as read on the date shown. Meta publishes no spend or impressions for commercial ads. Countries, ages and genders are shown only as shares of Meta's age x gender breakdown of the same read, never as numbers of people: Meta's breakdown rows do not add up to its EU total (measured 0.93x to 1.10x on 3,820 reads), so a country figure in people would not be a fact."
}
}