SerpBase
Solo POST

Documentacion de API

Resultados estructurados, parámetros documentados y estado de respuesta explícito.

Base URL
https://api.serpbase.dev
Header de auth
X-API-Key: <API_KEY>
Facturacion
Precio por solicitud; los fallos ejecutados pueden consumir créditos
Autenticacion

Obtén una clave secreta en API Keys y envíala en X-API-Key, nunca en URL ni código público. Sigue el método y los parámetros del producto. HTTP 200 no prueba éxito: revisa status y error. Playground puede consumir créditos.

elapsed_ms

Respuesta comun

credits_charged

Precio por solicitud; los fallos ejecutados pueden consumir créditos

request_id

Identificador para soporte

Solicitud minima
bash
curl -X POST 'https://api.serpbase.dev/google/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: your_api_key' \
  -d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'

Aumentos automáticos de QPS

Tras confirmar el abono, el total elegible USD eleva QPS al menos a: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Menos de $3 no cambia el límite. Nunca reduce uno superior; no es ilimitado.

Recargas elegibles acumuladas (USD)QPS mínimo tras el aumento
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

Solo cuentan pagos USD credit_pack y auto_topup con abono confirmado. Se excluyen suscripciones (incluido Starter Boost), regalos y códigos. El saldo no equivale a pagos USD acumulados. Otras monedas no se cuentan como USD sin conversión.

Todas las claves, productos y gateways de una cuenta comparten un límite QPS. Crear más claves no lo aumenta.

El aumento se aplica tras confirmar el abono, no solo al volver del pago. El límite actual es el informado por el servidor en tu cuenta; la sincronización de claves puede tardar.

Modelo de facturación y reglas de deducción

Precios por solicitud y cómo interpretar los cargos informados.

Cada solicitud usa el precio fijo del catálogo, no una tarifa por página. Web Crawl y User Agent cuestan actualmente 1 crédito por solicitud cada uno; User Agent no es gratuito. La ausencia real confirmada por la fuente y la identidad del recurso se cobra. no_results, HTTP 404 o la falta de hydration/datos analizados por sí solos no prueban ausencia. Los fallos ejecutados pueden consumir créditos; no se garantiza el reembolso de todos los fallos. credits_charged informa del cargo real: 0 indica cero; null o ausencia significa desconocido. charge_status UNKNOWN sigue siendo desconocido incluso con un valor numérico. Revisa los registros y contacta con soporte con request_id; no supongas un reembolso ni reintentes a ciegas.

Integraciones de agentes

Usa el servidor MCP abierto o la habilidad portátil para que Claude, Codex, Cursor, Cline/Roo, opencode u otros agentes llamen a SerpBase con tu clave.

Configuración MCP
json
{
  "mcpServers": {
    "serpbase": {
      "command": "python",
      "args": ["-m", "serpbase_mcp"],
      "env": {
        "SERPBASE_API_KEY": "your_api_key"
      }
    }
  }
}
Instrucción de habilidad
text
Use $serpbase-skill to search Google through SerpBase and return cited structured results.
Saldo de la cuenta

Consulta el saldo actual de créditos de la cuenta asociada a una API key activa. Esta solicitud no consume créditos de búsqueda.

GET
0 credits
/account/credits

Envía la clave en el encabezado X-API-Key. No se aceptan API keys en los parámetros de la URL.

bash
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: your_api_key"
json
{
  "status": 0,
  "credits": 12345,
  "permanent_credits": 10000,
  "expiring_credits": 2345,
  "expiring_expires_at": 1798761600
}

El endpoint está limitado a 60 solicitudes por minuto y cuenta. expiring_expires_at es una marca Unix en segundos y vale 0 si no hay créditos temporales activos.

Respuesta comun

Las respuestas exitosas devuelven la misma metadata superior. Los datos especificos viven en organic, images, news, videos, places o place.

status
requerido
number

requerido

Codigo de estado de negocio. 0 significa exito.

request_id
requerido
string

requerido

ID estable para soporte, reintentos y correlacion de logs.

elapsed_ms
requerido
number

requerido

Duracion observada por gateway en milisegundos.

credits_charged
requerido
number | null

requerido

Creditos cobrados despues de aplicar reembolsos.

search_type
opcional
string

opcional

Tipo de respuesta del producto, si se devuelve.

Endpoints
1 credits
Search
/google/search

Busca Google con q, idioma hl, país gl y dispositivo admitido. Las secciones dependen de la consulta y del origen.

1 credits
Imagenes
/google/image/search

Busca imágenes y enlaces de origen en Google. Los enlaces no otorgan derechos de uso.

1 credits
Noticias
/google/news/search

Busca Google News por tema o palabras clave. Los artículos y editores dependen del origen.

1 credits
Videos
/google/videos/search

Busca listados de videos de Google; no descarga videos ni elimina marcas de agua.

2 credits
Maps Search
/google/maps/search

Busca lugares de Google Maps por consulta y ubicación. Usa el endpoint de detalles para un lugar identificado.

3 credits
Maps Detail
/google/maps/detail

Consulta un lugar de Google Maps por ID. Complementa la búsqueda y tiene su propio precio por solicitud.

2 credits
Google Maps Reviews
/google/maps/reviews

Primera página de reseñas de Google Maps de un lugar (por data_id): valoración, texto, fecha, fotos y autor. Aún no incluye respuestas del propietario.

1 credits
Google Search Autocomplete
/google/autocomplete

Obtén sugerencias de Google por prefijo; no son mediciones de volumen de búsquedas.

2 credits
Google Shopping Search
/google/shopping

Busca Google Shopping por consulta; es una instantánea, no monitoreo continuo de precios.

2 credits
Google Jobs Search
/google/jobs

Busca ofertas de Google por puesto o palabra clave; devuelve las disponibles, no envía candidaturas.

2 credits
Google Scholar Search
/google/scholar

Busca Google Scholar por tema o palabra clave; los metadatos no garantizan acceso al texto completo.

1 credits
Google Books Search
/google/books

Busca Google Books por título, autor o palabra clave; no incluye descargas irrestrictas.

1 credits
Google Finance Search
/google/finance

Consulta Google Finance por empresa o término financiero; no es un flujo de mercado ni API de operaciones.

2 credits
Google Patent Details
/google/patents/detail

Obtén una patente de Google Patents por número de publicación: título, resumen, reivindicaciones, inventores, titulares y fechas.

1 credits
Google Play Search
/google/play/search

Busca apps en Google Play por palabra clave; devuelve nombre, nombre del paquete, icono y enlace a la tienda. No descarga apps.

1 credits
Google Play App Details
/google/play/app

Obtén una app de Google Play por nombre de paquete: nombre, desarrollador, descripción, precio, versión, fechas de lanzamiento y clasificación por edad.

2 credits
Google Trends
/google/trends

Google Trends: interés a lo largo del tiempo, por región y consultas relacionadas para hasta cinco términos separados por comas.

2 credits
Google Trends Autocomplete
/google/trends/autocomplete

Sugerencias de temas de Google Trends para una palabra clave, con tipo e identificador de cada tema.

2 credits
Google Trends Trending Now
/google/trends/trending

Búsquedas en tendencia ahora en Google Trends para un país (EE. UU. por defecto) en las últimas 24 horas.

En desarrollo · En pausa
Bing Web Search
/bing/search

Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.

1 credits
DuckDuckGo Search
/duckduckgo/search

Busca DuckDuckGo HTML con filtros de mercado y fecha admitidos. Continúa con el cursor devuelto, no páginas numeradas.

2 credits
Reddit Post & Comments
/reddit/post

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

1 credits
Reddit Search
/reddit/search

Search public Reddit posts and discussion threads across subreddits by keyword query.

2 credits
TikTok Post
/tiktok/post

Consulta una publicación TikTok por ID y usuario; no descubre todas las publicaciones del perfil.

2 credits
TikTok Profile
/tiktok/profile

Consulta un perfil TikTok por usuario. Depende del acceso al origen; no es un archivo histórico de audiencia.

1 credits
TikTok Search
/tiktok/search

Busca videos de TikTok por palabra clave: enlaces, textos, autores, reproducciones, me gusta, comentarios, compartidos, hashtags y portadas; 16 por página por defecto.

1 credits
X Post Details
/x/post

Consulta una publicación X por ID; no es búsqueda por palabras, exportación de cronología ni streaming.

1 credits
YouTube Search
/youtube/search

Search YouTube videos, Shorts, and creator channels with query and region parameters.

2 credits
YouTube Video Transcripts
/youtube/transcripts

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

2 credits
Ajio Product Details
/ajio/product

Consulta un producto AJIO por URL HTTPS /p/; no exporta catálogos.

2 credits
Amazon Product Details
/amazon/product

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

2 credits
Amazon Product Reviews
/amazon/reviews

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

2 credits
Amazon Product Search
/amazon/search

Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.

1 credits
Amazon Search Autocomplete
/amazon/autocomplete

Obtén sugerencias de Amazon por prefijo, no detalles ni historial de precios.

1 credits
Apple Product Details
/apple/product

Consulta apps de App Store por ID numérico o URL apps.apple.com y país; no hardware Apple.

2 credits
eBay Product Details
/ebay/product

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

1 credits
eBay Product Search
/ebay/search

Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.

2 credits
Flipkart Product Details
/flipkart/product

Consulta Flipkart por URL de producto con /p/. Usa una URL específica, no una búsqueda.

2 credits
Myntra Product Details
/myntra/product

Consulta un producto Myntra por URL /buy; es distinto de la búsqueda.

2 credits
Myntra Search
/myntra/search

Busca Myntra por consulta o URL admitida. Admite páginas numeradas, no cursores ni cambios de tamaño de página.

2 credits
Walmart Product Details
/walmart/product

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

2 credits
Walmart Product Search
/walmart/search

Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.

1 credits
Walmart Search Autocomplete
/walmart/autocomplete

Obtén sugerencias de Walmart por consulta; no consulta páginas de producto.

1 credits
User-Agent Generator
/web/user-agent

Genera UA de escritorio o móvil con user_agent_type y user_agent_count (1–5). La operación local también tiene precio de catálogo.

1 credits
Web Crawl
/web/crawl

Inicia un rastreo limitado desde una URL pública. Precio fijo por solicitud, no multiplicado por páginas devueltas.

1 credits
Web Scrape
/web/scrape

Extrae páginas públicas HTTP/HTTPS por URL con texto, HTML, Markdown y selectores; se aplican restricciones de origen. No admite páginas de Google; usa los endpoints de Google como /google/search.

2 credits
Zillow Property Search
/zillow/search

Consulta Zillow por una URL homes admitida. Es una instantánea de anuncios, no tasaciones ni un flujo de transacciones.

POST
Disponible
/google/image/search

Imagenes

Busca imágenes y enlaces de origen en Google. Los enlaces no otorgan derechos de uso.

type
images
result
images
Facturacion
1 credits

Busca imágenes y enlaces de origen en Google. Los enlaces no otorgan derechos de uso.

Parametros
q
requerido
string

requerido

Texto de busqueda.

hl
opcional
string

opcional

Codigo de idioma. Predeterminado: en.

gl
opcional
string

opcional

Codigo de pais. Predeterminado: us.

page
opcional
number

opcional

Numero de pagina desde 1. Predeterminado: 1.

query
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "red pandas"

json
{
  "query": "red pandas"
}
Abrir en Playground
Campos de respuesta
query
requerido
string

requerido

Consulta normalizada de la solicitud.

page
requerido
number

requerido

Numero de pagina actual desde 1.

images
opcional
ImageResult[]

Cuando se analizan imágenes.

Resultados de Google Imágenes.

ImageResult Schema de item
rank
requerido
number

requerido

Posicion de ranking desde 1 en esta respuesta.

position
opcional
number

Alias de rank cuando esta disponible.

Alias normalizado para clientes que esperan position.

title
opcional
string

Cuando se parsea titulo o alt de la imagen.

Titulo del resultado.

link
requerido
string

requerido

Enlace principal devuelto por el parser.

url
opcional
string

Presente cuando el enlace se puede normalizar.

URL canonica de destino, normalmente igual a link.

source_url
opcional
string

Solo cuando se observa una URL fuente de Google.

URL original de Google para depuracion y procedencia.

display_url
opcional
string

Cuando se deriva texto visible o dominio.

URL visible o dominio fuente.

image_url
requerido
string

requerido

URL de imagen completa.

thumbnail_url
opcional
string

Cuando Google expone una miniatura.

URL de miniatura.

thumbnail
opcional
string

Alias de thumbnail_url cuando esta disponible.

Alias normalizado de miniatura.

source
opcional
string

Cuando se analiza texto de origen.

Etiqueta de origen de imagen.

domain
opcional
string

Cuando se puede obtener el dominio de origen.

Dominio de la página de origen.

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'
Ejemplo existente de Google
bash
curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notas

Busqueda visual, monitoreo de productos y fuentes.

Algunos formatos solo exponen rank/link, no todos los alias. Trata url, display_url, source_url, position y thumbnail como opcionales.

POST
Disponible
/google/news/search

Noticias

Busca Google News por tema o palabras clave. Los artículos y editores dependen del origen.

type
news
result
news
Facturacion
1 credits

Busca Google News por tema o palabras clave. Los artículos y editores dependen del origen.

Parametros
q
requerido
string

requerido

Texto de busqueda.

hl
opcional
string

opcional

Codigo de idioma. Predeterminado: en.

gl
opcional
string

opcional

Codigo de pais. Predeterminado: us.

page
opcional
number

opcional

Numero de pagina desde 1. Predeterminado: 1.

query
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Abrir en Playground
Campos de respuesta
query
requerido
string

requerido

Consulta normalizada de la solicitud.

page
requerido
number

requerido

Numero de pagina actual desde 1.

news
opcional
NewsResult[]

Cuando se analizan noticias.

Resultados de Google Noticias.

NewsResult Schema de item
rank
requerido
number

requerido

Posicion de ranking desde 1 en esta respuesta.

position
opcional
number

Alias de rank cuando esta disponible.

Alias normalizado para clientes que esperan position.

title
requerido
string

requerido

Titulo del resultado.

link
requerido
string

requerido

Enlace principal devuelto por el parser.

url
opcional
string

Presente cuando el enlace se puede normalizar.

URL canonica de destino, normalmente igual a link.

source_url
opcional
string

Solo cuando se observa una URL fuente de Google.

URL original de Google para depuracion y procedencia.

display_url
opcional
string

Cuando se deriva texto visible o dominio.

URL visible o dominio fuente.

source
opcional
string

Cuando se analiza el editor.

Etiqueta de editor u origen.

time
opcional
string

Cuando Google expone texto de tiempo.

Texto original de publicación.

published_at
opcional
string

Alias del tiempo analizado, si existe.

Alias del tiempo de publicación normalizado.

snippet
opcional
string

Cuando se analiza un fragmento.

Fragmento de resumen del artículo.

thumbnail_url
opcional
string

Cuando Google expone una miniatura.

URL de miniatura.

thumbnail
opcional
string

Alias de thumbnail_url cuando esta disponible.

Alias normalizado de miniatura.

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
Ejemplo existente de Google
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notas

Monitoreo de marca, tendencias y medios.

Origen y tiempo se analizan de metadatos compactos de Google; ambos son opcionales.

POST
Disponible
/google/videos/search

Videos

Busca listados de videos de Google; no descarga videos ni elimina marcas de agua.

type
videos
result
videos
Facturacion
1 credits

Busca listados de videos de Google; no descarga videos ni elimina marcas de agua.

Parametros
q
requerido
string

requerido

Texto de busqueda.

hl
opcional
string

opcional

Codigo de idioma. Predeterminado: en.

gl
opcional
string

opcional

Codigo de pais. Predeterminado: us.

page
opcional
number

opcional

Numero de pagina desde 1. Predeterminado: 1.

query
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "how espresso machines work"

json
{
  "query": "how espresso machines work"
}
Abrir en Playground
Campos de respuesta
query
requerido
string

requerido

Consulta normalizada de la solicitud.

page
requerido
number

requerido

Numero de pagina actual desde 1.

videos
opcional
VideoResult[]

Cuando se analizan videos.

Resultados de Google Videos.

VideoResult Schema de item
rank
requerido
number

requerido

Posicion de ranking desde 1 en esta respuesta.

position
opcional
number

Alias de rank cuando esta disponible.

Alias normalizado para clientes que esperan position.

title
requerido
string

requerido

Titulo del resultado.

link
requerido
string

requerido

Enlace principal devuelto por el parser.

url
opcional
string

Presente cuando el enlace se puede normalizar.

URL canonica de destino, normalmente igual a link.

source_url
opcional
string

Solo cuando se observa una URL fuente de Google.

URL original de Google para depuracion y procedencia.

display_url
opcional
string

Cuando se deriva texto visible o dominio.

URL visible o dominio fuente.

source
opcional
string

Cuando se puede analizar origen o canal.

Origen o canal del video.

duration
opcional
string

Cuando aparece duración en el resultado.

Texto de duración del video.

time
opcional
string

Cuando se puede analizar la fecha de publicación.

Texto original de fecha de publicación.

published_at
opcional
string

Alias del tiempo analizado, si existe.

Alias normalizado de fecha de publicación.

thumbnail_url
opcional
string

Cuando Google expone una miniatura.

URL de miniatura.

thumbnail
opcional
string

Alias de thumbnail_url cuando esta disponible.

Alias normalizado de miniatura.

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/videos/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"how espresso machines work"}'
Ejemplo existente de Google
bash
curl -X POST https://api.serpbase.dev/google/videos/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio tutorial",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notas

Busqueda de video, tutoriales y monitoreo.

Si no hay tarjetas de video, se usa extracción de noticias en diseños Google compatibles.

POST
Disponible
/google/maps/detail

Maps Detail

Consulta un lugar de Google Maps por ID. Complementa la búsqueda y tiene su propio precio por solicitud.

type
maps_detail
result
place
Facturacion
3 credits

Consulta un lugar de Google Maps por ID. Complementa la búsqueda y tiene su propio precio por solicitud.

Parametros
feature_id
requerido
string

requerido

Usa el campo feature_id devuelto por los resultados de lugar de Maps Search. Tiene formato 0x...:0x....

hl
opcional
string

opcional

Codigo de idioma. Predeterminado: en.

gl
opcional
string

opcional

Codigo de pais. Predeterminado: us.

id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json
{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}
Abrir en Playground
Campos de respuesta
feature_id
requerido
string

requerido

feature_id resuelto desde la solicitud de detalles.

page
requerido
number

requerido

Siempre 1 para detalles de Maps.

place
opcional
MapsPlace

Cuando se analizan detalles del lugar.

Objeto de detalles de un lugar.

MapsPlace Schema de item
position
opcional
number

Solo Maps Search.

Posición del lugar en resultados locales.

name
requerido
string

requerido

Nombre del lugar.

title
requerido
string

requerido

Alias de name.

feature_id
requerido
string

requerido

ID de elemento de Google Maps.

place_id
opcional
string

Cuando Google lo expone.

ID de lugar de Google.

data_id
opcional
string

Alias de feature_id.

ID de datos de Maps.

cid
opcional
string

Derivado de feature_id si es posible.

CID de Google.

kgmid
opcional
string

Cuando existe en datos de Maps.

ID de máquina del gráfico de conocimiento.

google_maps_url
opcional
string

Cuando Google expone una URL de Maps.

URL de Google Maps.

url
opcional
string

google_maps_url o website como alternativa.

URL principal del lugar.

rating
opcional
number

Cuando hay puntuación.

Puntuación de Google.

types
opcional
string[]

Cuando hay categorías.

Etiquetas de tipo de lugar.

category
opcional
object

Cuando se analiza la categoría.

Datos estructurados de categoría.

address
opcional
string

Cuando hay dirección.

Dirección formateada.

address_components
opcional
object

Cuando hay componentes.

Calle, ciudad, código postal y país.

plus_code
opcional
object

Cuando hay Plus Code.

Plus Codes globales y compuestos.

phone
opcional
string

Cuando hay teléfono.

Número local.

phone_international
opcional
string

Cuando existe.

Número internacional.

phone_uri
opcional
string

Cuando existe.

URI de teléfono.

website
opcional
string

Cuando hay sitio web.

Sitio web del negocio.

website_domain
opcional
string

Cuando hay dominio web.

Dominio web del negocio.

latitude
opcional
number

Cuando hay coordenadas.

Latitud.

longitude
opcional
number

Cuando hay coordenadas.

Longitud.

image
opcional
string

Cuando hay imagen.

Imagen principal del lugar.

thumbnail
opcional
string

Alias de image, si existe.

Alias de imagen principal.

photos
opcional
MapsPhoto[]

Cuando se analizan fotos.

ID, URL, tamaño y coordenadas opcionales de foto.

hours
opcional
Record<string,string>

Cuando se analizan horarios.

Horario por día.

open_status
opcional
object

Cuando hay estado.

Estado de apertura y horario actual.

attributes
opcional
object[]

Cuando se analizan atributos.

Atributos agrupados del lugar.

related_places
opcional
object[]

Cuando hay lugares relacionados.

Lugares relacionados de Maps.

short_description
opcional
string

Cuando hay descripción.

Descripción breve del lugar.

description
opcional
string

Cuando hay descripción.

Descripción extensa del lugar.

snippet
opcional
string

short_description o description como alternativa.

Resumen normalizado.

timezone
opcional
string

Cuando existe.

Zona horaria del lugar.

region
opcional
string

Cuando existe.

Etiqueta de región.

country_code
opcional
string

Cuando existe.

Código de país.

language
opcional
string

Cuando existe.

Código de idioma de Maps.

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/maps/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'
Ejemplo existente de Google
bash
curl -X POST https://api.serpbase.dev/google/maps/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
    "hl": "en",
    "gl": "us"
  }'
Notas

Enriquecimiento de lugares, CRM local y detalles.

Usa feature_id del resultado de Maps Search para detalles. Un feature_id válido pero desconocido devuelve status 1004.

POST
Disponible
/google/maps/reviews

Google Maps Reviews

Primera página de reseñas de Google Maps de un lugar (por data_id): valoración, texto, fecha, fotos y autor. Aún no incluye respuestas del propietario.

type
google_maps_reviews
result
schemas.source_data
Facturacion
2 credits

Primera página de reseñas de Google Maps de un lugar (por data_id): valoración, texto, fecha, fotos y autor. Aún no incluye respuestas del propietario.

Parametros
data_id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

dataID
opcional
string

opcional

data_id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

google_domain
opcional
string

opcional

locale.engine_domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gooogle_domain
opcional
string

opcional

locale.engine_domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

next_page_token
opcional
string

opcional

next_token: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

results
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

topic_id
opcional
string

opcional

attributes.topic_id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/maps/reviews' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"data_id":"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/google/autocomplete

Google Search Autocomplete

Obtén sugerencias de Google por prefijo; no son mediciones de volumen de búsquedas.

type
google_autocomplete
result
schemas.autocomplete
Facturacion
1 credits

Obtén sugerencias de Google por prefijo; no son mediciones de volumen de búsquedas.

Parametros
query
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "weather"

json
{
  "query": "weather"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.autocomplete

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"weather"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/google/patents/detail

Google Patent Details

Obtén una patente de Google Patents por número de publicación: título, resumen, reivindicaciones, inventores, titulares y fechas.

type
google_patents_detail
result
schemas.source_data
Facturacion
2 credits

Obtén una patente de Google Patents por número de publicación: título, resumen, reivindicaciones, inventores, titulares y fechas.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "US8244737B2"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

google_domain
opcional
string

opcional

locale.engine_domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gooogle_domain
opcional
string

opcional

locale.engine_domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

lanaguage
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

patent_id
opcional
string

opcional

id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

results
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "US8244737B2"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/patents/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"US8244737B2"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/google/play/app

Google Play App Details

Obtén una app de Google Play por nombre de paquete: nombre, desarrollador, descripción, precio, versión, fechas de lanzamiento y clasificación por edad.

type
google_play_app
result
schemas.source_data
Facturacion
1 credits

Obtén una app de Google Play por nombre de paquete: nombre, desarrollador, descripción, precio, versión, fechas de lanzamiento y clasificación por edad.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "com.spotify.music"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

google_domain
opcional
string

opcional

locale.engine_domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gooogle_domain
opcional
string

opcional

locale.engine_domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

results
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "com.spotify.music"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/play/app' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"com.spotify.music"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/reddit/post

Reddit Post & Comments

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

type
reddit_post
result
schemas.source_data
Facturacion
2 credits

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

Parametros
url
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "url": "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/reddit/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/tiktok/post

TikTok Post

Consulta una publicación TikTok por ID y usuario; no descubre todas las publicaciones del perfil.

type
tiktok_post
result
schemas.source_data
Facturacion
2 credits

Consulta una publicación TikTok por ID y usuario; no descubre todas las publicaciones del perfil.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "7123456789012345678"

username
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "tiktok"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

post_id
opcional
string

opcional

id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "7123456789012345678",
  "username": "tiktok"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/tiktok/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"7123456789012345678","username":"tiktok"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/tiktok/profile

TikTok Profile

Consulta un perfil TikTok por usuario. Depende del acceso al origen; no es un archivo histórico de audiencia.

type
tiktok_profile
result
schemas.source_data
Facturacion
2 credits

Consulta un perfil TikTok por usuario. Depende del acceso al origen; no es un archivo histórico de audiencia.

Parametros
username
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "tiktok"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "username": "tiktok"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/tiktok/profile' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"username":"tiktok"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/x/post

X Post Details

Consulta una publicación X por ID; no es búsqueda por palabras, exportación de cronología ni streaming.

type
x_post
result
schemas.source_data
Facturacion
1 credits

Consulta una publicación X por ID; no es búsqueda por palabras, exportación de cronología ni streaming.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "1234567890123456789"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

tweetId
opcional
string

opcional

id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "1234567890123456789"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/x/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"1234567890123456789"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/youtube/transcripts

YouTube Video Transcripts

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

type
youtube_transcripts
result
schemas.source_data
Facturacion
2 credits

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "dQw4w9WgXcQ"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

v
opcional
string

opcional

id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

video_link
opcional
string

opcional

url: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "dQw4w9WgXcQ"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/youtube/transcripts' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"dQw4w9WgXcQ"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/ajio/product

Ajio Product Details

Consulta un producto AJIO por URL HTTPS /p/; no exporta catálogos.

type
ajio_product
result
schemas.source_data
Facturacion
2 credits

Consulta un producto AJIO por URL HTTPS /p/; no exporta catálogos.

Parametros
url
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "https://www.ajio.com/sample/p/1234567890"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "url": "https://www.ajio.com/sample/p/1234567890"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/ajio/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.ajio.com/sample/p/1234567890"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/amazon/product

Amazon Product Details

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

type
amazon_product
result
schemas.source_data
Facturacion
2 credits

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

Parametros
asin
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "B08N5WRWNW"

domain
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "amazon.com"

amazon_domain
opcional
string

opcional

domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

type
opcional
string

opcional

search_type: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "asin": "B08N5WRWNW",
  "domain": "amazon.com"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/amazon/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/amazon/reviews

Amazon Product Reviews

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

type
amazon_reviews
result
schemas.source_data
Facturacion
2 credits

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

Parametros
asin
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "B08N5WRWNW"

domain
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "amazon.com"

amazon_domain
opcional
string

opcional

domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

filter_by_star
opcional
string

opcional

review_rating: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

reviewer_type
opcional
string

opcional

review_type: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

type
opcional
string

opcional

search_type: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "asin": "B08N5WRWNW",
  "domain": "amazon.com"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/amazon/reviews' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/amazon/autocomplete

Amazon Search Autocomplete

Obtén sugerencias de Amazon por prefijo, no detalles ni historial de precios.

type
amazon_autocomplete
result
schemas.source_data
Facturacion
1 credits

Obtén sugerencias de Amazon por prefijo, no detalles ni historial de precios.

Parametros
prefix
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "laptop"

amazon_domain
opcional
string

opcional

domain: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mid
opcional
string

opcional

marketplace_id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

type
opcional
string

opcional

search_type: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "prefix": "laptop"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/amazon/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"prefix":"laptop"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/apple/product

Apple Product Details

Consulta apps de App Store por ID numérico o URL apps.apple.com y país; no hardware Apple.

type
apple_product
result
schemas.source_data
Facturacion
1 credits

Consulta apps de App Store por ID numérico o URL apps.apple.com y país; no hardware Apple.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "284882215"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

product_id
opcional
string

opcional

id: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

type
opcional
string

opcional

search_type: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "284882215"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/apple/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"284882215"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/ebay/product

eBay Product Details

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

type
ebay_product
result
schemas.source_data
Facturacion
2 credits

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

Parametros
domain
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "ebay.com"

id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "123456789012"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "domain": "ebay.com",
  "id": "123456789012"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/ebay/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"domain":"ebay.com","id":"123456789012"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/flipkart/product

Flipkart Product Details

Consulta Flipkart por URL de producto con /p/. Usa una URL específica, no una búsqueda.

type
flipkart_product
result
schemas.source_data
Facturacion
2 credits

Consulta Flipkart por URL de producto con /p/. Usa una URL específica, no una búsqueda.

Parametros
url
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "https://www.flipkart.com/item/p/itm1234567890"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "url": "https://www.flipkart.com/item/p/itm1234567890"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/flipkart/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.flipkart.com/item/p/itm1234567890"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/myntra/product

Myntra Product Details

Consulta un producto Myntra por URL /buy; es distinto de la búsqueda.

type
myntra_product
result
schemas.source_data
Facturacion
2 credits

Consulta un producto Myntra por URL /buy; es distinto de la búsqueda.

Parametros
url
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "https://www.myntra.com/shoes/nike/123456/buy"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "url": "https://www.myntra.com/shoes/nike/123456/buy"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/myntra/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.myntra.com/shoes/nike/123456/buy"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/walmart/product

Walmart Product Details

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

type
walmart_product
result
schemas.source_data
Facturacion
2 credits

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

Parametros
id
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "133497934"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "id": "133497934"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/walmart/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"133497934"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/walmart/autocomplete

Walmart Search Autocomplete

Obtén sugerencias de Walmart por consulta; no consulta páginas de producto.

type
walmart_autocomplete
result
schemas.source_data
Facturacion
1 credits

Obtén sugerencias de Walmart por consulta; no consulta páginas de producto.

Parametros
query
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "laptop"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "query": "laptop"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/walmart/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"laptop"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/web/user-agent

User-Agent Generator

Genera UA de escritorio o móvil con user_agent_type y user_agent_count (1–5). La operación local también tiene precio de catálogo.

type
web_user_agent
result
schemas.source_data
Facturacion
1 credits

Genera UA de escritorio o móvil con user_agent_type y user_agent_count (1–5). La operación local también tiene precio de catálogo.

Parametros
user_agent_count
ejemplo
number

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: 1

user_agent_type
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "desktop"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

uanum
opcional
integer

opcional

user_agent_count: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

uatype
opcional
string

opcional

user_agent_type: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "user_agent_count": 1,
  "user_agent_type": "desktop"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/web/user-agent' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"user_agent_count":1,"user_agent_type":"desktop"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/web/crawl

Web Crawl

Inicia un rastreo limitado desde una URL pública. Precio fijo por solicitud, no multiplicado por páginas devueltas.

type
web_crawl
result
schemas.source_data
Facturacion
1 credits

Inicia un rastreo limitado desde una URL pública. Precio fijo por solicitud, no multiplicado por páginas devueltas.

Parametros
url
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "https://example.com"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "url": "https://example.com"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/web/crawl' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://example.com"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

POST
Disponible
/web/scrape

Web Scrape

Extrae páginas públicas HTTP/HTTPS por URL con texto, HTML, Markdown y selectores; se aplican restricciones de origen. No admite páginas de Google; usa los endpoints de Google como /google/search.

type
web_scrape
result
schemas.source_data
Facturacion
1 credits

Extrae páginas públicas HTTP/HTTPS por URL con texto, HTML, Markdown y selectores; se aplican restricciones de origen. No admite páginas de Google; usa los endpoints de Google como /google/search.

Parametros
url
ejemplo
string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "https://example.com"

country
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

cursor
opcional
string

opcional

pagination.cursor: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

custom_headers
opcional
object

opcional

headers: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

device
opcional
string

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

gl
opcional
string

opcional

locale.country: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

hl
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

html
opcional
boolean

opcional

include_html: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

language
opcional
string

opcional

locale.language: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

limit
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

markdown
opcional
boolean

opcional

include_markdown: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

mobile
opcional
boolean

opcional

options.device: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

num
opcional
integer

opcional

pagination.limit: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

page
opcional
integer

opcional

pagination.page: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

q
opcional
string

opcional

query: Alias de parámetros: usa una forma cada vez. La API valida parámetros y valores admitidos.

json
{
  "url": "https://example.com"
}
Abrir en Playground

La respuesta sigue el contrato del producto; aún no se publica un ejemplo registrado.schemas.source_data

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/web/scrape' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://example.com"}'
Notas

Empieza con el ejemplo del catálogo y revisa el JSON real.

El ejemplo no es el contrato completo. Se validan campos conocidos y se permiten parámetros adicionales.

Errores
error
requerido
string

requerido

Mensaje de error legible.

0
SUCCESS

Solicitud completada. Revisa los campos del producto; no_results no prueba HTTP 404.

Cobrado

1000
INVALID_REQUEST

Cuerpo o parámetros ausentes o inválidos.

Sin cobroCorrige la solicitud antes

1001
UNAUTHORIZED

Clave ausente, inválida o revocada.

Sin cobroCorrige la solicitud antes

1004
NOT_FOUND

Recurso no encontrado en rutas o catálogo del gateway.

Sin cobroCorrige la solicitud antes

1020
INSUFFICIENT_CREDITS

Saldo insuficiente.

Sin cobroCorrige la solicitud antes

1029
RATE_LIMITED

Límite QPS o de concurrencia excedido.

Sin cobroSe puede reintentar

1500
INTERNAL_ERROR

Error interno inesperado.

Sin cobroSe puede reintentar

1502
UPSTREAM_FAILED

El worker devolvió error de obtención o análisis del origen.

Sin cobroSe puede reintentar

1503
SERVICE_UNAVAILABLE

No hay sesión de worker disponible.

Sin cobroSe puede reintentar

1504
UPSTREAM_TIMEOUT

El gateway agotó el tiempo esperando al worker.

Sin cobroSe puede reintentar

json
{
  "status": 1001,
  "error": "unauthorized",
  "request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
  "elapsed_ms": 0,
  "credits_charged": 0
}
Cabeceras de respuesta

Cada respuesta incluye estas cabeceras para que tu cliente regule el ritmo y decida si reintentar sin analizar el mensaje.

X-RateLimit-Limit
Solicitudes por segundo que permite tu cuenta.
X-RateLimit-Remaining
Solicitudes que aún caben en el segundo actual.
Retry-After
Si se rechaza, segundos a esperar antes de reenviar.
X-SerpBase-Retryable
true si reenviar la misma solicitud puede funcionar; false si hay que cambiarla.
Al contactar con soporte
Incluye el request_id de la respuesta (lo tienen todas, con éxito o error) y la hora de la llamada. Con él localizamos la solicitud en segundos.
Privacidad y retencion
Las consultas pueden registrarse para facturacion, depuracion, prevencion de abuso y logs de cuenta. Revisa la pagina de privacidad.