Forma da resposta indicada de antemão
Saber se o motor retorna coleções de resultados analisados ou uma carga útil da SERP fonte antes de projetar o consumidor.
API SERP
API SERP para resultados de pesquisa estruturados
Receba resultados do Google e Bing em JSON estruturado. Capture o HTML das SERPs do DuckDuckGo e Yandex em respostas JSON, com controles de consulta e localização.
- Output de motor conscienteColeções ou cargas úteis de origem analisadas
- Contexto de pesquisaLocalização, idioma e dispositivo
- Recuperação gerenciadaAcesso de pesquisa com suporte
- Formas documentadasModelo de resposta indicado por motor
Dados de busca sem o raspador
Escolha um buscador e um formato de resposta
O contexto permanece ligado
Mantenha as entradas do motor, da consulta, do local, da linguagem, do dispositivo, vertical e da pagination ao lado de cada observação.
Funcionamento de acesso
WebScrapingAPI executa o caminho de recuperação de pesquisa suportado e mantém o tratamento documentado das respostas.
A opção continua explícita
Para os endpoints analisados, as coleções opcionais de resultados aparecem apenas quando o SERP retornado as expõe; a ausência não é automaticamente uma falha de coleção.
- Motorgoogle
- Pergunta .running shoes
- LocaisUS · en
- Presentaçãomobile
- Tipo de pesquisaweb
- Páginastart 0
- Observaçãorequest time
Preservar a impressão digital da solicitação com resultados armazenados para que as comparações permaneçam iguais.
Cobertura documentada
Comece com o motor e pesquise a superfície do seu fluxo de trabalho.
Cada motor tem seus próprios parâmetros e forma de resposta. Escolha primeiro o ponto final, e depois valida os tipos de resultados necessários com consultas representativas.
Família do Google
Procure plus superfícies dedicadas do Google.
O Google Search suporta controles documentados de web, imagem, vídeo, notícias, compras e empregos. Os endpoints dedicados cobrem superfícies adicionais do Google.
googlegoogle_asyncgoogle_mapsgoogle_flightsgoogle_maps_reviewsgoogle_reverse_imagegoogle_trendsgoogle_hotelsResultados analisados e conscientes do mercado
Receber colecções de resultados JSON documentadas com controles de mercado, localização, idioma, busca segura, compensação e contagem de resultados.
Fonte de SERP carga útil com contexto
Receba metadados de solicitação e a carga útil do HTML SERP fonte dentro de um envelope JSON, com região documentada, linguagem de interface, busca segura, intervalo de tempo e controles de dispositivo.
Fonte de SERP carga útil com contexto
Receba metadados de solicitação e a carga útil do HTML SERP fonte dentro de um envelope JSON, com controles documentados de localização, idioma, dispositivo, página e intervalo de tempo.
Limite de cobertura: um nome do motor não implica controles ou análise idênticos. Google e Bing documentados analisaram coleções de resultados JSON; DuckDuckGo e Yandex documentar um envelope JSON contendo a fonte SERP HTML carga útil. A documentação do ponto final atual continua a ser a fonte de produção de verdade.
Resposta consciente do motor
Construir para o modelo de resposta cada documento do motor.
As coleções analisadas e as cargas de fonte exigem diferentes consumidores. Selecione o motor primeiro, valide sua forma de resposta atual e preserve o contexto da solicitação ao lado da saída.
Contexto de pesquisa
Metadados de motor, consulta e nível de resposta expostos pelo ponto final selecionado.
search_parameters · generalColeções de resultados analisados
Títulos, links, descrições, posições observadas e módulos opcionais, quando documentados e devolvidos.
organic[] · related[] · module?Fonte de carga útil SERP
A carga útil HTML fonte é devolvida dentro do envelope JSON; o seu aplicativo possui qualquer extração dele.
search_results: "<html>…</html>"Envelope de aplicação
Adicione IDs de execução, timestamps solicitados, identificadores de grupos de consulta e versões de esquema quando os resultados forem inseridos em seus sistemas.
run_id · observed_at · schemaControle de pesquisa do Google
Configure sua solicitação
Comece com a consulta necessária. Adicione apenas o contexto documentado necessário para tornar a observação útil e comparável.
O que é que o motor deve procurar?
Use a consulta, uma vertical suportada ou o controle de pesquisa de empregos documentados.
qtbmibpQue contexto de busca deve aparecer?
Defina os valores de domínio suportado, localização codificada, idioma, país e dispositivo.
domainuulehlgldeviceQue fenômeno de resultados deve retornar?
Use o offset documentado e o conteúdo de resultados solicitados para a janela de página que você precisa.
startnumengine=google
Use o caminho documentado padrão quando a aplicação deve esperar a resposta atual.
Review synchronous parametersengine=google_async
Use o fluxo de trabalho documentado dedicado quando a busca de Google em fila se encaixa na carga de trabalho. Não suponha que o comportamento assíncrono seja compartilhado por todos os motores.
Review asynchronous workflowUm pedido
Da solicitação ao resultado
- 01
Define a observação
Escolha o motor, consulta e localização suportada, idioma, dispositivo, tipo de pesquisa e parâmetros de pagination.
- 02
Enviar a solicitação
Ligue para o endpoint SERP do lado do servidor com a sua chave API. WebScrapingAPI opera a recuperação e o tratamento de resposta suportados.
- 03
Validação e utilização
Inscreva o status HTTP e a forma de resposta específica do motor, e retenha o contexto necessário para classificação, extração, alerta ou fluxos de trabalho de pesquisa.
Integração
Conecte pelo seu servidor
Mantenha a chave API fora do código do lado do cliente, os valores de busca de código de URL, defina um prazo e inspecione estados HTTP falhos antes de analisar a resposta.
Resumo do pedido
Comece com uma pergunta representativa.
Use o mesmo motor, mercado, idioma, dispositivo e tipo de pesquisa em que o seu produto dependerá na produção.
- Segredo
WSA_API_KEYpermanece do lado do servidor- Requerido
api_key+engine+q- Contexto
gl+hl+device- Consumidor
- Estatuto da inspecção e colecções opcionais
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=running shoes" \
--data-urlencode "gl=us" \
--data-urlencode "hl=en" \
--data-urlencode "device=mobile"import os
import requests
response = requests.get(
"https://serpapi.webscrapingapi.com/v2",
params={
"api_key": os.environ["WSA_API_KEY"],
"engine": "google",
"q": "running shoes",
"gl": "us",
"hl": "en",
"device": "mobile",
},
timeout=120,
)
response.raise_for_status()
print(response.json())const parameters = new URLSearchParams({
api_key: process.env.WSA_API_KEY,
engine: "google",
q: "running 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("API status " + response.status);
console.log(await response.json());<?php
$parameters = http_build_query([
"api_key" => getenv("WSA_API_KEY"),
"engine" => "google",
"q" => "running shoes",
"gl" => "us",
"hl" => "en",
"device" => "mobile",
]);
$client = curl_init("https://serpapi.webscrapingapi.com/v2?" . $parameters);
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() {
parameters := url.Values{}
parameters.Add("api_key", os.Getenv("WSA_API_KEY"))
parameters.Add("engine", "google")
parameters.Add("q", "running shoes")
parameters.Add("gl", "us")
parameters.Add("hl", "en")
parameters.Add("device", "mobile")
client := &http.Client{Timeout: 120 * time.Second}
response, err := client.Get(
"https://serpapi.webscrapingapi.com/v2?" + parameters.Encode(),
)
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 SerpApiExample {
public static void main(String[] args) throws Exception {
String queryString = "api_key=" + URLEncoder.encode(
System.getenv("WSA_API_KEY"), StandardCharsets.UTF_8
) + "&engine=google&q=running%20shoes"
+ "&gl=us&hl=en&device=mobile";
var request = HttpRequest.newBuilder()
.uri(URI.create("https://serpapi.webscrapingapi.com/v2?" + queryString))
.timeout(Duration.ofSeconds(120))
.GET().build();
var response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() >= 400) {
throw new RuntimeException("API status " + response.statusCode());
}
System.out.println(response.body());
}
}
using System;
using System.Net;
var apiKey = WebUtility.UrlEncode(
Environment.GetEnvironmentVariable("WSA_API_KEY")
);
var requestUrl =
"https://serpapi.webscrapingapi.com/v2?api_key=" + apiKey +
"&engine=google&q=running%20shoes" +
"&gl=us&hl=en&device=mobile";
using var client = new HttpClient();
client.Timeout = TimeSpan.FromSeconds(120);
var response = await client.GetAsync(requestUrl);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());require "net/http"
require "uri"
uri = URI("https://serpapi.webscrapingapi.com/v2")
uri.query = URI.encode_www_form(
api_key: ENV.fetch("WSA_API_KEY"),
engine: "google",
q: "running shoes",
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)
raise "API status #{response.code}" unless response.is_a?(Net::HTTPSuccess)
puts response.bodyPropriedade operacional
O que gerenciamos e o que você controla
WebScrapingAPI opera
- A validação do pedido e a execução do motor suportada
- Infraestrutura de acesso à pesquisa e gestão interna
- Coleções de resultados analisados, quando documentadas
- Envelope JSON documentado e entrega de carga de pagamento de fonte
- Manutenção do comportamento de endpoint suportado
A sua equipa é proprietária
- Grupos de consultas, mercados, idiomas, dispositivos e tipos de pesquisa
- Programação de aplicações e política de retestamento a nível da API
- Qualquer extração necessária a partir de pontos finais de carga útil de origem
- Armazenamento, cálculos de classificação, comparações e alertas
- Políticas de utilização, retenção e decisão de dados
Limite de decisão: SERP API does not define a universal rank, decide whether an absence is commercially meaningful, or operate your downstream analytics. Use eligible public results in line with the Acordo de serviço and applicable requirements.
Casos de utilização
Transformar as observações de pesquisa contextual em fluxos de trabalho mensuráveis.
Selecção do produto
Compare suas opções
Infraestrutura de proxies
Proxies
Network accessAPI de acesso à webA sua equipa possui o cliente de busca, a lógica de acesso, a análise, a manutenção e o modelo de resultados.
API de scraping
Page responseAPI de acesso à webWebScrapingAPI recupera uma página pública elegível enquanto o seu pedido possui extração.
API SERP
Engine-specific SERP responseAPI de acesso à webEnviar uma consulta de pesquisa suportada e receber coleções analisadas onde documentadas, ou uma carga útil da fonte SERP dentro de um envelope JSON.
API de navegador
Guided browser requestEntrega gerenciadaUse uma solicitação REST com suporte do navegador com espera documentada e passos de interação quando os parâmetros SERP específicos do motor não se encaixem adequadamente.
Dados geridos
Recurring data programWebScrapingAPI opera um conjunto de consultas acordado, cadência, esquema, processo de qualidade e entrega.
Avaliação da produção
Escolha um plano para sua carga de trabalho
Dimensão da matriz de contextonão apenas a lista de palavras-chave.
QuestõesMercadosDispositivosPáginasFrequência
A fórmula é um modelo de planejamento, não uma promessa de faturamento.
FAQ
Perguntas sobre o produto
O que é API SERP?
API SERP é um endpoint do lado do servidor para enviar uma consulta de pesquisa com contexto documentado e receber a forma de resposta suportada por esse mecanismo. O documento do Google e do Bing analisou as coleções de resultados JSON; DuckDuckGo e Yandex documentam um envelope JSON contendo metadados de solicitação e a carga útil HTML da fonte SERP.
O que é que o API SERP retorna?
O documento JSON plus as coleções de resultados analisadas. DuckDuckGo e Yandex documento JSON metadados plus a fonte SERP HTML carga útil, que o seu aplicativo pode armazenar ou extrair de acordo com seu próprio modelo de dados.
Que características podem aparecer nos resultados de pesquisa?
Para motores com coleções documentadas, os módulos devolvidos dependem do motor, consulta, localização, dispositivo e tipo de pesquisa. Os resultados orgânicos e módulos específicos de endpoint, como anúncios, elementos locais, compras, mídia ou pesquisas relacionadas, aparecem apenas quando a página de pesquisa devolvida os expõe.
Como funciona o controle de localização, linguagem e dispositivo?
Use os parâmetros documentados para o motor selecionado. O Google Search documenta domínio, localização codificada, idioma de interface, país e controles de desktop, dispositivo móvel ou tablet; outros motores usam seus próprios parâmetros de mercado e localização.
O API SERP suporta os pedidos assíncronos?
A documentação inclui um motor de pesquisa Google assíncrono dedicado para obtenção em fila. Trate o comportamento assíncrono como específico do endpoint e siga a documentação de fluxo de trabalho atual ao implementar o envio e a obtenção de resultados.
Quem mantém a análise quando as configurações de pesquisa mudam?
WebScrapingAPI mantém o processamento de respostas suportado e as coleções analisadas onde a documentação do endpoint as fornece. DuckDuckGo e Yandex atualmente retornam a carga útil da fonte SERP HTML em um envelope JSON, então sua equipe possui qualquer extração dessa carga útil, bem como seu modelo de dados interno e decisões a jusante.
Como deve o meu pedido lidar com respostas vazias ou sem sucesso?
Inscreva o status HTTP e o corpo de erro documentado, use retries limitadas quando apropriado e distingue uma solicitação fracassada de uma resposta de pesquisa bem-sucedida em que uma coleção de resultados opcionais está ausente ou vazia.
A sua primeira observação
Teste sua primeira consulta do Google
Use o teste de 100 solicitações do Google para conferir palavras-chave, locais e saída antes de escolher um plano mensal.