REST API

Endpoint reference

The same endpoints exist as MCP tools, with the same names and parameters.

Apps

GET/api/v1/apps

Search iOS/Android apps with estimated MRR, downloads and growth.

MCP tool: search_apps

Parameter	Type	Description
`q`	string	Free-text search over name, developer and keywords.
`niche`	string	Niche slug from list_niches (GET /niches). An invalid slug is an error, never an empty result.
`country`	string	Storefront whose estimates are used: BR (Brazil, BRL) or US (US-only apps, USD). Defaults to BR.BR · USdefault: BR
`min_mrr`	number	Minimum estimated monthly revenue, in the storefront currency (BRL for BR, USD for US).
`max_mrr`	number	Maximum estimated monthly revenue, in the storefront currency.
`growth_status`	string	Only apps with this review-growth status. breakout = exploding, rising = growing.breakout · rising · steady · fading
`running_ads`	boolean	Only apps with at least one identified Meta ad.
`sort`	string	Ordering. growth = composite growth score.mrr · downloads · rating · reviews · growth · newestdefault: mrr
`limit`	integer	Items to return, 1-25. Each item counts as one record against your quota.default: 10
`offset`	integer	Items to skip, up to 100. To see more, narrow the filters.default: 0

GET/api/v1/apps/{id}

Full profile of one app: MRR, downloads, churn, growth windows, ads and flows.

MCP tool: get_app

Parameter	Type	Description
`id`required	string	App id or slug, as returned by search_apps.

GET/api/v1/apps/{id}/mrr-history

Weekly estimated MRR and downloads for the last 90 days.

MCP tool: get_mrr_history

Parameter	Type	Description
`id`required	string	App id or slug, as returned by search_apps.

Growth

GET/api/v1/rankings/growth

Apps that grew the most, by new reviews in 1/7/28 days or relative pace.

MCP tool: top_growing_apps

Parameter	Type	Description
`window`	string	1d/7d/28d = absolute new ratings in the window; pace = relative to the app size; score = composite.1d · 7d · 28d · pace · scoredefault: 7d
`niche`	string	Niche slug from list_niches (GET /niches). An invalid slug is an error, never an empty result.
`country`	string	Storefront whose estimates are used: BR (Brazil, BRL) or US (US-only apps, USD). Defaults to BR.BR · USdefault: BR
`growing_only`	boolean	Only apps tagged breakout or rising.default: false
`limit`	integer	Items to return, 1-25. Each item counts as one record against your quota.default: 10
`offset`	integer	Items to skip, up to 100. To see more, narrow the filters.default: 0

Niches

GET/api/v1/niches

Every niche with app count, growing apps, total estimated MRR and unit economics.

MCP tool: list_niches

Parameter	Type	Description
`country`	string	Storefront for the aggregates and currency. Defaults to BR.BR · USdefault: BR

GET/api/v1/niches/{slug}

One niche: aggregates, unit economics, top apps by MRR and fastest growing.

MCP tool: get_niche

Parameter	Type	Description
`slug`required	string	Niche slug from list_niches.
`country`	string	Storefront for the aggregates and currency. Defaults to BR.BR · USdefault: BR

GET/api/v1/apps/{id}/ads

Meta ads currently running for one app.

Parameter	Type	Description
`id`required	string	App id or slug, as returned by search_apps.
`limit`	integer	Items to return, 1-25. Each item counts as one record against your quota.default: 10
`offset`	integer	Items to skip, up to 100. To see more, narrow the filters.default: 0

GET/api/v1/ads

Meta ads running now across mobile apps: copy, format, platforms, days running.

MCP tool: list_running_ads

Parameter	Type	Description
`app`	string	Only ads for this app id or slug.
`niche`	string	Niche slug from list_niches (GET /niches). An invalid slug is an error, never an empty result.
`format`	string	Creative format.video · image
`platform`	string	Only ads published on this platform.facebook · instagram · messenger · audience_network · threads
`sort`	string	newest = most recently started; longest_running = running the longest (usually the winners).newest · longest_runningdefault: newest
`limit`	integer	Items to return, 1-25. Each item counts as one record against your quota.default: 10
`offset`	integer	Items to skip, up to 100. To see more, narrow the filters.default: 0

Onboardings and paywalls

GET/api/v1/apps/{id}/flows

Captured onboarding and paywall flows of one app, screen by screen.

MCP tool: get_app_flows

Parameter	Type	Description
`id`required	string	App id or slug, as returned by search_apps.
`kind`	string	Only this kind of flow.onboarding · paywall · features · other

GET/api/v1/flows

Apps with captured onboarding/paywall flows; open one with get_app_flows.

MCP tool: list_app_flows

Parameter	Type	Description
`kind`	string	Only this kind of flow.onboarding · paywall · features · other
`platform`	string	Only this platform.ios · android
`q`	string	Free-text search over name, developer and keywords.
`limit`	integer	Items to return, 1-25. Each item counts as one record against your quota.default: 10
`offset`	integer	Items to skip, up to 100. To see more, narrow the filters.default: 0

Web SaaS

GET/api/v1/saas

Web SaaS products with MRR, ad counts and tags.

MCP tool: search_saas

Parameter	Type	Description
`q`	string	Free-text search over name, developer and keywords.
`tag`	string	Only products with this tag (e.g. "ai").
`min_mrr`	number	Minimum MRR in USD.
`max_mrr`	number	Maximum MRR in USD.
`running_ads`	boolean	Only products with ads.
`sort`	string	Ordering.mrr · adsdefault: mrr
`limit`	integer	Items to return, 1-25. Each item counts as one record against your quota.default: 10
`offset`	integer	Items to skip, up to 100. To see more, narrow the filters.default: 0

GET/api/v1/saas/{id}

One SaaS: MRR, weekly MRR history, ad counts and ad copy.

MCP tool: get_saas

Parameter	Type	Description
`id`required	string	SaaS id from search_saas.

Account

GET/api/v1/usage

Your quota: requests and records used and remaining.

MCP tool: get_usage

No parameters.