Construir una huella digital precisa de la solicitud
Describa la consulta, el dominio de Google, la ubicación codificada, el idioma de la interfaz, el país, el dispositivo, la superficie y la ventana de resultados requeridos por el flujo de trabajo.
API de búsqueda de Google para datos de SERP
Recopila resultados de Google como JSON estructurado para seguimiento de posiciones, investigación competitiva y herramientas de búsqueda. Define ubicación, idioma, dispositivo y tipo de búsqueda.
From query to usable objects
Sigue la visibilidad en búsquedas por mercado
Trabajo con colecciones analizadas
Lea metadatos documentados y matrices de resultados en lugar de vincular su aplicación a la marca de presentación de una página de búsqueda.
Opcionalidad de modelo honestamente
Tratar los módulos de búsqueda como condicionales. Su presencia varía con el contexto de la solicitud y la superficie de Google devuelta para esa observación.
Mantenga posible el análisis de pareja
Almacenar el contexto de la solicitud junto a los resultados antes de calcular posiciones, cambios, cobertura de editores o señales específicas de productos.
- Pregunta .mejores zapatos de senderos
- Dominiogoogle.com
- LocalizaciónU.S. · lugar codificado
- El lenguajeen
- Presentaciónmóvil · web
- VentanaInicio 0 · número 10
- ProducciónMetadatos + colecciones
Guarde esta huella digital con la respuesta analizada antes de comparar posiciones, módulos o editores a lo largo del tiempo.
Superficies de Google documentadas
Seleccione la superficie de búsqueda antes de diseñar el consumidor.
Los resultados web regulares utilizan el motor de Google sin un selector vertical. Los controles documentados amplían el mismo modelo de solicitud a las superficies de medios, comercio y puestos de trabajo.
Superficie por defecto
Buscar en la web
Envía engine=google y lo requerido q - ¡ Deje de aquí ! tbm no se ha configurado para los resultados de búsqueda regulares de Google.
Descubrimiento visual
Las imágenes
Configure el selector vertical documentado en TBC = IHS.
Cuidado con la intención
Los vídeos
Configure el selector vertical documentado en tbm=vid.
Cobertura actual
Noticias
Configure el selector vertical documentado en Tbm=nws.
Descubrimiento del producto
Compras
Configure el selector vertical documentado en TBM = tienda.
Descubrimiento de roles
Trabajos
Utilice el valor de los puestos de trabajo documentados ibp=htl;jobs.
Parámetros de solicitud
Configura tu solicitud
Comience con el parámetro de consulta requerido. Agregue controles opcionales documentados solo cuando el flujo de trabajo necesita una superficie, presentación, localización o ventana de resultados en particular.
q
Las palabras clave para buscar en Google.
cadena · requeridatbm ibp
tbm selecciona imágenes documentadas, videos, noticias o verticales de compras. ibp El valor de búsqueda de empleo documentado.
device
Seleccione una presentación de búsqueda de escritorio, móvil o tableta compatible.
cuerdas · opcionalesdomain
Seleccione el dominio de Google utilizado para la búsqueda.
cuerdas · opcionalesuule
Pasar una ubicación codificada de Google para el contexto de búsqueda.
cuerdas · opcionaleshl gl
hl establece el lenguaje de interfaz; gl proporciona el código de país utilizado para localizar la búsqueda.
start num
start es el resultado compensado para saltarse; num solicita el número de resultados en cada página.
Respuesta de Google analizada
Diseño en torno a significados estables y módulos condicionales.
La respuesta documentada contiene metadatos de búsqueda y colecciones de resultados JSON analizados. Los bloques presentes en una respuesta específica dependen de la consulta, el lugar, el dispositivo y la vertical de búsqueda.
01 · contexto
general
Motor de búsqueda, recuento de resultados, idioma, ubicación, presentación, tipo de búsqueda, título de página y campos de timestamp mostrados por el ejemplo de respuesta documentada.
02 · solicitud de seguimiento
input
Solicitar información como la URL original y los campos de agente de usuario mostrados en el ejemplo de respuesta documentada.
03 · caminos de descubrimiento
navigation
Las entradas de navegación devueltas pueden identificar otras superficies de búsqueda de Google para la consulta.
04 · resultados analizados
organic[]
Los objetos orgánicos documentados incluyen campos como enlace, enlace de visualización, título, descripción, rango y rango global cuando se devuelven.
Una solicitud contextual
De la solicitud al resultado
- 01Enmarque la observación
Seleccione la consulta, la superficie de búsqueda, el dominio de Google, la ubicación codificada, el idioma, el país, el dispositivo y la ventana de página requerida por la decisión.
- 02Llame al punto final del lado del servidor
Envía una solicitud de GET a
https://serpapi.webscrapingapi.com/v2withapi_key,engine=google, yq. - 03Validación antes de su uso
Inspeccione el resultado HTTP, analice JSON, lea las colecciones que necesita su flujo de trabajo y preserve el contexto de la solicitud con los resultados almacenados.
Solicitud sincrónica
engine=google
Utilice el camino estándar cuando la aplicación deba esperar la respuesta de Google analizada en curso.
Recuperación en fila
engine=google_async
Envía una búsqueda en Google y recupera la carga útil terminada de SERP más tarde a través de la API Snapshot.
La integración
Conecta desde tu servidor
Mantenga la clave de API en la configuración del lado del servidor, codifique los valores de la consulta, establezca un tiempo de espera explícito y permita que los resultados HTTP no tengan éxito antes de analizar la respuesta.
: "${WSA_API_KEY:?WSA_API_KEY is required}"
curl --get --fail-with-body --max-time 120 \
"https://serpapi.webscrapingapi.com/v2" \
--data-urlencode "api_key=$WSA_API_KEY" \
--data-urlencode "engine=google" \
--data-urlencode "q=best trail shoes" \
--data-urlencode "gl=us" \
--data-urlencode "hl=en" \
--data-urlencode "device=mobile"const apiKey = process.env.WSA_API_KEY;
if (!apiKey) throw new Error("WSA_API_KEY is required");
const parameters = new URLSearchParams({
"api_key": apiKey,
"engine": "google",
"q": "best trail shoes",
"gl": "us",
"hl": "en",
"device": "mobile",
});
const response = await fetch(
"https://serpapi.webscrapingapi.com/v2?" + parameters,
{ signal: AbortSignal.timeout(120_000) }
);
if (!response.ok) {
throw new Error("Google Search API status " + response.status);
}
console.log(await response.json());import os
import requests
api_key = os.environ.get("WSA_API_KEY")
if not api_key:
raise RuntimeError("WSA_API_KEY is required")
response = requests.get(
"https://serpapi.webscrapingapi.com/v2",
params={
"api_key": api_key,
"engine": "google",
"q": "best trail shoes",
"gl": "us",
"hl": "en",
"device": "mobile",
},
timeout=120,
)
response.raise_for_status()
print(response.json())<?php
$apiKey = getenv("WSA_API_KEY");
if ($apiKey === false || $apiKey === "") {
throw new RuntimeException("WSA_API_KEY is required");
}
$endpoint = "https://serpapi.webscrapingapi.com/v2"
. "?engine=google"
. "&api_key=" . rawurlencode($apiKey)
. "&q=" . rawurlencode("best trail shoes")
. "&gl=us&hl=en&device=mobile";
$client = curl_init($endpoint);
curl_setopt_array($client, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($client);
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
$error = curl_error($client);
curl_close($client);
if ($body === false) throw new RuntimeException($error);
if ($status >= 400) throw new RuntimeException("API status " . $status);
echo $body;package main
import (
"fmt"
"io"
"net/http"
"net/url"
"os"
"time"
)
func main() {
apiKey := os.Getenv("WSA_API_KEY")
if apiKey == "" { panic("WSA_API_KEY is required") }
endpoint := "https://serpapi.webscrapingapi.com/v2?engine=google" +
"&api_key=" + url.QueryEscape(apiKey) +
"&q=" + url.QueryEscape("best trail shoes") +
"&gl=us&hl=en&device=mobile"
client := &http.Client{Timeout: 120 * time.Second}
response, err := client.Get(endpoint)
if err != nil { panic(err) }
defer response.Body.Close()
if response.StatusCode >= 400 {
panic(fmt.Sprintf("API status %d", response.StatusCode))
}
body, err := io.ReadAll(response.Body)
if err != nil { panic(err) }
fmt.Println(string(body))
}import java.net.URI;
import java.net.URLEncoder;
import java.net.http.*;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
public final class GoogleSearchApiExample {
public static void main(String[] args) throws Exception {
String apiKey = System.getenv("WSA_API_KEY");
if (apiKey == null || apiKey.isBlank()) {
throw new IllegalStateException("WSA_API_KEY is required");
}
String endpoint = "https://serpapi.webscrapingapi.com/v2"
+ "?engine=google"
+ "&api_key=" + URLEncoder.encode(
apiKey, StandardCharsets.UTF_8)
+ "&q=" + URLEncoder.encode(
"best trail shoes", StandardCharsets.UTF_8)
+ "&gl=us&hl=en&device=mobile";
var request = HttpRequest.newBuilder(URI.create(endpoint))
.timeout(Duration.ofSeconds(120))
.GET().build();
var response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() < 200 || response.statusCode() >= 300) {
throw new RuntimeException("API status " + response.statusCode());
}
System.out.println(response.body());
}
}
using System;
using System.Net;
using System.Net.Http;
var rawApiKey = Environment.GetEnvironmentVariable("WSA_API_KEY");
if (string.IsNullOrWhiteSpace(rawApiKey)) {
throw new InvalidOperationException("WSA_API_KEY is required");
}
var apiKey = WebUtility.UrlEncode(rawApiKey);
var query = WebUtility.UrlEncode("best trail shoes");
var endpoint = "https://serpapi.webscrapingapi.com/v2"
+ "?engine=google&api_key=" + apiKey
+ "&q=" + query
+ "&gl=us&hl=en&device=mobile";
using var client = new HttpClient();
client.Timeout = TimeSpan.FromSeconds(120);
var response = await client.GetAsync(endpoint);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());require "net/http"
require "uri"
api_key = ENV["WSA_API_KEY"]
raise "WSA_API_KEY is required" if api_key.nil? || api_key.empty?
api_key = URI.encode_www_form_component(api_key)
query = URI.encode_www_form_component("best trail shoes")
uri = URI("https://serpapi.webscrapingapi.com/v2" +
"?engine=google&api_key=#{api_key}&q=#{query}" +
"&gl=us&hl=en&device=mobile")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.open_timeout = 10
http.read_timeout = 120
response = http.get(uri.request_uri)
unless response.is_a?(Net::HTTPSuccess)
raise "API status #{response.code}"
end
puts response.body- Punto final
https://serpapi.webscrapingapi.com/v2- Requerido
api_key+engine=google+q- Contexto
gl=us+hl=en+device=mobile- Fronteras
120 segundos de tiempo de espera del cliente y manejo explícito de errores HTTP
Flujos de trabajo de compradores
Convertir las observaciones comparables de Google en señales específicas de productos.
Inteligencia de SEOExplore search monitoringVisibilidad de la marcaExplore brand protectionInvestigación de mercadoExplore market researchContrato de datos de búsquedaReview search-result data
Monitoreo de posición y módulos
Compara las posiciones orgánicas devueltas y los módulos opcionales en consultas controladas, locales, dispositivos y ventanas de resultados.
Presencia de editor y dominio
Observe los dominios devueltos para los grupos de consultas aprobados manteniendo las reglas de ausencia y importancia dentro de su aplicación.
Paisajes de temas y fuentes
Map devolvió editores, títulos y descripciones en contextos de búsqueda y períodos de revisión comparables.
Registros históricos de SERP
Definir el esquema, la marca de tiempo de observación, la huella digital de la solicitud, los estados de validación y el modelo de retención necesarios más allá del tiempo de solicitud JSON.
Selección de producto
Compara tus opciones
Acceso a la redProducto actual Recuperación interactiva
Proxies
Tu equipo posee el cliente de búsqueda, la lógica de recuperación, el análisis, el modelo de respuesta y el mantenimiento.
Infraestructura Recuperación de páginasAPI de scraping
Solicite una página pública elegible mientras su aplicación posea la extracción y su esquema descendente.
API de acceso a la webAPI de búsqueda de Google
Envía una consulta contextual de Google y consuma metadatos documentados plus colecciones de resultados analizados.
API de navegador
Utilice una solicitud REST respaldada por el navegador con pasos de espera documentados y interacción cuando los parámetros de búsqueda de Google no sean adecuados.
API de acceso a la web Entrega operativaDatos gestionados
Concordar el conjunto de consultas, la cadencia, el esquema, el proceso de calidad y la entrega con WebScrapingAPI.
Programa de datosEvaluamiento de la producción
Elige un plan para tu carga de trabajo
Estimar las observacionesno solo las palabras clave.
Las preguntas
Contexto
Superficies
Las ventanas
Frecuencia
Este es un modelo de planificación. los precios actuales y los términos del plan siguen siendo la fuente comercial de la verdad.
FAQ
Preguntas sobre el producto
¿Qué devuelve la API de búsqueda de Google?
Google Search API devuelve el contexto de la solicitud y las colecciones de resultados JSON analizadas. Los resultados orgánicos se documentan, mientras que la navegación y otros módulos de respuesta dependen de la consulta, el lugar, el dispositivo y la superficie de búsqueda solicitada.
¿Qué parámetros de búsqueda de Google puedo controlar?
Utilice q para la consulta requerida. Los controles opcionales documentados incluyen tbm, ibp, dispositivo, dominio, uule, hl, gl, inicio y num para la superficie de búsqueda, presentación, localización y paginado.
¿Qué superficies de búsqueda de Google están documentadas?
Deja TBm sin ajustar para la búsqueda web regular, o usa valores de TBm documentados para imágenes, videos, noticias y compras. Jobs utiliza el control de ibp documentado. Valida la forma devuelta para las superficies que necesita tu aplicación.
¿Debería cada respuesta contener los mismos módulos de resultados?
No. Los módulos de resultados de Google varían según la consulta, el lugar, el dispositivo y la vertical de búsqueda. Trate los bloques de respuesta como opcionales, distingue una colección ausente de una solicitud HTTP fallida y sólo lea los módulos que necesita su aplicación.
¿Cuándo debería usar google_async?
Utilice el motor google_async documentado por separado cuando su flujo de trabajo debe enviar una búsqueda de Google y recuperar la carga útil SERP terminada a través de la API Snapshot. El motor google estándar es el camino de solicitud sincrónica que se muestra en esta página.
¿Cómo puedo integrar la API de búsqueda de Google de forma segura?
Mantenga api_key en una variable del entorno del lado del servidor, valores de consulta de código de URL, establezca un tiempo límite explícito e inspeccione el estado HTTP antes de analizar JSON. Preserva el contexto de la solicitud junto a las observaciones almacenadas.
Su primera observación en Google
Prueba tu primera consulta de Google
Usa la prueba de 100 solicitudes de Google para comprobar palabras clave, ubicaciones y salida antes de elegir un plan mensual.