Errors

Errors are plain JSON with an error message. An error is never billed.

Status	Meaning
`401`	Missing, unknown or revoked API key.
`429`	Too many requests for this key. Wait Retry-After seconds. Not billed.
`503`	Server busy or a query took too long. Retry. Not billed.
`400`	A parameter is refused (the answer lists the accepted values). Not billed.
`402`	Not enough credits for this call. Credits never expire; top up with a pack.
`404`	Not in Poseidon.

401

{
  "error": "missing or invalid API key"
}

429

{
  "error": "too many requests for this key (not billed)",
  "retry_after_s": 0.27
}

400

{
  "error": "unknown format 'UGC'",
  "formats": [
    "CAROUSEL",
    "DCO"
  ],
  "note": "format is Meta's display format. Creative types such as UGC, VSL or podcast are not labelled on any ad yet. Use VIDEO for video ads."
}

402

{
  "error": "not enough credits for an ad: 2 needed, 0 left. Credits never expire; top up to continue.",
  "credits_left": 0
}

404

{
  "error": "ad 1234567890 is not in Poseidon"
}