API REST

Referência de endpoints

Os mesmos endpoints existem como ferramentas no MCP, com o mesmo nome e os mesmos parâmetros.

Apps

GET/api/v1/apps

Busca apps iOS/Android com MRR estimado, downloads e crescimento.

Ferramenta MCP: search_apps

Parâmetro	Tipo	Descrição
`q`	string	Busca livre por nome, desenvolvedor e palavras-chave.
`niche`	string	Slug do nicho vindo de /niches. Um slug inválido devolve erro, nunca uma lista vazia.
`country`	string	Loja cujas estimativas são usadas: BR (Brasil, BRL) ou US (apps só dos EUA, USD). Padrão BR.BR · USpadrão: BR
`min_mrr`	number	MRR estimado mínimo, na moeda da loja (BRL para BR, USD para US).
`max_mrr`	number	MRR estimado máximo, na moeda da loja.
`growth_status`	string	Só apps com este status de crescimento. breakout = explodindo, rising = subindo.breakout · rising · steady · fading
`running_ads`	boolean	Só apps com pelo menos um anúncio da Meta identificado.
`sort`	string	Ordenação. growth = score composto de crescimento.mrr · downloads · rating · reviews · growth · newestpadrão: mrr
`limit`	integer	Itens a devolver, de 1 a 25. Cada item conta como um registro na sua quota.padrão: 10
`offset`	integer	Itens a pular, até 100. Para ver mais, refine os filtros.padrão: 0

GET/api/v1/apps/{id}

Perfil completo de um app: MRR, downloads, churn, janelas de crescimento, anúncios e flows.

Ferramenta MCP: get_app

Parâmetro	Tipo	Descrição
`id`obrigatório	string	Id ou slug do app, como devolvido pela busca.

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

MRR e downloads estimados por semana nos últimos 90 dias.

Ferramenta MCP: get_mrr_history

Parâmetro	Tipo	Descrição
`id`obrigatório	string	Id ou slug do app, como devolvido pela busca.

Crescimento

GET/api/v1/rankings/growth

Apps que mais cresceram, por avaliações novas em 1/7/28 dias ou ritmo relativo.

Ferramenta MCP: top_growing_apps

Parâmetro	Tipo	Descrição
`window`	string	1d/7d/28d = avaliações novas na janela; pace = relativo ao tamanho do app; score = composto.1d · 7d · 28d · pace · scorepadrão: 7d
`niche`	string	Slug do nicho vindo de /niches. Um slug inválido devolve erro, nunca uma lista vazia.
`country`	string	Loja cujas estimativas são usadas: BR (Brasil, BRL) ou US (apps só dos EUA, USD). Padrão BR.BR · USpadrão: BR
`growing_only`	boolean	Só apps marcados como explodindo ou subindo.padrão: false
`limit`	integer	Itens a devolver, de 1 a 25. Cada item conta como um registro na sua quota.padrão: 10
`offset`	integer	Itens a pular, até 100. Para ver mais, refine os filtros.padrão: 0

Nichos

GET/api/v1/niches

Todos os nichos com nº de apps, apps crescendo, MRR total estimado e economia unitária.

Ferramenta MCP: list_niches

Parâmetro	Tipo	Descrição
`country`	string	Loja usada nos agregados e na moeda. Padrão BR.BR · USpadrão: BR

GET/api/v1/niches/{slug}

Um nicho: agregados, economia unitária, top apps por MRR e os que mais crescem.

Ferramenta MCP: get_niche

Parâmetro	Tipo	Descrição
`slug`obrigatório	string	Slug do nicho.
`country`	string	Loja usada nos agregados e na moeda. Padrão BR.BR · USpadrão: BR

Anúncios

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

Anúncios da Meta rodando agora para um app.

Parâmetro	Tipo	Descrição
`id`obrigatório	string	Id ou slug do app, como devolvido pela busca.
`limit`	integer	Itens a devolver, de 1 a 25. Cada item conta como um registro na sua quota.padrão: 10
`offset`	integer	Itens a pular, até 100. Para ver mais, refine os filtros.padrão: 0

GET/api/v1/ads

Anúncios da Meta rodando agora nos apps mobile: copy, formato, plataformas, dias no ar.

Ferramenta MCP: list_running_ads

Parâmetro	Tipo	Descrição
`app`	string	Só anúncios deste app (id ou slug).
`niche`	string	Slug do nicho vindo de /niches. Um slug inválido devolve erro, nunca uma lista vazia.
`format`	string	Formato do criativo.video · image
`platform`	string	Só anúncios publicados nesta plataforma.facebook · instagram · messenger · audience_network · threads
`sort`	string	newest = começaram mais recentemente; longest_running = no ar há mais tempo (em geral, os vencedores).newest · longest_runningpadrão: newest
`limit`	integer	Itens a devolver, de 1 a 25. Cada item conta como um registro na sua quota.padrão: 10
`offset`	integer	Itens a pular, até 100. Para ver mais, refine os filtros.padrão: 0

Onboardings e paywalls

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

Onboarding e paywall capturados de um app, tela por tela.

Ferramenta MCP: get_app_flows

Parâmetro	Tipo	Descrição
`id`obrigatório	string	Id ou slug do app, como devolvido pela busca.
`kind`	string	Só este tipo de flow.onboarding · paywall · features · other

GET/api/v1/flows

Apps com onboarding/paywall capturados; abra um com /apps/{id}/flows.

Ferramenta MCP: list_app_flows

Parâmetro	Tipo	Descrição
`kind`	string	Só este tipo de flow.onboarding · paywall · features · other
`platform`	string	Só esta plataforma.ios · android
`q`	string	Busca livre por nome, desenvolvedor e palavras-chave.
`limit`	integer	Itens a devolver, de 1 a 25. Cada item conta como um registro na sua quota.padrão: 10
`offset`	integer	Itens a pular, até 100. Para ver mais, refine os filtros.padrão: 0

SaaS web

GET/api/v1/saas

SaaS web com MRR, contagem de anúncios e tags.

Ferramenta MCP: search_saas

Parâmetro	Tipo	Descrição
`q`	string	Busca livre por nome, desenvolvedor e palavras-chave.
`tag`	string	Só produtos com esta tag (ex.: "ai").
`min_mrr`	number	MRR mínimo em USD.
`max_mrr`	number	MRR máximo em USD.
`running_ads`	boolean	Só produtos com anúncios.
`sort`	string	Ordenação.mrr · adspadrão: mrr
`limit`	integer	Itens a devolver, de 1 a 25. Cada item conta como um registro na sua quota.padrão: 10
`offset`	integer	Itens a pular, até 100. Para ver mais, refine os filtros.padrão: 0

GET/api/v1/saas/{id}

Um SaaS: MRR, histórico semanal de MRR, anúncios e copy dos anúncios.

Ferramenta MCP: get_saas

Parâmetro	Tipo	Descrição
`id`obrigatório	string	Id do SaaS.

Conta

GET/api/v1/usage

Sua quota: requisições e registros usados e restantes.

Ferramenta MCP: get_usage

Sem parâmetros.