MarkUDown

API de Rank — documentación de posiciones en buscadores MarkUDown

POST/api/rank

Rank

Comprueba en qué posición aparece un dominio en los resultados de Google o Bing para una palabra clave. Revisa hasta 100 resultados y devuelve la posición exacta, la URL encontrada, el título y el fragmento, o null cuando el dominio no aparece.

ParámetroTipoRequeridoPor defectoDescripción
keywordstringrequerido—Palabra clave o frase a buscar.
domainstringrequerido—Dominio a buscar en los resultados (por ejemplo "example.com"). www y el protocolo se eliminan automáticamente.
enginestringopcional"google""google" o "bing".
langstringopcional"en"Código de idioma de la búsqueda.
countrystringopcional"us"Código de país para resultados locales.
depthintegeropcional100Cantidad de resultados a revisar (máximo 100).
timeoutintegeropcional60Tiempo límite de la petición, en segundos.
callback_urlstringopcionalnullURL de webhook que recibe el resultado (POST) cuando el job termina.

Solicitud

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

Respuesta

{
  "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
}