Ads · MCP TOOL
get_app_organic_ads
Summarize the YouTube videos and Shorts creators made about one app (Beta).
When to use it
See how creators cover an app outside paid ads: paid promotions, reviews, tutorials, gameplay, showcases, news and mentions, with total views, the kinds and formats mix, monthly videos and views, the top creators with their links, and the 10 most viewed videos. YouTube only; each video was checked for relevance to the app.
Parameters
Defaults and constraints come from the published Zod input schema. “—” means no schema default or no enum restriction. Use JSON values of the listed type; additional handler rules are described above.
Example prompts
- Which YouTube creators covered my puzzle game, and what kind of videos did they make?
Example call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_app_organic_ads",
"arguments": {
"appId": "ios:1234567890"
}
}
}Example result
Illustrative, abridged JSON-RPC result. Only selected fields are shown; empty arrays illustrate a response with no rows. These are not current catalog observations. Parse the JSON inside content[].text.
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"appId\":\"ios:1234567890\",\"videos\":42,\"views\":1850000,\"creators\":31,\"byKind\":{\"review\":18,\"gameplay\":14,\"tutorial\":6,\"promotion\":4},\"byFormat\":{\"short\":27,\"video\":15},\"monthly\":[{\"month\":\"2026-10\",\"videos\":9,\"views\":310000}],\"topCreators\":[{\"title\":\"Example Channel\",\"handle\":\"@examplechannel\",\"subscriberCount\":120000,\"videos\":3,\"views\":240000}],\"topVideos\":[{\"id\":\"ios:1234567890|abc123\",\"kind\":\"review\",\"format\":\"short\",\"title\":\"Example review video\",\"viewCount\":410000,\"publishedAt\":\"2026-10-12T00:00:00.000Z\"}]}"
}
]
}
}Free vs paid results
Free reads the app’s figures (videos, views, creators, kinds, formats, months) and videos 3–10 whole. The two most viewed videos are locked like the web listing (no title, link or creator; kind, format, views and day stay), and the top creators are locked: their channel names, handles, links and images are hidden while their subscribers, videos and views stay. Basic and Pro see everything.
Paid access does not fill coverage gaps or unknown values. Returned plan metadata and lock notes explain redaction where applicable. Read the full Free data policy.
Rate limits and usage credit
Days reset at 00:00 UTC. The combined ISO week resets Monday at 00:00 UTC. Every served tool call counts, including cached reads. Failed or refused calls are released along with any charge. Compare plans.
After either allowance, Basic and Pro can opt in to pay $0.02 in usage credit per call to get_app_organic_ads. A call exceeding both windows is charged once. Free is refused past its allowances; paid plans without opt-in or enough credit are also refused with HTTP 402 / JSON-RPC -32004.
Credential request throttles and, for live keyword work, store-work throttles also apply. Follow retry instructions in the error reference.