API de búsqueda de Yandex

Yandex API de búsqueda para captura de SERP localizada.

Captura la página de resultados de Yandex producida para una región, idioma, dispositivo, página y ventana de tiempo específica. La API devuelve los metadatos de solicitud y la carga útil de HTML de SERP fuente en un sobre JSON para que su aplicación procese.

Empezar gratis Vea Yandex rápido arranque

API GET del lado del servidor · Comience conapi_key + engine=yandex + q · Habla con un experto en datos

Contexto regionalIdentificación de la región de ubicación de Yandex
Control de páginaLenguaje, dispositivo y página
Filtro de tiempoDocumentados dentro de los valores
Respuesta de la fuenteCarga útil de HTML en JSON

Web data workflow · yandex searchReady

Pinta la observación

query pizza

region Moscow

lang ru

fielddevice desktop

stackMantenga la página explícita

stackEnvase de JSON

figurerequest context

figureEl número de personas

{
  "search_parameters": {
    "search_engine": "yandex",
    "query": "pizza"
  },
  "search_results":
    "<html>...</html>"
}

Captura regional ilustrativano datos de clientes ni garantía sobre una página devuelta.Muestra el contexto de la solicitud que viaja con la carga útil de HTML de la SERP fuente.

Los compradores de un contrato de captura pueden evaluar

Conozca el contexto de la página, la carga útil y el límite de propiedad antes de integrarse.

Yandex Search API proporciona a los equipos de productos y datos una superficie de solicitud documentada para capturar páginas localizadas. Su equipo conserva el control del modelo de extracción y cómo cada observación entra en flujos de trabajo en aguas subyacentes.

La intención regional se mantiene visible

Mantenga el ID de la región Yandex y el idioma junto a la página capturada para que las comparaciones posteriores conserven su contexto de mercado.

La presentación es deliberada

Elija el perfil de dispositivo documentado y el número de página en lugar de tratar cada respuesta de Yandex como intercambiable.

El límite de respuesta es explícito

Planifique un envase JSON que contenga la carga útil de HTML SERP fuente en lugar de asumir un modelo de registro en aguas subyacentes.

Las decisiones del esquema se quedan con usted

Extraer sólo los campos que su flujo de trabajo necesita, versión de ese esquema, y decidir cómo se deben manejar los cambios de página.

01
El motoryandex
02
Pregunta .pizza
03
RegiónEl número de personas
04
El lenguajeru
05
Dispositivodesktop
06
Páginap 0
07
Ventanadentro de los 77

Superficie documentada de Yandex

Captura la página de resultados definida por su contexto regional y de presentación.

El punto final de Yandex acepta una consulta de búsqueda plus contexto opcional. Comience con solicitudes representativas para los países, idiomas, dispositivos, páginas y ventanas de tiempo que su aplicación realmente utilizará.

Región

Identificación de ubicación de Yandex

Utilice el identificador de región esperado por Yandex para influir en la página de resultados para la ubicación prevista.

Contexto de la solicitud · lr

Idioma

Lenguaje de búsqueda

Anexe el valor de lenguaje documentado a la observación y valida con la región y el conjunto de consultas.

Contexto de la solicitud · lang

Presentación

Profil del dispositivo

Solicite una presentación de escritorio, móvil o tableta donde el control de dispositivo documentado se adapte a su flujo de trabajo.

Contexto de la solicitud · dispositivo

Ventana de página

Filtro de página y tiempo

Seleccione una página de resultados basada en cero y, cuando sea necesario, un valor documentado del rango de tiempo.

Contexto de la solicitud · p / dentro

Contexto del dominio

Valida el dominio, la región y el idioma juntos.

La referencia de parámetros también documenta la selección opcional de dominio Yandex. Trata la combinación completa de solicitud como la huella digital de observación y verifica las páginas representativas antes de confiar en ella.

Review Yandex parameters

Control de las solicitudes

Definir la página de Yandex que su solicitud tiene la intención de observar.

La guía de solicitudes básicas utiliza el parámetro de consulta que se muestra a continuación. Agregue contexto opcional sólo cuando admita un producto o un requisito de investigación claro.

Intención de búsqueda

Pregunta

Pasar el texto de búsqueda en el campo de solicitudes básicas documentado y espacios de código de URL o caracteres especiales.

q

Localización y presentación

Región, lengua y dispositivo

Establezca el ID de la región de ubicación de Yandex, el idioma de búsqueda y el perfil documentado de escritorio, móvil o tableta.

lr lang device

Ventana de página

Paginación y actualización

Utilice p=0 para la primera página y añada un valor de tiempo soportado como 77 para las últimas 24 horas o 1 para las últimas dos semanas.

p within

Nota de ejecución: use api_key, engine=yandex, yqEl número de página es basado en cero; describe qué página se solicitó, no un rango universal en todos los contextos.

Respuesta de carga de utilidad de la fuente

Reciba un sobre JSON, luego aplica su propio contrato de extracción.

Yandex Search API devuelve los metadatos de respuesta y la representación de la página fuente. Diseñar al consumidor alrededor de ese límite antes de agregar almacenamiento, monitoreo o registros de búsqueda derivados.

Respuesta de la API

Envase JSON con la carga útil de HTML SERP fuente.

El envase incluyesearch_parameterspara el contexto de la búsqueda presentada ysearch_resultspara la carga útil del HTML SERP de origen.

Inspeccione el estado HTTP antes de leer el cuerpo.
Almacenar sólo el contexto de la solicitud y los datos de origen que necesita su flujo de trabajo.
Trate los cambios en la disposición de la página como un evento de extracción y esquema.

application/json source payload{ "search_parameters": { "search_engine": "yandex", "yandex_url": "https://www.yandex.com/search/?text=pizza", "query": "pizza" }, "search_results": "<html>...</html>" }Your application

Extracción y mantenimiento del esquema

Su aplicación posee extracción del HTML devuelto. Su equipo define los campos derivados, reglas de validación, versiones de esquema y respuesta de mantenimiento cuando Yandex actualiza su página.

Frontera de respuesta

El punto final proporciona el contexto de la página y el HTML de origen dentro de JSON. No define los registros, clasificaciones, alertas o interpretación de negocios que puede derivar su sistema.

Una captura contextual

From a Yandex query to an owned extraction pipeline in three steps.

Su aplicación define la página y consume la carga útil de origen. WebScrapingAPI opera el camino de solicitud compatible entre estas dos responsabilidades.

01
Define el contexto de la página
Seleccione la consulta y agregue la región documentada, el idioma, el dispositivo, la página basada en cero y las entradas de rango de tiempo que necesita para su observación.
02
Envía la solicitud del lado del servidor
Llame al punto final de SERP con una clave de API protegida y el motor fijado en yandex. Establezca un tiempo límite y superfície estados HTTP fallidos.
03
Validación, extracto y versión
Lea el sobre JSON, preserve su contexto de solicitud y ejecute el HTML fuente a través del proceso de extracción y esquema de su equipo.

La integración

Haga una solicitud segura de Yandex desde su pila de lado del servidor.

Estos puntos de partida mantienen la clave de API en una variable de entorno, envían la consulta de Solicitudes básicas, utilizan un tiempo de espera del cliente de 120 segundos y hacen explícitos los estados HTTP fallidos.

Breve solicitud

Comience con la consulta documentada de pizza.

Confirme primero la respuesta de la fuente, luego añada los controles regionales, de idioma, de dispositivo, de página y de tiempo requeridos por su producto.

Abre las solicitudes básicas

Punto final: /v2
Requerido: api_key + engine=yandex + q
Secreto: WSA_API_KEYpermanece en el lado del servidor
El consumidor: Compruebe el estado, luego lee JSON

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;

// engine=yandex; q=pizza
var rawApiKey = Environment.GetEnvironmentVariable("WSA_API_KEY");
if (string.IsNullOrWhiteSpace(rawApiKey)) {
    throw new InvalidOperationException("WSA_API_KEY is required");
}
var apiKey = rawApiKey;
using var client = new HttpClient {
    Timeout = TimeSpan.FromSeconds(120)
};
var parameters = new Dictionary<string, string> {
    ["api_key"] = apiKey,
    ["engine"] = "yandex",
    ["q"] = "pizza"
};
var query = string.Join("&", parameters.Select(item =>
    $"{WebUtility.UrlEncode(item.Key)}={WebUtility.UrlEncode(item.Value)}"));
using var response = await client.GetAsync(
    "https://serpapi.webscrapingapi.com/v2?" + query
);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;

// engine=yandex; q=pizza
var rawApiKey = Environment.GetEnvironmentVariable("WSA_API_KEY");
if (string.IsNullOrWhiteSpace(rawApiKey)) {
    throw new InvalidOperationException("WSA_API_KEY is required");
}
var apiKey = rawApiKey;
using var client = new HttpClient {
    Timeout = TimeSpan.FromSeconds(120)
};
var parameters = new Dictionary<string, string> {
    ["api_key"] = apiKey,
    ["engine"] = "yandex",
    ["q"] = "pizza"
};
var query = string.Join("&", parameters.Select(item =>
    $"{WebUtility.UrlEncode(item.Key)}={WebUtility.UrlEncode(item.Value)}"));
using var response = await client.GetAsync(
    "https://serpapi.webscrapingapi.com/v2?" + query
);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;

public final class YandexSearchApiExample {
    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";
        String query = "api_key=" + URLEncoder.encode(
            apiKey, StandardCharsets.UTF_8
        ) + "&engine=yandex&q=pizza";
        var client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(120))
            .build();
        var request = HttpRequest.newBuilder(URI.create(endpoint + "?" + query))
            .timeout(Duration.ofSeconds(120))
            .GET()
            .build();
        var response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );
        if (response.statusCode() < 200 || response.statusCode() >= 300) {
            throw new IllegalStateException(
                "API status " + response.statusCode()
            );
        }
        System.out.println(response.body());
    }
}
}

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;

public final class YandexSearchApiExample {
    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";
        String query = "api_key=" + URLEncoder.encode(
            apiKey, StandardCharsets.UTF_8
        ) + "&engine=yandex&q=pizza";
        var client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(120))
            .build();
        var request = HttpRequest.newBuilder(URI.create(endpoint + "?" + query))
            .timeout(Duration.ofSeconds(120))
            .GET()
            .build();
        var response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );
        if (response.statusCode() < 200 || response.statusCode() >= 300) {
            throw new IllegalStateException(
                "API status " + response.statusCode()
            );
        }
        System.out.println(response.body());
    }
}
}

Casos de uso

Utilice contextual captura de página de Yandex donde la fuente es el punto de partida correcto.

Cada flujo de trabajo debe conservar su huella digital de la solicitud y definir cómo los cambios en la página fuente afectan a la extracción, comparación, revisión y decisiones posteriores.

Visibilidad de búsqueda

Observación de Yandex localizada

Captura páginas para combinaciones de consulta controlada, región, idioma, dispositivo y paginado, y luego calcula las métricas definidas por tu equipo.

Explorar el seguimiento de SERP →

Presencia de marca

Revisado por editores regionales

Extraer los dominios y elementos de página relevantes para un proceso de revisión mientras se conserva el contexto de origen de Yandex.

Explorar la protección de la marca

Investigación de mercado

Paisajes de origen y temas

Construir un esquema de extracción definido para los editores, temas o elementos de la página de resultados requeridos por un resumen de investigación.

Explorar la investigación de mercado →

Programa de datos

Registros de búsqueda recurrentes

Definir un esquema explícito, sellos de tiempo, estados de calidad y contrato de entrega cuando las cargas útiles de la fuente de tiempo de solicitud no sean el producto final.

Revisar los datos de búsqueda →

Selección de producto

Elige por la respuesta y la propiedad operativa que tu equipo necesita.

Yandex Search API es la opción enfocada cuando la página de resultados de Yandex fuente y su contexto de solicitud se ajustan a su aplicación. Ampliar o cambiar la propiedad cuando su requisito cambia.

Multiple engines

API SERP familia

Comparar los contratos de control y respuesta documentados de Google, Bing, DuckDuckGo y Yandex.

Respuestas específicas del motor

Current product

API de búsqueda de Yandex

Envía una consulta de Yandex localizada y recibe el contexto plus la carga útil de HTML SERP fuente en JSON.

Captura de la página fuente de Yandex

General page access

API de scraping

Recoger una página web pública elegible cuando su target no esté representado por los controles de búsqueda de Yandex.

Respuesta de la página pública

Managed delivery

Datos gestionados

Mover conjuntos de consultas, cadencia, esquema, proceso de calidad y entrega en un programa de datos recurrentes acordado.

Contrato de datos operados

Evaluamiento de la producción

Prueba la matriz de página regional de la que dependerá tu solicitud.

Utilice capturas representativas antes de elegir un plan. Incluya estados ordinarios, localizados, paginados, filtrados en tiempo, que cambian de diseño y que no tienen éxito en los dispositivos y regiones en el alcance.

Estima la matriz de solicitud

Tamaño de contextos, páginas y frecuencia juntos.

Formulario ilustrativo de volumen de solicitud de Yandex

Las preguntas × Regiones × Dispositivos × Páginas × Frecuencia

Este es un modelo de evaluación, no una promesa de facturación.

Empezar gratis Ver precios actuales

Lista de verificación de la evaluación

Contexto: Regiones, lenguas y dominios
Presentación: Dispositivos y páginas basadas en cero
Carga útil: Variaciones de HTML fuente
El consumidor: Versiones de extracción y esquema
Operaciones: Los tiempos de espera, errores, retemplajes, almacenamiento

Discuss production requirements

FAQ

Las preguntas de la API de búsqueda de Yandex para una evaluación basada en tierra.

Utilice estas respuestas para la selección de productos, luego trate la documentación actual de los puntos finales y las solicitudes representativas de Yandex como la fuente de verdad de implementación.

Read Basic Requests

¿Qué devuelve la API de búsqueda de Yandex?

Yandex Search API devuelve un envase JSON con metadatos de solicitud y la carga útil de HTML SERP fuente en search_results. No define su esquema de registro en el torrente descendente.

¿Qué valores se requieren para una solicitud de Yandex?

Envía tu clave de API del lado del servidor, configure el motor en yandex y pasa la consulta de búsqueda en q. El texto de la consulta de código URL cuando contiene espacios o caracteres especiales.

¿Cómo escoger la región y el idioma de Yandex?

Utilice lr para el ID de la región de ubicación de Yandex y lang para el idioma de búsqueda.

¿Cómo funciona la paginado de Yandex?

Utilice p para la página de resultado. El conteo de páginas comienza en 0, por lo que p=0 solicita la primera página. Mantenga p con el resto del contexto de la solicitud al comparar capturas.

¿Quién mantiene la extracción de la carga útil de Yandex?

Su aplicación posee extracción de la carga útil de HTML SERP fuente, y su equipo posee el esquema derivado y su mantenimiento a medida que cambian los diseños de la página de Yandex.

¿Cómo debería manejar mi aplicación errores de API de Yandex?

Establezca un tiempo de espera explícito del cliente, inspeccione el estado HTTP antes de usar el cuerpo de respuesta, mantenga el contexto de la solicitud suficiente para diagnosticar fallos y aplique retemplajes limitados solo cuando se ajusten a su flujo de trabajo.

Su primera captura de Yandex

Prueba una página regional y su fuente de carga útil de consumo.

Comience con la solicitud documentada de pizza, luego añada los contextos que su producto realmente observará.

Empezar gratis Habla con un experto en datos

Explorar productos

Infraestructura de proxies

API de acceso web

Datos y feeds

Datos gestionados

Objetivos de negocio

Industria

Tipos de datos

Formación y aterrizaje

Formación multimodal

Fundamentos de datos

Los representantes