MarkUDown

API de Rank — documentação de posição no Google MarkUDown

POST/api/rank

Rank

Verifica em que posição um domínio aparece nos resultados do Google ou do Bing para uma palavra-chave. Percorre até 100 resultados e devolve a posição exata, a URL encontrada, o título e o trecho — ou null quando o domínio não aparece.

ParâmetroTipoObrigatórioPadrãoDescrição
keywordstringobrigatório—Palavra-chave ou frase a buscar.
domainstringobrigatório—Domínio a procurar nos resultados (por exemplo "example.com"). www e o protocolo são removidos automaticamente.
enginestringopcional"google""google" ou "bing".
langstringopcional"en"Código do idioma da busca.
countrystringopcional"us"Código do país para resultados locais.
depthintegeropcional100Quantidade de resultados a percorrer (máximo 100).
timeoutintegeropcional60Tempo limite da requisição, em segundos.
callback_urlstringopcionalnullURL de webhook que recebe o resultado (POST) quando o job termina.

Requisição

{
  "keyword": "web scraping api",
  "domain": "scrapetechnology.com",
  "engine": "google",
  "lang": "en",
  "country": "us",
  "depth": 100
}

Resposta

{
  "success": true,
  "id": "job_abc123",
  "url": "/api/rank/job_abc123"
}

// Poll GET /api/rank/{id} — "data" when completed:
{
  "success": true,
  "keyword": "web scraping api",
  "domain": "scrapetechnology.com",
  "engine": "google",
  "position": 7,
  "url": "https://scrapetechnology.com/markudown",
  "title": "MarkUDown — Web Scraping API",
  "snippet": "Fast, reliable web scraping...",
  "checked_results": 100,
  "processing_time_ms": 4210
}