API reference · Runs

Ad Search

The ads running for a kind of app or a named app, from the Google, Apple, Meta and TikTok ad libraries, vetted so only real app ads are kept, with hooks and a summary. A search run in the last day is answered from it and costs nothing.

POST/api/v1/ad-search

Costs: 20 credits · Find more 10
MCP tool: start_ad_search
Answers: A job, at once (202)

curl "https://appleak.app/api/v1/ad-search" \
  -H "Authorization: Bearer $APPLEAK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "budgeting apps",
    "networks": [
      "google",
      "apple",
      "meta"
    ]
  }'

Response202 Accepted

{
  "id": "6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41",
  "object": "job",
  "kind": "ad_search",
  "status": "queued",
  "credits": 20,
  "refunded": false,
  "progress": null,
  "createdAt": "2026-10-19T12:00:00.000Z",
  "startedAt": null,
  "finishedAt": null,
  "error": null,
  "result": null,
  "links": {
    "self": "/api/v1/jobs/6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41"
  }
}

#Parameters

Body parameters

querystringrequired
A kind of app ("budgeting apps") or an app’s name. 2–300 characters
networks"google" | "apple" | "meta" | "tiktok"[]optional
Which ad libraries to read. Leave out for Google and Apple. 1–4 items
morebooleanoptional
Find more: one page further in each library, for a query searched before.
forcebooleanoptional
Start a new run even when the same one is already queued or running for you.

#Returns

A job, straight away, with status queued. Follow it with GET /jobs/{id} until it is done; the finished job carries the result.

MCP: start_ad_search — Start an Appleak Ad Search: the ads apps of a kind (or one named app) are running on Google, Apple, Meta and TikTok, vetted, with hooks and a summary. Free if searched in the last day, else spends credits; returns a job id for get_job.