Documentação · Primeiros passos · Atualizado 12 de novembro de 2026
REST API do LaunchSpy
A REST API serve os mesmos registos que as ferramentas MCP, a partir do mesmo código. Usa-a num script, numa folha de cálculo ou numa ferramenta de automatização.
O servidor MCP e a REST API estão incluídos nos planos Pro e Business. Cada chamada a uma ferramenta ou à API usa um crédito; ligar e listar as ferramentas é gratuito. Qualquer outra conta, incluindo uma gratuita, recebe 50 créditos de teste, uma única vez: suficientes para fazer algumas análises completas antes de escolheres um plano. Os créditos de teste não se renovam, e os valores de alcance na UE não estão incluídos no teste.
URL base e autenticação
- URL base: https://launchspy.io/api/v1
- Envia a tua chave como Authorization: Bearer lsk_… ou X-API-Key: lsk_…
- Especificação OpenAPI 3.1: https://launchspy.io/openapi.json
- Índice das rotas sem autenticação: https://launchspy.io/api/v1
Endpoints
| Método e caminho | Devolve | Ferramenta MCP |
|---|---|---|
| GET /creators | Pesquisa coaches e criadores de cursos | search_creators |
| GET /creators/{slug} | Um perfil com a sua cadência de lançamento a 30 dias | get_creator |
| GET /ads | Pesquisa criativos de anúncios (creator ou query obrigatório) | search_ads |
| GET /funnels | Pesquisa funnels acompanhados | search_funnels |
| GET /funnels/{funnel_id} | Um funnel com a sua análise X-Ray | get_funnel |
| GET /analyze?url= | O que se sabe sobre um URL ou domínio | analyze_url |
| GET /creators/{slug}/strategy | Estratégia criativa de um coach: formatos, sobrevivência dos anúncios, cadência, hooks recorrentes | get_creator_strategy |
| GET /rising-creators | Coaches que estão a escalar os anúncios agora, por nicho e país | get_rising_creators |
| GET /markets | Dimensão do mercado por nicho e país, com o preço mediano | get_market |
Exemplo
curl "https://launchspy.io/api/v1/creators?niche=Life%20Coaching&country=US&sort=active_ads&limit=10" \
-H "Authorization: Bearer lsk_your_key"Limites
- As listas devolvem até ao tamanho de página dado por limit; offset está limitado a 2000. Filtra em vez de paginar em profundidade.
- Os créditos restantes são indicados em cada resposta nos cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining.
- Cada chave está limitada a 120 chamadas por minuto e 2000 por hora.