¿Qué hace YepAPI — Referencia de API?
URL base: https://api.yepapi.com
Autenticación: encabezado x-api-key
Respuesta: { ok: true, data: {...} } o { ok: false, error: { code, message } }
Límite de velocidad: 60 solicitudes/min
SEO — Palabras clave
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/seo/keywords | $0.15 | keywords[], location | Métricas en lote: volumen, CPC, dificultad, intención, tendencias (hasta 100) |
| POST | /v1/seo/keywords/ideas | $0.03 | keyword, location | Sugerencias de palabras clave a partir de una semilla |
| POST | /v1/seo/keywords/related | $0.03 | keyword, location | Palabras clave relacionadas con la semilla |
Devuelve: volume, cpc, difficulty (0-100), intent (informational/commercial/navigational/transactional), trend (arreglo de 12 meses)
SERP
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/serp/google | $0.01 | query, location | Resultados orgánicos de Google |
| POST | /v1/serp/google/news | $0.01 | query, location | Resultados de Google Noticias |
| POST | /v1/serp/google/maps | $0.01 | query, location | Resultados de Google Maps / locales |
Devuelve: results[] con title, url, snippet, position. Maps añade rating, reviews, address, phone.
Análisis de dominio
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/seo/domain/overview | $0.01 | domain | Tráfico, palabras clave, backlinks, rango de dominio |
| POST | /v1/seo/domain/keywords | $0.04 | domain | Palabras clave por las que un dominio aparece |
| POST | /v1/seo/domain/backlinks | $0.05 | domain | Perfil de backlinks del dominio |
Devuelve: overview da traffic, keywords_count, backlinks, domain_rank. Keywords da keyword, position, volume, url.
Competidores
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/seo/competitors | $0.04 | domain | Dominios competidores por superposición de palabras clave |
| POST | /v1/seo/keyword-gap | $0.04 | domain, competitor | Brecha de palabras clave entre dos dominios |
Devuelve: competidores da domain, overlap, traffic. Gap da keyword, your_position, competitor_position, volume.
Backlinks
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/seo/backlinks | $0.05 | target | Backlinks individuales a un dominio/URL |
| POST | /v1/seo/backlinks/summary | $0.03 | target | Métricas agregadas + ratio dofollow |
| POST | /v1/seo/referring-domains | $0.03 | target | Dominios referentes con autoridad |
Devuelve: summary da total_backlinks, dofollow_ratio, domain_rank. Backlinks da source_url, anchor, type, domain_rank.
On-Page y Tendencias
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/seo/page-audit | $0.03 | url | Auditoría SEO técnica (meta, encabezados, enlaces, imágenes) |
| POST | /v1/seo/lighthouse | $0.05 | url | Puntuaciones Lighthouse (rendimiento, accesibilidad, SEO, mejores prácticas) |
| POST | /v1/seo/trends | $0.02 | keywords[] | Interés de Google Trends a lo largo del tiempo (hasta 5 palabras clave) |
Devuelve: page-audit da issues[], meta, headings, links, images. Lighthouse da performance, accessibility, seo, best_practices (0-100). Trends da interest_over_time[].
Visibilidad en IA
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/seo/ai/chatgpt | $0.05 | query | Lo que ChatGPT dice sobre una marca/consulta |
| POST | /v1/seo/ai/gemini | $0.05 | query | Lo que Gemini dice sobre una marca/consulta |
Devuelve: response (texto), mentions[], sentiment.
Web Scraping
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/scrape | $0.01 | url | Extraer a markdown/HTML/texto |
| POST | /v1/scrape/js | $0.02 | url | Extracción renderizada con JS (navegador sin cabeza) |
| POST | /v1/scrape/stealth | $0.03 | url | Bypass anti-bot (proxies residenciales) |
| POST | /v1/scrape/ai-extract | $0.03 | url, prompt | Extracción estructurada impulsada por IA |
Opcional: format ("markdown"/"html"/"text"), waitFor (selector CSS), timeout (ms).
Devuelve: content (cadena), metadata (title, description, url).
YouTube
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/youtube/search | $0.01 | query | Buscar videos, canales, listas de reproducción |
| POST | /v1/youtube/video | $0.02 | videoId | Metadatos completos del video + formatos |
| POST | /v1/youtube/transcript | $0.01 | videoId | Transcripción con marcas de tiempo |
| POST | /v1/youtube/channel | $0.01 | channelId o handle | Resumen del canal |
| POST | /v1/youtube/comments | $0.01 | videoId | Comentarios y respuestas |
Devuelve: search da results[] con videoId, title, views, published. Transcript da segments[] con text, start, duration.
Chat con IA
| Método | Ruta | Costo | Requerido | Descripción |
|---|---|---|---|---|
| POST | /v1/ai/chat | variable | model, messages[] | Chat con 69 modelos de IA |
| GET | /v1/ai/models | gratis | — | Listar modelos disponibles + precios |
Campos opcionales comunes
Endpoints de SEO: location (predeterminado "us"), language (predeterminado "en"), limit, offset.
Endpoints de scraping: format, waitFor, timeout.
Códigos de error
| Código | HTTP | Significado |
|---|---|---|
INVALID_API_KEY | 401 | Clave faltante o inválida |
REVOKED_API_KEY | 401 | Clave revocada |
NO_CREDITS | 402 | Saldo insuficiente |
RATE_LIMITED | 429 | Se excedieron las 60 solicitudes/min |
VALIDATION_ERROR | 400 | Cuerpo de solicitud incorrecto |
UPSTREAM_ERROR | 502 | Error del proveedor |
MODEL_NOT_FOUND | 400 | Modelo de IA inválido |
AI_UPSTREAM_ERROR | 502 | Error del proveedor de IA |
STREAM_ERROR | 502 | SSE interrumpido |
NOT_FOUND | 404 | Endpoint no encontrado |
INTERNAL_ERROR | 500 | Error del servidor |
Enlaces
- Documentación: https://docs.yepapi.com
- Panel de control: https://yepapi.com/dashboard
- Claves API: https://yepapi.com/dashboard/api-keys
- Referencia completa: https://docs.yepapi.com/llms-full.txt
- Servidor MCP:
npx -y @yepapi/mcp