Envia solicitudes POST JSON y pasa la API key en X-API-Key. Exito y error devuelven JSON.
Respuesta comun
1 o 2 creditos por solicitud exitosa
support trace id
curl -X POST https://test-api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{"q":"openai realtime api","hl":"en","gl":"us"}'Las respuestas exitosas devuelven la misma metadata superior. Los datos especificos viven en organic, images, news, videos, places o place.
statusnumberrequerido
Codigo de estado de negocio. 0 significa exito.
request_idstringrequerido
ID estable para soporte, reintentos y correlacion de logs.
elapsed_msnumberrequerido
Latencia observada por gateway en milisegundos.
credits_chargednumberrequerido
Creditos cobrados despues de aplicar reembolsos.
search_typestringrequerido
Tipo resuelto: search, images, news, videos, maps_search o maps_detail.
/google/searchResultados organicos estilo Google y modulos SERP.
/google/imagesURLs de imagen, miniaturas, paginas fuente y dominios.
/google/newsArticulos con fuente, tiempo, snippet y miniatura.
/google/videosResultados de video con fuente, duracion, tiempo y miniatura.
/google/maps/searchBusqueda local con coordenadas, contacto, categorias, horarios y fotos.
/google/maps/detailDetalles de un lugar por feature_id de Google Maps.
/google/searchSearch
Resultados organicos estilo Google y modulos SERP.
qstringrequerido
Texto de busqueda.
hlstringopcional
Codigo de idioma. Predeterminado: en.
glstringopcional
Codigo de pais. Predeterminado: us.
pagenumberopcional
Numero de pagina desde 1. Predeterminado: 1.
querystringrequerido
Consulta normalizada de la solicitud.
pagenumberrequerido
Numero de pagina actual desde 1.
organicOrganicResult[]When organic results are parsed.
Organic search results.
top_storiesTopStory[]When the SERP contains top stories.
Top stories module.
people_also_askPAA[]When People Also Ask is present.
Question, answer, and source links.
knowledge_graphKnowledgeGraphWhen a knowledge panel is parsed.
Entity panel data.
related_searchesstring[]When related search suggestions are found.
Related search queries.
ranknumberrequerido
Posicion de ranking desde 1 en esta respuesta.
positionnumberAlias de rank cuando esta disponible.
Alias normalizado para clientes que esperan position.
titlestringrequerido
Titulo del resultado.
linkstringrequerido
Enlace principal devuelto por el parser.
urlstringPresente cuando el enlace se puede normalizar.
URL canonica de destino, normalmente igual a link.
source_urlstringSolo cuando se observa una URL fuente de Google.
URL original de Google para depuracion y procedencia.
display_urlstringCuando se deriva texto visible o dominio.
URL visible o dominio fuente.
display_linkstringWhen Google display text is present.
Raw Google display link text.
snippetstringWhen a snippet is parsed.
Organic result summary.
datestringWhen Google includes a date in the snippet.
Raw date text extracted from snippet.
published_atstringAlias for parsed date when available.
Normalized date alias.
iconstringWhen a favicon/image is exposed.
Result icon URL.
sitelinks{ title, link, url, source_url?, display_url? }[]When sitelinks are present.
Nested sitelinks for the organic result.
curl -X POST https://test-api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio",
"hl": "en",
"gl": "us",
"page": 1
}'Grounding, SEO y extraccion de respuestas.
Search can also return ai_overview, weather, finance, flight, and result_stats when those modules appear in the SERP.
/google/imagesImagenes
URLs de imagen, miniaturas, paginas fuente y dominios.
qstringrequerido
Texto de busqueda.
hlstringopcional
Codigo de idioma. Predeterminado: en.
glstringopcional
Codigo de pais. Predeterminado: us.
pagenumberopcional
Numero de pagina desde 1. Predeterminado: 1.
querystringrequerido
Consulta normalizada de la solicitud.
pagenumberrequerido
Numero de pagina actual desde 1.
imagesImageResult[]When image results are parsed.
Google Images results.
ranknumberrequerido
Posicion de ranking desde 1 en esta respuesta.
positionnumberAlias de rank cuando esta disponible.
Alias normalizado para clientes que esperan position.
titlestringCuando se parsea titulo o alt de la imagen.
Titulo del resultado.
linkstringrequerido
Enlace principal devuelto por el parser.
urlstringPresente cuando el enlace se puede normalizar.
URL canonica de destino, normalmente igual a link.
source_urlstringSolo cuando se observa una URL fuente de Google.
URL original de Google para depuracion y procedencia.
display_urlstringCuando se deriva texto visible o dominio.
URL visible o dominio fuente.
image_urlstringrequerido
Full image URL.
thumbnail_urlstringCuando Google expone una miniatura.
URL de miniatura.
thumbnailstringAlias de thumbnail_url cuando esta disponible.
Alias normalizado de miniatura.
sourcestringWhen source text is parsed.
Image source label.
domainstringWhen source page domain can be derived.
Source page domain.
curl -X POST https://test-api.serpbase.dev/google/images \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "iphone 15 pro blue",
"hl": "en",
"gl": "us",
"page": 1
}'Busqueda visual, monitoreo de productos y fuentes.
Some Google Images payload shapes expose rank/link but not every normalized alias. Treat url, display_url, source_url, position, and thumbnail as optional.
/google/newsNoticias
Articulos con fuente, tiempo, snippet y miniatura.
qstringrequerido
Texto de busqueda.
hlstringopcional
Codigo de idioma. Predeterminado: en.
glstringopcional
Codigo de pais. Predeterminado: us.
pagenumberopcional
Numero de pagina desde 1. Predeterminado: 1.
querystringrequerido
Consulta normalizada de la solicitud.
pagenumberrequerido
Numero de pagina actual desde 1.
newsNewsResult[]When news results are parsed.
Google News results.
ranknumberrequerido
Posicion de ranking desde 1 en esta respuesta.
positionnumberAlias de rank cuando esta disponible.
Alias normalizado para clientes que esperan position.
titlestringrequerido
Titulo del resultado.
linkstringrequerido
Enlace principal devuelto por el parser.
urlstringPresente cuando el enlace se puede normalizar.
URL canonica de destino, normalmente igual a link.
source_urlstringSolo cuando se observa una URL fuente de Google.
URL original de Google para depuracion y procedencia.
display_urlstringCuando se deriva texto visible o dominio.
URL visible o dominio fuente.
sourcestringWhen publisher text is parsed.
Publisher/source label.
timestringWhen Google exposes time text.
Raw published time text.
published_atstringAlias for parsed time when available.
Normalized published time alias.
snippetstringWhen a snippet is parsed.
Article summary snippet.
thumbnail_urlstringCuando Google expone una miniatura.
URL de miniatura.
thumbnailstringAlias de thumbnail_url cuando esta disponible.
Alias normalizado de miniatura.
curl -X POST https://test-api.serpbase.dev/google/news \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "apple event",
"hl": "en",
"gl": "us",
"page": 1
}'Monitoreo de marca, tendencias y medios.
Source and time are parsed from compact Google metadata text, so clients should treat both as optional.
/google/videosVideos
Resultados de video con fuente, duracion, tiempo y miniatura.
qstringrequerido
Texto de busqueda.
hlstringopcional
Codigo de idioma. Predeterminado: en.
glstringopcional
Codigo de pais. Predeterminado: us.
pagenumberopcional
Numero de pagina desde 1. Predeterminado: 1.
querystringrequerido
Consulta normalizada de la solicitud.
pagenumberrequerido
Numero de pagina actual desde 1.
videosVideoResult[]When video results are parsed.
Google Videos results.
ranknumberrequerido
Posicion de ranking desde 1 en esta respuesta.
positionnumberAlias de rank cuando esta disponible.
Alias normalizado para clientes que esperan position.
titlestringrequerido
Titulo del resultado.
linkstringrequerido
Enlace principal devuelto por el parser.
urlstringPresente cuando el enlace se puede normalizar.
URL canonica de destino, normalmente igual a link.
source_urlstringSolo cuando se observa una URL fuente de Google.
URL original de Google para depuracion y procedencia.
display_urlstringCuando se deriva texto visible o dominio.
URL visible o dominio fuente.
sourcestringWhen source/channel can be parsed.
Video source or channel label.
durationstringWhen duration appears in result text.
Video duration text.
timestringWhen posted time can be parsed.
Raw posted time text.
published_atstringAlias for parsed time when available.
Normalized posted time alias.
thumbnail_urlstringCuando Google expone una miniatura.
URL de miniatura.
thumbnailstringAlias de thumbnail_url cuando esta disponible.
Alias normalizado de miniatura.
curl -X POST https://test-api.serpbase.dev/google/videos \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio tutorial",
"hl": "en",
"gl": "us",
"page": 1
}'Busqueda de video, tutoriales y monitoreo.
If no dedicated video cards are parsed, the parser falls back to news-style extraction for compatible Google layouts.
/google/maps/searchMaps Search
Busqueda local con coordenadas, contacto, categorias, horarios y fotos.
qstringrequerido
Texto de busqueda.
hlstringopcional
Codigo de idioma. Predeterminado: en.
glstringopcional
Codigo de pais. Predeterminado: us.
pagenumberopcional
Numero de pagina desde 1. Predeterminado: 1.
latnumberopcional
Latitud del centro del mapa. Debe enviarse con lng.
lngnumberopcional
Longitud del centro del mapa. Debe enviarse con lat.
zoomnumberopcional
Zoom del mapa de 1 a 21. Predeterminado: 14 con coordenadas.
querystringrequerido
Consulta normalizada de la solicitud.
pagenumberrequerido
Numero de pagina actual desde 1.
placesMapsPlace[]When local places are parsed.
Local place results.
positionnumberMaps Search only.
Place rank in the local result list.
namestringrequerido
Place name.
titlestringrequerido
Alias for name.
feature_idstringrequerido
Google Maps feature id.
place_idstringWhen Google exposes it.
Google place id.
data_idstringAlias for feature_id.
Maps data id.
cidstringDerived from feature_id when possible.
Google CID.
kgmidstringWhen present in Maps payload.
Knowledge graph machine id.
google_maps_urlstringWhen Google exposes a Maps URL.
Google Maps URL.
urlstringgoogle_maps_url or website fallback.
Primary place URL.
ratingnumberWhen rating is present.
Google rating.
typesstring[]When categories are present.
Place type labels.
categoryobjectWhen category block is parsed.
Structured category data.
addressstringWhen address is present.
Formatted address.
address_componentsobjectWhen components are present.
Street, city, postal code, country code.
plus_codeobjectWhen plus code is present.
Global and compound plus codes.
phonestringWhen phone is present.
Local phone number.
phone_internationalstringWhen present.
International phone number.
phone_uristringWhen present.
Telephone URI.
websitestringWhen website is present.
Business website.
website_domainstringWhen website domain is present.
Business website domain.
latitudenumberWhen coordinates are present.
Latitude.
longitudenumberWhen coordinates are present.
Longitude.
imagestringWhen image is present.
Primary place image.
thumbnailstringAlias for image when available.
Primary image alias.
photosMapsPhoto[]When photos are parsed.
Photo id, URL, size, and optional coordinates.
hoursRecord<string,string>When hours are parsed.
Opening hours by day.
open_statusobjectWhen status is present.
Open status text and current hours.
attributesobject[]When attributes are parsed.
Grouped place attributes.
related_placesobject[]When related places are present.
Related places from Maps payload.
short_descriptionstringWhen description block is present.
Short place description.
descriptionstringWhen description block is present.
Longer place description.
snippetstringshort_description or description fallback.
Normalized text summary.
timezonestringWhen present.
Place timezone.
regionstringWhen present.
Region label.
country_codestringWhen present.
Country code.
languagestringWhen present.
Language code from Maps payload.
curl -X POST https://test-api.serpbase.dev/google/maps/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "coffee",
"hl": "en",
"gl": "us",
"page": 1,
"lat": 37.7749,
"lng": -122.4194,
"zoom": 14
}'Descubrimiento local, tiendas y auditorias geo.
lat and lng must be sent together. zoom is valid only with coordinates and defaults to 14.
/google/maps/detailMaps Detail
Detalles de un lugar por feature_id de Google Maps.
feature_idstringrequerido
Feature id de Google Maps, con formato 0x...:0x....
hlstringopcional
Codigo de idioma. Predeterminado: en.
glstringopcional
Codigo de pais. Predeterminado: us.
feature_idstringrequerido
Feature id resolved from the Maps detail request.
pagenumberrequerido
Always 1 for maps detail.
placeMapsPlaceWhen place details are parsed.
Single place detail object.
positionnumberMaps Search only.
Place rank in the local result list.
namestringrequerido
Place name.
titlestringrequerido
Alias for name.
feature_idstringrequerido
Google Maps feature id.
place_idstringWhen Google exposes it.
Google place id.
data_idstringAlias for feature_id.
Maps data id.
cidstringDerived from feature_id when possible.
Google CID.
kgmidstringWhen present in Maps payload.
Knowledge graph machine id.
google_maps_urlstringWhen Google exposes a Maps URL.
Google Maps URL.
urlstringgoogle_maps_url or website fallback.
Primary place URL.
ratingnumberWhen rating is present.
Google rating.
typesstring[]When categories are present.
Place type labels.
categoryobjectWhen category block is parsed.
Structured category data.
addressstringWhen address is present.
Formatted address.
address_componentsobjectWhen components are present.
Street, city, postal code, country code.
plus_codeobjectWhen plus code is present.
Global and compound plus codes.
phonestringWhen phone is present.
Local phone number.
phone_internationalstringWhen present.
International phone number.
phone_uristringWhen present.
Telephone URI.
websitestringWhen website is present.
Business website.
website_domainstringWhen website domain is present.
Business website domain.
latitudenumberWhen coordinates are present.
Latitude.
longitudenumberWhen coordinates are present.
Longitude.
imagestringWhen image is present.
Primary place image.
thumbnailstringAlias for image when available.
Primary image alias.
photosMapsPhoto[]When photos are parsed.
Photo id, URL, size, and optional coordinates.
hoursRecord<string,string>When hours are parsed.
Opening hours by day.
open_statusobjectWhen status is present.
Open status text and current hours.
attributesobject[]When attributes are parsed.
Grouped place attributes.
related_placesobject[]When related places are present.
Related places from Maps payload.
short_descriptionstringWhen description block is present.
Short place description.
descriptionstringWhen description block is present.
Longer place description.
snippetstringshort_description or description fallback.
Normalized text summary.
timezonestringWhen present.
Place timezone.
regionstringWhen present.
Region label.
country_codestringWhen present.
Country code.
languagestringWhen present.
Language code from Maps payload.
curl -X POST https://test-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"
}'Enriquecimiento de lugares, CRM local y detalles.
Use feature_id from Maps Search results to request a detail record.
errorstringrequerido
Mensaje de error legible.
Request completed successfully.
Missing or invalid body or parameters.
Missing, invalid, or revoked API key.
Account balance is not enough.
QPS or concurrency limit exceeded.
Unexpected internal server error.
Worker returned an upstream fetch or parse error.
No worker session is available.
Gateway timed out waiting for a worker result.
{
"status": 1001,
"error": "unauthorized",
"request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
"elapsed_ms": 0,
"credits_charged": 0
}