SEO

Meta Ad Finder

See the Facebook and Instagram ads your competitors keep running, and the wording and offers behind them. Find the Facebook and Instagram ads a competitor is running right now, or every active ad that mentions a keyword: the wording, call to action, landing page, start date and where each ad shows. Costs 5 credits per run. Docs: https://seogeoaeo.ai/tools/meta-ad-finder

post/tools/meta-ad-finder/runs

Request

Base URL: https://seogeoaeo.ai/api/v1
URL: https://seogeoaeo.ai/api/v1/tools/meta-ad-finder/runs
Auth: HTTP bearer

Headers

Idempotency-Keystring

Reuse on retries so the same run is returned instead of charged again. A key only matches a run of the same tool and input, and only while that run is among the workspace's latest 1,000.

Alternative to the idempotencyKey body field.

Request body

idempotencyKeystring

Reuse on retries so the same run is returned instead of charged again. A key only matches a run of the same tool and input, and only while that run is among the workspace's latest 1,000.

maxCreditsinteger

Refuse the run with max_credits_exceeded if it costs more than this.

Example request

{
  "input": {
    "query": "Semrush",
    "mode": "page",
    "market": "all"
  }
}

Response

Finished run.

Changes

No recorded changes to this operation across all 1 revision of this API.