La forme de réponse indiquée à l'avance
Sachez si le moteur renvoie des collections de résultats analysés ou une charge utile de la SERP source avant de concevoir le consommateur.
API SERP
API SERP pour les résultats de recherche structurés
Recevez les résultats Google et Bing en JSON structuré. Capturez le HTML des SERP DuckDuckGo et Yandex dans une enveloppe JSON, avec paramètres de requête et de localisation.
- Sortie à la connaissance du moteurCollections analysées ou charges utiles provenant de sources
- Context de rechercheLocalisation, langage et appareil
- Récupération géréeAccès à la recherche pris en charge
- Des formes documentéesModèle de réponse indiqué par moteur
Les données de recherche sans le scraper
Choisissez un moteur de recherche et un format de réponse
Le contexte reste attaché
Gardez les entrées du moteur, de la requête, de la localisation, de la langue, du dispositif, de la verticale et de la pagination à côté de chaque observation.
Les travaux d'accès sont effectués
WebScrapingAPI exécute le chemin de récupération de recherche pris en charge et maintient une gestion documentée des réponses.
L'option reste explicite
Pour les points d'extrémité analysés, les collections de résultats facultatives ne s'affichent que lorsque le SERP retourné les expose; l'absence n'est pas automatiquement une défaillance de collecte.
- Moteurgoogle
- Je vous demande .running shoes
- LocaliséUS · en
- Présentationmobile
- Type de rechercheweb
- Pagestart 0
- Observationrequest time
Conserver l'empreinte digitale de la demande avec les résultats stockés afin que les comparaisons restent similaires.
Couverture documentée
Commencez par le moteur et recherchez la surface dont vous avez besoin.
Chaque moteur a ses propres paramètres et sa forme de réponse. Choisissez d'abord le point de fin, puis validez les types de résultats requis avec des requêtes représentatives.
Famille Google
Cherchez plus surfaces dédiées à Google.
Google Search prend en charge les contrôles documentés du Web, des images, des vidéos, des nouvelles, des achats et des emplois.
googlegoogle_asyncgoogle_mapsgoogle_flightsgoogle_maps_reviewsgoogle_reverse_imagegoogle_trendsgoogle_hotelsRésultats analysés et connus du marché
Recevoir des collections de résultats JSON documentées avec des contrôles de marché, de localisation, de langue, de recherche sécurisée, de compensation et de comptage des résultats.
Charge utile de la SERP source avec contexte
Recevez les métadonnées de la demande et la charge utile de l'HTML SERP source à l'intérieur d'une enveloppe JSON, avec des contrôles de région, de langage d'interface, de recherche sécurisée, de rang de temps et de périphérique documentés.
Charge utile de la SERP source avec contexte
Recevez les métadonnées de la demande et la charge utile de l'HTML SERP source à l'intérieur d'une enveloppe JSON, avec des contrôles de localisation, de langue, d'appareil, de page et de rang de temps documentés.
Limite de couverture: Un nom de moteur n'implique pas de contrôles ou de partage identiques. Google et Bing document parcourus collections de résultats JSON; DuckDuckGo et Yandex document une enveloppe JSON contenant la charge utile HTML SERP source. La documentation de point d'extrémité actuelle reste la source de production de vérité.
Réponse du moteur
Construire pour le modèle de réponse chaque documentation moteur.
Les collections analysées et les charges de source nécessitent différents consommateurs. Sélectionnez d'abord le moteur, validez sa forme de réponse actuelle et préservez le contexte de la demande à côté de la sortie.
Context de recherche
Les méta-données de moteur, de requête et de réponse exposées par le point final sélectionné.
search_parameters · generalCollections de résultats analysés
Titres, liens, descriptions, positions observées et modules facultatifs où documentés et retournés.
organic[] · related[] · module?Charge utile de la source SERP
La charge utile HTML source est renvoyée à l'intérieur de l'enveloppe JSON; votre application possède toute extraction de celle-ci.
search_results: "<html>…</html>"Enveloppe de demande
Ajoutez des identifiants d'exécution, des timestamps demandés, des identifiants de requête-groupe et des versions de schéma lorsque les résultats entrent dans vos systèmes.
run_id · observed_at · schemaLes commandes de recherche Google
Configurez votre requête
Commencez par la requête requise. Ajoutez seulement le contexte documenté nécessaire pour rendre l'observation utile et comparable.
Que doit chercher le moteur ?
Utilisez la requête, une verticale prise en charge ou le contrôle de recherche d'emploi documenté.
qtbmibpQuel contexte de recherche devrait apparaître?
Définir les valeurs de domaine pris en charge, de localisation codée, de langue, de pays et d'appareil.
domainuulehlgldeviceQuelle fenêtre de résultats devrait revenir?
Utilisez le décalage documenté et le nombre de résultats demandés pour la fenêtre de page dont vous avez besoin.
startnumengine=google
Utilisez le chemin documenté standard lorsque l'application doit attendre la réponse actuelle.
Review synchronous parametersengine=google_async
Utilisez le flux de travail documenté dédié lorsque la recherche Google en file d'attente correspond à la charge de travail.
Review asynchronous workflowUne seule demande
De la requête au résultat
- 01
Définir l'observation
Choisissez le moteur, la requête et les paramètres de localisation, de langue, de périphérique, de type de recherche et de pagination pris en charge.
- 02
Envoyez la demande
Appeler le serveur côté SERP terminal avec votre clé API. WebScrapingAPI exploite la prise en charge de la récupération et de la gestion de la réponse.
- 03
Validation et utilisation
Inspectez l'état HTTP et la forme de réponse spécifique au moteur, puis conservez le contexte requis par le classement, l'extraction, l'alerte ou les flux de travail de recherche.
L'intégration
Connectez-vous depuis votre serveur
Gardez la clé API à l'extérieur du code côté client, des valeurs de recherche de code URL, définissez un délai et inspectez les échecs HTTP avant de parser la réponse.
Rapport de demande
Commencez par une requête représentative.
Utilisez le même moteur, le même marché, le même langage, le même appareil et le même type de recherche sur lesquels votre produit sera basé dans la production.
- Le secret
WSA_API_KEYreste côté serveur- Réservé
api_key+engine+q- Contextes
gl+hl+device- Consommateur
- Statut de l'inspection et collections facultatives
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.bodyPropriété opérationnelle
Ce que nous gérons et ce que vous contrôlez
WebScrapingAPI exploite
- Validation de la demande et exécution du moteur supporté
- Infrastructure d'accès à la recherche et gestion interne
- Collections de résultats analysés lorsque documentées
- Enveloppe JSON documentée et livraison de charge utile source
- Maintenir le comportement endpoint pris en charge
Votre équipe possède
- Groups de requêtes, marchés, langues, appareils et types de recherche
- Programmaison des applications et politique de réessayer au niveau de l'API
- Tout extraction requise à partir des points d'extrémité de la charge utile source
- Stockage, calculs de rang, comparaisons et alertes
- Politiques d'utilisation, de conservation et de décision des données
Limite de décision: 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 Accord de service and applicable requirements.
Cas d'utilisation
Transformer les observations de recherche contextuelle en flux de travail mesurables.
Choix de produit
Comparez vos options
Infrastructure de proxys
Proxys
Network accessAPI d'accès au WebVotre équipe possède le client de recherche, la logique d'accès, l'analyse, la maintenance et le modèle de résultats.
API de scraping
Page responseAPI d'accès au WebWebScrapingAPI récupère une page publique admissible alors que votre demande possède l'extraction.
API SERP
Engine-specific SERP responseAPI d'accès au WebEnvoyez une requête de recherche prise en charge et recevez des collections parsemées où elles sont documentées, ou une charge utile SERP source à l'intérieur d'une enveloppe JSON.
API de navigateur
Guided browser requestLivraison géréeUtilisez une demande REST soutenue par le navigateur avec des attentes documentées et des étapes d'interaction lorsque les paramètres SERP spécifiques au moteur ne conviennent pas.
Données gérées
Recurring data programWebScrapingAPI exploite un ensemble de requêtes convenu, la cadence, le schéma, le processus de qualité et la livraison.
Évaluation de la production
Choisissez un forfait adapté à votre charge de travail
Taille de la matrice de contextepas seulement la liste de mots clés.
QuestionsMarchésAppareilsPagesFréquence
La formule est un modèle de planification, pas une promesse de facturation.
FAQ
Questions sur le produit
Quel est le nombre de API SERP ?
API SERP est un point final du côté du serveur pour envoyer une requête de recherche avec un contexte documenté et recevoir la forme de réponse prise en charge par ce moteur. Google et Bing document parcouru les collections de résultats JSON; DuckDuckGo et Yandex document une enveloppe JSON contenant des métadonnées de requête et la charge utile HTML SERP source.
Qu'est-ce que le API SERP est revenu ?
La réponse dépend du moteur sélectionné. Google et Bing document JSON métadonnées plus collections de résultats analysés. DuckDuckGo et Yandex document JSON métadonnées plus la charge utile de source SERP HTML, que votre application peut stocker ou extraire selon son propre modèle de données.
Quelles fonctionnalités peuvent apparaître dans les résultats de recherche?
Pour les moteurs avec des collections parsemées documentées, les modules retournés dépendent du moteur, de la requête, de l'emplacement, de l'appareil et du type de recherche. Les résultats organiques et les modules spécifiques aux points d'extrémité tels que les annonces, les éléments locaux, les achats, les médias ou les recherches connexes ne s'affichent que lorsque la page de recherche retournée les expose.
Comment fonctionnent les contrôles de localisation, de langue et d'appareil?
Utilisez les paramètres documentés pour le moteur sélectionné. Google recherche documents domaine, emplacement codé, langue d'interface, pays, et les contrôles de bureau, mobile ou tablette; d'autres moteurs utilisent leurs propres paramètres de marché et de localisation.
Le API SERP prend-il en charge les demandes asynchrones ?
La documentation comprend un moteur de recherche Google asynchrone dédié pour la récupération en file d'attente. Traitez le comportement asynchrone comme spécifique au point d'extrémité et utilisez la documentation du flux de travail actuel lors de la mise en œuvre de la soumission et de la récupération des résultats.
Qui maintient le partage lorsque les mises en page de recherche changent ?
WebScrapingAPI maintient la gestion de réponse prise en charge et les collections analysées où la documentation des points d'extrémité les fournit. DuckDuckGo et Yandex renvoient actuellement la charge utile du SERP HTML source dans une enveloppe JSON, de sorte que votre équipe possède toute extraction de cette charge utile ainsi que son modèle de données interne et ses décisions en aval.
Comment ma demande doit-elle traiter les réponses vides ou infructueuses?
Inspectez l'état HTTP et le corps d'erreur documenté, utilisez des tentatives limitées le cas échéant et distinguer une demande ratée d'une réponse de recherche réussie dans laquelle une collection de résultats facultatives est absente ou vide.
Votre première observation
Testez votre première requête Google
Utilisez l’essai Google de 100 requêtes pour vérifier mots-clés, lieux et sortie avant de choisir un forfait mensuel.