API reference · Runs

UGC video search

Ask TikTok, Instagram, YouTube Shorts and Facebook now for creator videos about an app or a kind of app, beyond what the library has matched. A phrase searched in the last six hours is answered from it and costs nothing.

POST/api/v1/videos/search

Costs: 4 credits
MCP tool: start_video_search
Answers: A job, at once (202)

curl "https://appleak.app/api/v1/videos/search" \
  -H "Authorization: Bearer $APPLEAK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "calorie tracker app",
    "platforms": [
      "tiktok",
      "youtube"
    ]
  }'

Response202 Accepted

{
  "id": "6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41",
  "object": "job",
  "kind": "videos",
  "status": "queued",
  "credits": 4,
  "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
2–120 characters
platforms"tiktok" | "instagram" | "youtube" | "facebook"[]optional
1–4 items
morebooleanoptional
The next page of each platform, for a phrase 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_video_search — Start a live search of TikTok, Instagram, YouTube Shorts and Facebook for creator videos about an app or kind of app. Free if searched in the last six hours, else spends credits; returns a job id for get_job.