API REST da Noctral

Autenticação

Toda chamada leva a chave no header Authorization, no formato Bearer. A chave começa com nk_ e é criada na tela API & MCP. O login OAuth vale só para o MCP.

Authorization: Bearer nk_SUA_CHAVE

Crie a chave em API & MCP. A API faz parte do plano Pro (mensal, vitalício ou passe mensal). O plano é conferido a cada chamada: se a assinatura acabar, as chaves param de funcionar.

Clientes que não conseguem enviar Bearer podem usar o header X-API-Key.

API REST

JSON sobre HTTPS. Todas as rotas são GET e ficam em https://noctralspy.com/api/v1

curl "https://noctralspy.com/api/v1/rankings/growth?window=7d&niche=ia-chatbot&limit=5" \
  -H "Authorization: Bearer nk_SUA_CHAVE"

const response = await fetch(
  'https://noctralspy.com/api/v1/apps?niche=fitness-treino&sort=mrr&limit=10',
  { headers: { Authorization: 'Bearer nk_SUA_CHAVE' } },
);
const { data, meta } = await response.json();

import requests

response = requests.get(
    "https://noctralspy.com/api/v1/ads",
    params={"niche": "dieta-nutricao", "sort": "longest_running", "limit": 10},
    headers={"Authorization": "Bearer nk_SUA_CHAVE"},
)
ads = response.json()["data"]

Quer usar os dados no Claude, no ChatGPT ou no Cursor? O MCP conecta com login, sem chave. Conectar pelo MCP

Formato da resposta

Listas vêm em data com a paginação em meta (total, offset, limit, next_offset). Perfis vêm em data. Todo item traz a URL da página dele na Noctral.

{
  "data": [
    {
      "id": "…",
      "slug": "cal-ai",
      "name": "Cal AI",
      "storefront": "US",
      "currency": "USD",
      "mrr_estimate": 1200000,
      "growth": {
        "status": "rising",
        "new_ratings_7d": 2100
      },
      "url": "https://noctralspy.com/cal-ai?country=US"
    }
  ],
  "meta": {
    "total": 48,
    "offset": 0,
    "limit": 10,
    "next_offset": 10
  }
}