MarkUDown
API de Rank — documentación de posiciones en buscadores MarkUDown
POST
/api/rankRank
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ámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
| keyword | string | requerido | — | Palabra clave o frase a buscar. |
| domain | string | requerido | — | Dominio a buscar en los resultados (por ejemplo "example.com"). www y el protocolo se eliminan automáticamente. |
| engine | string | opcional | "google" | "google" o "bing". |
| lang | string | opcional | "en" | Código de idioma de la búsqueda. |
| country | string | opcional | "us" | Código de país para resultados locales. |
| depth | integer | opcional | 100 | Cantidad de resultados a revisar (máximo 100). |
| timeout | integer | opcional | 60 | Tiempo límite de la petición, en segundos. |
| callback_url | string | opcional | null | URL 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
}