GET /v1/brands
A brand by its shop domain
A brand: its Ad Library page link, shop (link, platform), how it was found, its ads in Poseidon (counts by format, winners, median days live, ads with reach) and its 10 longest-running ads. Give page_id or the shop domain. Costs 5 credits.
Cost: 5 credits per call. A call that returns nothing costs 0.
Parameters
Parameter Type What it does domain required string e.g. example.com
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/brands?domain=epycure.com" \
-H "Authorization: Bearer $POSEIDON_API_KEY"Response
{
"data": {
"brands": [
{
"page_id": "2218331548432159",
"name": "Epycure",
"library_url": "https://www.facebook.com/ads/library/?view_all_page_id=2218331548432159",
"niche_of_search": "weight loss",
"found_by": "mot-clé : perte de poids",
"first_added_on": "2026-11-11",
"shop_check": "confirmed e-commerce shop",
"shop_checked_on": "2026-11-12",
"active_ads_on_meta_page": {
"count": 420,
"read_on": "2026-11-12"
},
"shop": {
"domain": "epycure.com",
"url": "https://epycure.com",
"platform": "shopify",
"checked_on": "2026-11-12",
"check_method": "the shop's own website (its /products.json, then platform markers in its pages)"
},
"ads_in_poseidon": {
"ads": 30,
"active": 30,
"winners_21_days": 28,
"median_days_live": 108.5,
"last_read": "2026-11-12",
"ads_by_format": [
{
"format": "VIDEO",
"ads": 21
},
{
"format": "DCO",
"ads": 5
}
],
"ads_with_eu_reach": 25,
"last_reach_read": "2026-11-12",
"computed_by": "Poseidon, from the ads above, at answer time"
},
"longest_running_ads": [
{
"ad_id": "862034243491035",
"library_url": "https://www.facebook.com/ads/library/?id=862034243491035",
"format": "VIDEO",
"active": true,
"status_read_on": "2026-11-12",
"source": "Meta Ad Library (ad fields: dates, status, format, versions, landing link)",
"start_date": "2026-03-08",
"days_live": 249,
"versions": 1,
"landing_url": "https://epycure.com/products/boost-metabolisme",
"eu_reach": {
"total": 2766753,
"label": "EU reach (Meta's total)",
"read_on": "2026-11-12",
"source": "Meta Ad Library (public ad page, read by Poseidon)"
},
"hook": {
"text": "J'ai perdu 10 kilos en 3 mois, comment t'expliques que ça marche aussi bien ?",
"labelled_by": "AI section labelling (Claude Fable)"
},
"has_script": true
},
{
"ad_id": "1305907038126860",
"library_url": "https://www.facebook.com/ads/library/?id=1305907038126860",
"format": "VIDEO",
"active": true,
"status_read_on": "2026-11-12",
"source": "Meta Ad Library (ad fields: dates, status, format, versions, landing link)",
"start_date": "2026-03-31",
"days_live": 226,
"versions": 1,
"landing_url": "https://epycure.com/products/boost-metabolisme?utm_source=meta&utm_medium=paid_social&utm_campaign=%7B%7Bcampaign.name%7D%7D&utm_content=%7B%7Bad.name%7D%7D",
"eu_reach": {
"total": 539733,
"label": "EU reach (Meta's total)",
"read_on": "2026-11-12",
"source": "Meta Ad Library (public ad page, read by Poseidon)"
}
}
]
}
]
},
"meta": {
"endpoint": "get_brand",
"api_version": "1.1.0",
"credits_charged": 5,
"credits_left": 515,
"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": [
"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."
]
}
}