Documentação da API IndexPro

Envie URLs para indexação padrão ou instantânea a partir do seu próprio código. Uma chave de API, um cabeçalho, quatro endpoints.

Comece em três passos

Você consegue enviar a primeira requisição em poucos minutos.

Copie sua chave de API

Entre na sua conta, abra a página de conta e copie a chave na seção Chave de API. Você pode gerá-la de novo a qualquer momento.

Peça a URL base

Compartilhamos a URL base da API em particular com quem realmente vai integrá-la, por isso ela não fica publicada nesta página. Fale com a gente e enviamos.

Envie seu primeiro lote

Escolha um endpoint, cole sua chave e a URL base, e envie suas URLs. Os créditos só são cobrados quando o lote é aceito.

Sobre a URL base

Não publicamos a URL base da API aqui. Entre em contato e enviamos diretamente para você, assim ela fica com quem de fato precisa dela.

Todos os exemplos desta página escrevem BASE_URL. Troque esse marcador pelo endereço que enviarmos e mantenha o resto do caminho exatamente como está.

Fale conosco para receber a URL base

Qual API devo usar?

Os dois endpoints aceitam o mesmo corpo de requisição. Eles diferem na velocidade de envio e no custo.

Indexação padrão

A opção do dia a dia. Boa para publicação regular, lotes grandes e cobertura rotineira de um site inteiro.

Normalmente processada em alguns dias
Ideal para envios em massa e conteúdo contínuo
Disponível em qualquer conta com créditos

20 créditos por URL

Indexação instantânea

A via rápida. Use para páginas que precisam de atenção agora: um lançamento, uma correção ou um conteúdo urgente.

Muitas vezes processada em minutos
Ideal para lançamentos, correções urgentes e páginas prioritárias
Exige um plano pago, contas gratuitas recebem 403

70 créditos por URL

Autenticação

Toda requisição leva sua chave de API em um cabeçalho. Não há outras credenciais para gerenciar.

X-API-Key: YOUR_API_KEY

Envie a chave no cabeçalho X-API-Key em todas as requisições.
Authorization: Bearer SUA_CHAVE_API também funciona, se for mais conveniente para o seu cliente HTTP.
Mantenha a chave no servidor. Nunca a coloque em query string, aplicação de navegador ou repositório público, porque quem a tiver pode gastar seus créditos.
Se uma chave vazar, gere outra na sua página de conta. A antiga para de funcionar na hora.

Referência de endpoints

Acrescente cada caminho à URL base que enviarmos. Todos os endpoints retornam JSON.

Método	Caminho	O que faz
POST	/api/v1/indexing/submit	Envia URLs para a fila de indexação padrão
POST	/api/v1/indexing/status	Verifica se as URLs aparecem atualmente no Google
POST	/api/v1/instant-indexing/submit	Envia URLs para a fila de indexação instantânea
POST	/api/v1/instant-indexing/status	Consulta o status ao vivo dos seus envios instantâneos
GET	/api/v1/instant-indexing/batches	Lista seus lotes de indexação instantânea, do mais recente ao mais antigo
GET	/api/v1/account/credits	Consulta seu saldo de créditos, o preço por URL e os limites

Enviando URLs

Escolha um produto para ver o caminho dele e um exemplo pronto para rodar na sua linguagem.

POST /api/v1/indexing/submit

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
name	string	Sim	Um rótulo para o lote, para você reconhecê-lo depois. Até 120 caracteres.
urls	string[]	Sim	URLs absolutas http:// ou https://, até 500 por requisição. Duplicatas são removidas antes da cobrança.
dripfeed	number	Não	Número de dias para distribuir o envio. Omita para enviar tudo de uma vez.

curl -X POST "BASE_URL/api/v1/indexing/submit" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "name": "My first batch",
    "urls": [
      "https://example.com/page-1",
      "https://example.com/page-2"
    ]
  }'

Consultando o status

Os dois produtos têm um endpoint de status. Eles respondem perguntas diferentes, então leia a nota de cada um.

POST /api/v1/indexing/status

Pergunta ao Google se cada URL está no índice no momento. Use para confirmar o resultado de um lote enviado antes.

curl -X POST "BASE_URL/api/v1/indexing/status" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{ "urls": ["https://example.com/page-1"] }'

Custa 5 créditos por URL e aceita até 100 URLs por requisição.

Respostas

Toda resposta tem o mesmo formato: um indicador de sucesso, uma mensagem e um objeto data.

Resposta de envio

{
  "success": true,
  "message": "URLs submitted for indexing.",
  "data": {
    "batchId": "68c7dad9265f988545ebc774",
    "batchName": "My first batch",
    "urlsSubmitted": 2,
    "submissionStatus": "Submitted",
    "creditsCharged": 40,
    "remainingCredits": 824,
    "createdAt": "2026-09-15T09:22:33.229Z"
  }
}

Resposta de status

{
  "success": true,
  "message": "Checked 2 URLs.",
  "data": {
    "results": [
      { "url": "https://example.com/page-1", "indexed": true, "checked": true },
      { "url": "https://example.com/page-2", "indexed": false, "checked": true }
    ],
    "urlsChecked": 2,
    "creditsCharged": 10,
    "remainingCredits": 814
  }
}

Resposta de erro

Erros definem success como false e explicam o que mudar. O código HTTP indica a categoria.

{
  "success": false,
  "message": "Insufficient credits. This request needs 40 credits but the account has 10.",
  "creditsRequired": 40,
  "creditsAvailable": 10
}

Limites e comportamento

Vale saber antes de montar um laço em volta desses endpoints.

30 / min

Envios por chave de API

120 / min

Leituras de status e conta por chave de API

500

URLs por envio

100

URLs por consulta de status

URLs duplicadas dentro de uma requisição são unificadas, então o mesmo link nunca é cobrado duas vezes.
URLs que violam nossa política de conteúdo são descartadas e listadas em blockedUrls. Elas não são cobradas.
Os créditos são reservados quando a requisição chega e devolvidos por inteiro se o envio não puder ser entregue.
Em um 429 ou 502, espere um instante e tente de novo. Um backoff exponencial começando perto de um segundo já basta.

Códigos de erro

O que cada código de status significa e o que fazer.

Status	O que significa	O que fazer
400	Falta um campo no corpo ou um valor está fora do intervalo	Leia a mensagem, ela diz qual campo. Confira se name está presente e se urls é um array não vazio.
401	A chave de API está ausente, malformada ou não reconhecida	Confirme que o cabeçalho X-API-Key está definido e igual à chave da sua página de conta.
402	Créditos insuficientes para esta requisição	A resposta informa quantos eram necessários e quantos você tem. Recarregue, ou envie menos URLs.
403	A conta não pode usar este endpoint	Indexação instantânea exige plano pago. Se a conta estiver inativa, fale com o suporte.
404	Nada na sua conta correspondeu à requisição	Verifique os IDs de rastreamento ou as URLs. Consultas de status cobrem apenas envios feitos nesta conta.
422	Todas as URLs foram bloqueadas pela nossa política de conteúdo	Veja blockedUrls na resposta para o motivo de cada URL. Nenhum crédito foi cobrado.
429	Requisições demais em pouco tempo	Reduza o ritmo e tente de novo em um minuto. Agrupe suas URLs em menos requisições maiores.
502	O provedor de indexação estava indisponível	Tente de novo em breve. Nada foi cobrado, então é seguro reenviar o mesmo lote.

Pronto para começar a construir?

Fale conosco para receber a URL base da API, ou conte o que você está construindo e ajudamos na integração.

Solicitar a URL base Falar com o suporte