Tiedot on lähetettävä JSON-massana. Jokaisen elementin on sisällettävä seuraavat kentät.
Raja
JSON-massassa voi olla 100 elementtiä, joten voit luoda 100 SERPs-haavistoa yhdellä kutsulla.
post
https://api.semscraper.com/v1/serp
https://api.semscraper.com/v1/serp
Luvat : Bearer {api_key}
Parametrit
search_engine
Vaadittu
string
Hakukoneen valinta :
Google-haku (arvo: google_search)
keyword
Vaadittu
string
Hakukoneen hakusanat
device
Vaadittu
string
Alustan valinta :
Tietokone (arvo: pöytäkone)
Mobile (arvo: mobile)
depth
Vaadittu
integer
Sivun syvyys, haemme Googlen SERP-verkkosivuja sivukohtaisesti. Tämän parametrin on oltava välillä 1 (noin 10 tulosta) ja 10 (noin 100 tulosta).
location
Vaadittu
string
Hakukoneen sijaintikoodi
language
Vaadittu
string
Hakukoneen kieli
geolocation
string
Mahdollistaa Googlen SERP-sivujen maantieteellisen sijainnin määrittämisen. Voit esimerkiksi ilmoittaa kaupungin, departementin tai maan pilkulla erotettuna.
priority
integer
Käytetään pyyntöjen priorisointiin, ja ne käsitellään alenevassa tärkeysjärjestyksessä. Arvo välillä 1 (alhainen) ja 10 (korkea).
callback_url
string
Voit määrittää URL-osoitteen, johon lähetämme hakusanan tulokset, kun ne on käsitelty.
Tiedot on lähetettävä JSON-massana. Jokaisen elementin on sisällettävä seuraavat kentät.
Raja
JSON-massassa voi olla 100 elementtiä, joten voit luoda 100 SERPs-haavistoa yhdellä kutsulla.
post
https://api.semscraper.com/v1/serp
https://api.semscraper.com/v1/serp
Luvat : Bearer {api_key}
Parametrit
search_engine
Vaadittu
string
Hakukoneen valinta :
Google Maps (arvo: google_maps)
keyword
Vaadittu
string
Hakukoneen hakusanat
depth
Vaadittu
integer
Sivun syvyys, haemme Googlen SERP-verkkosivuja sivukohtaisesti. Tämän parametrin on oltava välillä 1 (noin 10 tulosta) ja 10 (noin 100 tulosta).
location
Vaadittu
string
Hakukoneen sijaintikoodi
language
Vaadittu
string
Hakukoneen kieli
geolocation
string
Mahdollistaa Googlen SERP-sivujen maantieteellisen sijainnin määrittämisen. Voit esimerkiksi ilmoittaa kaupungin, departementin tai maan pilkulla erotettuna.
priority
integer
Käytetään pyyntöjen priorisointiin, ja ne käsitellään alenevassa tärkeysjärjestyksessä. Arvo välillä 1 (alhainen) ja 10 (korkea).
callback_url
string
Voit määrittää URL-osoitteen, johon lähetämme hakusanan tulokset, kun ne on käsitelty.
Luettelo valmistuneiden SERP-luetteloiden tunnisteista (ID), joita et ole vielä hakenut.
Tämän menetelmän avulla voit saada kaikkien sellaisten SERP-verkkosivujen tunnukset, joita on jo käsitelty, mutta joita ei ole vielä haettu. Voit sitten kutsua SERP-haun menetelmää käyttämällä näitä tunnuksia.
SERP:ien palauttaminen takaisinsoitto-URL:n kautta
Voit saada SERP-tuloksen suoraan URL-osoitteeseen, jonka annat meille kyselyä luodessasi. Sinun tarvitsee vain hakea käytettyyn API-avaimeen liittyvä HMAC-avain.
Koodi
PHP
Python
Javascript
Ruby
Java
C#
GO
// 1) Read the raw body (JSON)
$raw = file_get_contents('php://input');
// Middleware to parse JSON and keep raw body for HMAC verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString(); // Save raw body for signature check
}
}));
app.post("/callback", (req, res) => {
// 1) Read the raw body (JSON)
const raw = req.rawBody;
// Use timing-safe comparison to avoid timing attacks
if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) {
return res.status(401).type("text").send("Invalid signature");
}
// 4) Decode the JSON (Express already did it in req.body)
let data;
try {
data = req.body;
} catch (err) {
return res.status(400).type("text").send("Invalid JSON");
}
// 5) Process the data
// data contains what the client sent in the payload
// For example: data.id, data.results, etc.
// 6) Respond in JSON (optional, we log these responses for tracking purposes)
res.status(200).json({
status: "ok",
received_at: new Date().toISOString(),
echo: data.id || null
});
});
// 4) Decode the JSON
Map data;
try {
data = new com.fasterxml.jackson.databind.ObjectMapper().readValue(raw, Map.class);
} catch (Exception e) {
return ResponseEntity.status(HttpStatus.BAD_REQUEST)
.contentType(MediaType.TEXT_PLAIN)
.body("Invalid JSON");
}
// 5) Process the data
// data contains what the client sent in the payload
// For example: data.get("id"), data.get("results"), etc.
// 6) Respond in JSON (optional, we log these responses for tracking purposes)
Map response = new HashMap<>();
response.put("status", "ok");
response.put("received_at", Instant.now().toString());
response.put("echo", data.get("id"));
// Helper method: secure string comparison (to avoid timing attacks)
private boolean secureCompare(String a, String b) {
if (a == null || b == null || a.length() != b.length()) {
return false;
}
int result = 0;
for (int i = 0; i < a.length(); i++) {
result |= a.charAt(i) ^ b.charAt(i);
}
return result == 0;
}
// Helper method: convert bytes to hex string
private String bytesToHex(byte[] bytes) {
StringBuilder hexString = new StringBuilder(2 bytes.length);
for (byte b : bytes) {
String hex = Integer.toHexString(0xff & b);
if (hex.length() == 1) hexString.append('0');
hexString.append(hex);
}
return hexString.toString();
}
}
PHP
Python
Javascript
Ruby
Java
C#
GO
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
const string SHARED_SECRET = "HMAC_KEY";
app.MapPost("/callback", async (HttpRequest request, HttpResponse response) =>
{
// 1) Read the raw body (JSON)
using var reader = new StreamReader(request.Body);
var raw = await reader.ReadToEndAsync();
// 2) Retrieve the headers
var signature = request.Headers["X-Signature"].FirstOrDefault() ?? "";
// 3) (Optional) Verify the HMAC signature
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(SHARED_SECRET));
var hash = hmac.ComputeHash(Encoding.UTF8.GetBytes(raw));
var expected = Convert.ToHexString(hash).ToLowerInvariant();
// 5) Process the data
// data contains what the client sent in the payload
// For example: data["id"], data["results"], etc.
// 6) Respond in JSON (optional, we log these responses for tracking purposes)
var jsonResponse = new
{
status = "ok",
received_at = DateTime.UtcNow.ToString("o"), // ISO 8601
echo = data != null && data.ContainsKey("id") ? data["id"] : null
};
Tarkastele SERPien lukumäärää niiden tilan mukaan:
Käyttäjä on suorittanut ja hakenut tulokset (status=done, fetched=true).
Suoritettu loppuun, mutta käyttäjä ei ole hakenut tuloksia (status=done, fetched=false).
Prosessissa (status=processing)
Odottaa (status=pending)
