Connect your AI / OpenAI Responses API

Poseidon in OpenAI Responses API

Four steps: a free key, one paste, one question. Your AI then looks up Meta's winning ads for you.

Your own code, with OpenAI's models calling Poseidon's tools. You need an OpenAI API key.

1 Get your free key

100 credits, no card. A search costs 5 credits, so that's 20 searches. Already have a key? Go to step 2.

One free key per email, with 100 credits. Your email is kept only as a scrambled hash. How we handle your data

2 Copy this into OpenAI Responses API

  1. Install and set your keys

    pip install openai
export OPENAI_API_KEY=sk-...
export POSEIDON_API_KEY=psd_YOUR_KEY

  2. Run this

    import os
from openai import OpenAI

client = OpenAI()
r = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "poseidon",
        "server_url": "https://api.askposeidon.app/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['POSEIDON_API_KEY']}"},
        "require_approval": "never",
    }],
    input="What are the winning video ads for weight loss in France? Go look in Poseidon.",
)
print(r.output_text)

    The question is already in the code: run it and the answer prints.

3 Ask this first question

What are the winning video ads for weight loss in France? Go look in Poseidon.

4 See a real answer

Asked in Claude Code on 13 November 2026, with this exact question. Your AI's wording will differ; the ads and the numbers come from the same data. Shops are shown by their domain.

Poseidon has 230 French weight-loss video ads live for 21+ days (its "winner" rule), read on 12–13 Nov 2026. Only 11 of them have a transcribed script.

Poseidon tags ads by the search keyword that found the brand, so several results aren't really weight loss (a creatine brand, a dog-itching brand, a jeweller, a skincare brand). I've left those out. The real weight-loss winners are below. Reach is Meta's EU total, mostly France.

Brand / productHook (verbatim)Days liveEU reach
epycure.com "Boost Métabolisme" (862034243491035)« J'ai perdu 10 kilos en 3 mois, comment t'expliques que ça marche aussi bien ? »2492.77M
epycure.com, same hook (953770740499393)same226984K
epycure.com (1810945286549226)« J'ai perdu 10 kilos en 3 mois, je note toutes les méthodes que j'ai testées. »1561.22M
epycure.com "Duo Métabolisme Cortisol" (1548772947043511)Cortisol belly: « …pourquoi mes jeans ne fermaient plus. J'étais stressée… tout se stockait sur mon ventre »168804K
bonjourdrink.co (vitamins) (1606210810859473)« La première chose que j'ai arrêté de boire le matin, c'est l'eau citronnée pour perdre du poids. »773.13M
bonjourdrink.co (1029580753185733)Myth-busting: « Trois mythes que je démonte… en 15 secondes »972.0M
bonjourdrink.co (vitamins + digestion pages) (3995448180749188, 1369202271811705)« Le ventre gonflé, le coup de barre à 14h et l'irritabilité… c'est le même organe qui déraille. »~120~1.97M each

bonjourdrink.co runs about 6 more videos with 0.9–1.9M reach that have no transcript yet, so I can't tell you what they say.

What works in France right now:

  • epycure.com: a first-person result with a number ("10 kilos en 3 mois") plus a metabolism or cortisol mechanism, kept running for 150–250 days.
  • bonjourdrink.co: a "stop doing X" hook that calls out a common belief (lemon water) or myths, and a single cause behind several symptoms (bloating, energy crash, irritability). These are newer but reach the most people.

If something's off

An error mentions 401

Check POSEIDON_API_KEY is set in the same terminal (echo $POSEIDON_API_KEY).

Still stuck? Write to contact@askposeidon.app with what you see.