GET /v1/experiments
Brands' own A/B tests
Brands' own A/B tests: ads of one brand launched within 14 days that share one element and differ in another (same video with different ad texts, same text with different videos, same script with a different hook). Each variant: its ads with Ad Library links, launch day, active or stopped, days live and EU reach (Meta's total) with read date, plus the text that differs. The outcome is measured (a variant still running while another stopped, or 2x+ the reach), and absent when nothing is clear yet. Costs 5 credits (0 if nothing matches).
Cost: 5 credits per call. A call that returns nothing costs 0.
Parameters
Parameter Type What it does nichestring niche of the keyword search that found the brand (see filters) countrystring 2-letter code: groups with at least one ad reaching that country kindstring: same_video_other_text, same_text_other_video, same_body_other_hook with_outcomeboolean true = only tests with a measured winner limitinteger default 10 Min 1. Max 20. offsetinteger Min 0. Max 1000.
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. 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/experiments?niche=weight%20loss&with_outcome=true&limit=2" \
-H "Authorization: Bearer $POSEIDON_API_KEY"Response
{
"data": {
"filters_used": {
"niche": "weight loss",
"with_outcome": true,
"limit": 2,
"offset": 0
},
"matching_groups": 98,
"groups": [
{
"kind": "same_text_other_video",
"what_was_tested": "same ad text, different video",
"brand": {
"page_id": "957197761006622",
"name": "Fitness-Wiola",
"shop_domain": "fitnessviola.pl",
"shop_url": "https://fitnessviola.pl",
"niche_of_search": "weight loss"
},
"shared_ad_text": "Przez lata myślałam, że płaski brzuch wymaga głodu.\n\nMały talerz, mała porcja i ciągłe liczenie kalorii. Po kilku dniach nie dawałam rady.\n\nDziś jem duże porcje warzyw i białka 🥦\n\nPo każdym posiłku jestem najedzona.\n\nNie liczę kalorii i nie zgaduję porcji. Wszystko mam już rozpisane w menu.\n\nMenu na płaski brzuch to 10 dni gotowych posiłków z Biedronki i Lidla. Jest też gotowa lista zakupów 🛒\n\nSprzedałam już ponad 2000 takich planów.\n\nChcę jeść do syta z Menu na płaski brzuch 👇",
"launched_between": [
"2026-10-13",
"2026-10-26"
],
"outcome": "best reach 180,509 vs 19,465 (9.3x)",
"found_on": "2026-11-12",
"method": "groups-v1: 14-day window, 90 % text likeness = same, same preview = same video, catalog ads left out",
"variants": [
{
"variant": 1,
"ads": [
{
"ad_id": "1631528515170972",
"library_url": "https://www.facebook.com/ads/library/?id=1631528515170972",
"start_date": "2026-10-13",
"active": true,
"status_read_on": "2026-11-12",
"days_live": 30,
"versions": 1,
"eu_reach": {
"total": 180509,
"label": "EU reach (Meta's total)",
"read_on": "2026-11-12",
"source": "Meta Ad Library (public ad page, read by Poseidon)"
}
}
]
},
{
"variant": 2,
"ads": [
{
"ad_id": "1639406481109618",
"library_url": "https://www.facebook.com/ads/library/?id=1639406481109618",
"start_date": "2026-10-13",
"active": true,
"status_read_on": "2026-11-12",
"days_live": 30,
"versions": 1,
"eu_reach": {
"total": 144202,
"label": "EU reach (Meta's total)",
"read_on": "2026-11-12",
"source": "Meta Ad Library (public ad page, read by Poseidon)"
}
}
]
}
]
},
{
"kind": "same_text_other_video",
"what_was_tested": "same ad text, different video",
"brand": {
"page_id": "1052237044630549",
"name": "Fitness Per Negate",
"shop_domain": "fitnesspernegate.it",
"shop_url": "https://fitnesspernegate.it",
"niche_of_search": "weight loss"
},
"shared_ad_text": "Ti sei messa a dieta. Ti sei impegnata con l’allenamento.... Ma allo specchio non vedi i risultati che speravi.\n\nTi senti più stanca, non più tonica.\n\nSui social vedi corpi perfetti e sembra tutto facile: ma per te non lo è.\n\nMa non sei tu il problema: sono gli approcci generici.\n\nOgni corpo femmile è unico.\n\nQuindi serve un approccio unico.\n\nFitness per Negate è il coaching online per ragazze che partono da zero.\n\nAllenamento semplice, alimentazione sostenibile, supporto costante.\n\n100% soddisfatta o rimborsata.\n\nUnisciti anche tu a Fitness per Negate.",
"launched_between": [
"2026-10-13",
"2026-10-23"
],
"outcome": "best reach 960,517 vs 13,558 (70.8x)",
"found_on": "2026-11-12",
"method": "groups-v1: 14-day window, 90 % text likeness = same, same preview = same video, catalog ads left out",
"variants": [
{
"variant": 1,
"ads": [
{
"ad_id": "2868437356861258",
"library_url": "https://www.facebook.com/ads/library/?id=2868437356861258",
"start_date": "2026-10-13",
"active": true,
"status_read_on": "2026-11-12",
"days_live": 30,
"versions": 1,
"eu_reach": {
"total": 960517,
"label": "EU reach (Meta's total)",
"read_on": "2026-11-12",
"source": "Meta Ad Library (public ad page, read by Poseidon)"
}
}
]
},
{
"variant": 2,
"ads": [
{
"ad_id": "935577859318336",
"library_url": "https://www.facebook.com/ads/library/?id=935577859318336",
"start_date": "2026-10-13",
"active": true,
"status_read_on": "2026-11-12",
"days_live": 30,
"versions": 1,
"eu_reach": {
"total": 373216,
"label": "EU reach (Meta's total)",
"read_on": "2026-11-12",
"source": "Meta Ad Library (public ad page, read by Poseidon)"
}
}
]
}
]
}
]
},
"meta": {
"endpoint": "search_experiments",
"api_version": "1.1.0",
"credits_charged": 5,
"credits_left": 510,
"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.",
"notes": [
"A test group = ads of one brand launched within 14 days of each other that share one element and differ in another (found by Poseidon, method in each group). The outcome is measured, never judged: a variant still active while another stopped, or a best EU reach 2x or more another's. No outcome = nothing clear yet.",
"niche = the niche of the keyword search that found the brand on the Ad Library. It is a fact about our search, not a judgment of the brand: a brand found by 'weight loss' may sell something else."
]
}
}