MarkUDown
API de Rank — documentação de posição no Google MarkUDown
POST
/api/rankRank
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âmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| keyword | string | obrigatório | — | Palavra-chave ou frase a buscar. |
| domain | string | obrigatório | — | Domínio a procurar nos resultados (por exemplo "example.com"). www e o protocolo são removidos automaticamente. |
| engine | string | opcional | "google" | "google" ou "bing". |
| lang | string | opcional | "en" | Código do idioma da busca. |
| country | string | opcional | "us" | Código do país para resultados locais. |
| depth | integer | opcional | 100 | Quantidade de resultados a percorrer (máximo 100). |
| timeout | integer | opcional | 60 | Tempo limite da requisição, em segundos. |
| callback_url | string | opcional | null | URL 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
}