API de pesquisa de Yandex

API de pesquisa do Yandex para captura de SERP localizada.

Capture a página de resultado do Yandex produzida para uma região, idioma, dispositivo, página e janela de tempo específica. A API retorna os metadados de solicitação e a carga útil de HTML SERP fonte em um envelope JSON para a sua aplicação processar.

Comece grátis Visualizar Yandex quickstart

API GET do lado do servidor · Comece comapi_key + engine=yandex + q · Fale com um especialista em dados

Contexto regionalID de localização de Yandex
Controle de páginaLíngua, dispositivo e página
Filtro de tempoDocumentados dentro dos valores
Resposta da fonteCarga útil do HTML em JSON

Web data workflow · yandex searchReady

Fique com a observação

query pizza

region Moscow

lang ru

fielddevice desktop

stackMantenha a página explícita

stackEnvelope JSON

figurerequest context

figure- A Comissão

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

Captura regional ilustrativanão dados do cliente ou garantia sobre uma página devolvida.

Um contrato de captura os compradores podem avaliar

Conheça o contexto da página, carga útil e limites de propriedade antes de integrar.

A API de Pesquisa do Yandex dá às equipes de produtos e dados uma superfície de solicitação documentada para captura de página localizada. A sua equipe mantém o controle do modelo de extração e de como cada observação entra em fluxos de trabalho a jusante.

As intenções regionais permanecem visíveis

Mantenha o ID da região Yandex e a língua ao lado da página capturada para que as comparações posteriores conservem o seu contexto de mercado.

A apresentação é deliberada

Escolha o perfil do dispositivo documentado e o número de página em vez de tratar cada resposta do Yandex como intercâmbio.

O limite de resposta é explícito

Planeje um envelope JSON contendo a carga útil do HTML SERP de origem em vez de assumir um modelo de registro a jusante.

As decisões do esquema ficam com você.

Extrair apenas os campos que seu fluxo de trabalho precisa, versão de que esquema, e decidir como as alterações de página devem ser manuseadas.

01
Motoryandex
02
Pergunta .pizza
03
Região- A Comissão
04
Línguaru
05
Dispositivodesktop
06
Páginap 0
07
Janeladentro de 77

Superfície documentada de Yandex

Capture a página de resultados definida pelo seu contexto regional e de apresentação.

O endpoint do Yandex aceita uma consulta de pesquisa plus contexto opcional. Comece com solicitações representativas para os países, línguas, dispositivos, páginas e janelas de tempo que o aplicativo realmente usará.

Região

ID de localização do Yandex

Use o identificador de região esperado pelo Yandex para influenciar a página de resultados para a localização prevista.

Contexto da solicitação · lr

Idioma

Língua de pesquisa

Anexe o valor de linguagem documentada à observação e valida-o com o conjunto de região e consulta.

Contexto da solicitação · lang

Presentação

Profil do dispositivo

Solicite uma apresentação de desktop, celular ou tablet onde o controle do dispositivo documentado se adapte ao seu fluxo de trabalho.

Contexto da solicitação · dispositivo

Janela de página

Filtro de página e tempo

Selecione uma página de resultados baseada em zero e, se necessário, um valor documentado de intervalo de tempo.

Contexto da solicitação · p / dentro

Contexto do domínio

Validar o domínio, região e idioma juntos.

A referência de parâmetros também documenta a seleção opcional de domínio Yandex.

Review Yandex parameters

Controle de solicitação

Defina a página do Yandex que o seu pedido pretende observar.

O guia de solicitações básicas usa o parâmetro de consulta mostrado abaixo. Adicione contexto opcional apenas quando suporta um produto ou exigência de pesquisa clara.

Intenção de busca

Pergunta

Passe o texto de pesquisa no campo de Requestas Básicas documentado e espaços de codificação de URL ou caracteres especiais.

q

Localização e apresentação

Região, língua e dispositivo

Configure o ID da região de localização do Yandex, a linguagem de pesquisa e o perfil documentado do desktop, celular ou tablet.

lr lang device

Janela de página

Paginação e recência

Use p=0 para a primeira página e adicione um valor de tempo suportado, como 77 para as últimas 24 horas ou 1 para as últimas duas semanas.

p within

Nota de execução: use api_key, engine=yandex, eqO número de página é baseado em zero; descreve qual página foi solicitada, não um ranking universal em todos os contextos.

Resposta à carga de serviço da fonte

Receba um envelope JSON, e depois aplica o seu próprio contrato de extracção.

A API de Pesquisa do Yandex retorna os metadados da resposta e a representação da página fonte. Desenhe o consumidor em torno desse limite antes de adicionar arquivos de armazenamento, monitoramento ou pesquisa derivada.

Resposta à API

Envelope JSON com a carga útil de HTML SERP fonte.

O envelope incluisearch_parameterspara o contexto da pesquisa submetida esearch_resultspara a carga útil do HTML SERP de origem.

Verifique o status HTTP antes de ler o corpo.
Armazenar apenas o contexto da solicitação e os dados de origem necessários ao seu fluxo de trabalho.
Trate as alterações no layout da página como um evento de extração e 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

Extração e manutenção de esquemas

O seu aplicativo possui extração do HTML devolvido. Sua equipe define os campos derivados, regras de validação, versões de esquema e resposta de manutenção quando o Yandex atualiza sua página.

Limite de resposta

O endpoint fornece conteúdo de página e HTML fonte dentro do JSON. Não define os registros, classificações, alertas ou interpretação de negócios que o seu sistema pode derivar.

Uma captura contextual

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

O seu aplicativo define a página e consome a carga útil fonte. WebScrapingAPI opera o caminho de solicitação suportado entre essas duas responsabilidades.

01
Defina o contexto da página
Escolha a consulta e adicione a região documentada, idioma, dispositivo, página baseada em zero e entradas de intervalos de tempo que você precisa de observação.
02
Enviar a solicitação do lado do servidor
Ligue para o endpoint do SERP com uma chave API protegida e motor definido para o yandex.
03
Validação, extrato e versão
Leia o envelope JSON, preserve o contexto da solicitação e execute o HTML fonte através do processo de extração e esquema da sua equipe.

Integração

Faça uma solicitação segura do Yandex a partir da sua pilha do lado do servidor.

Estes pontos de partida mantêm a chave API em uma variável do ambiente, enviam a consulta Requerências Básicas, usam um tempo de cliente de 120 segundos e tornam explícitos os estados HTTP falhos.

Resumo do pedido

Comece com a consulta documentada de pizza.

Confirme a resposta da fonte primeiro, e adicione os controles regionais, linguagem, dispositivo, página e tempo necessários para o seu produto.

Abre as solicitações básicas

Ponto final: /v2
Requerido: api_key + engine=yandex + q
Segredo: WSA_API_KEYpermanece do lado do servidor
Consumidor: Verifique o status, e leia 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 utilização

Use contextual página de Yandex captura onde a fonte é o ponto de partida certo.

Cada fluxo de trabalho deve preservar a sua impressão digital de pedido e definir como as alterações na página fonte afetam a extração, comparação, revisão e decisões a seguir.

Visível de pesquisa

Observação localizada de Yandex

Capture páginas para combinações de consulta controlada, região, idioma, dispositivo e pagination, e depois calcule as métricas definidas pela sua equipe.

Explore o monitoramento do SERP →

Presença da marca

Revisão de editores regionais

Extrair os domínios e elementos de página relevantes para um processo de revisão, preservando o contexto original do Yandex.

Explora a protecção da marca

Pesquisa de mercado

Paisagens de origem e de tópicos

Construir um esquema de extração definido para os editores, tópicos ou elementos da página de resultados necessários para um resumo de pesquisa.

Explorar a pesquisa de mercado →

Programa de dados

Registros de pesquisa recorrentes

Defina um esquema explícito, selos de tempo, estados de qualidade e contrato de entrega quando as cargas úteis da fonte de tempo de solicitação não são o produto final.

Revisar os dados de pesquisa →

Selecção do produto

Escolha pela resposta e propriedade operacional que a sua equipa precisa.

A API de Pesquisa do Yandex é a opção focada quando a página de resultados do Yandex fonte e seu contexto de solicitação se encaixam no seu aplicativo.

Multiple engines

API SERP família

Compare os contratos de controle e resposta documentados do Google, Bing, DuckDuckGo e Yandex.

Respostas específicas do motor

Current product

API de pesquisa de Yandex

Envie uma consulta Yandex localizada e receba o contexto plus a carga útil do HTML SERP fonte em JSON.

Captura de página fonte do Yandex

General page access

API de scraping

Obter uma página web pública elegível quando o seu target não for representado pelos controles de pesquisa do Yandex.

Resposta à página pública

Managed delivery

Dados geridos

Mover conjuntos de consultas, cadência, esquema, processo de qualidade e entrega para um programa de dados recorrentes acordado.

Contrato de dados operacionais

Avaliação da produção

Teste a matriz de página regional da sua aplicação.

Use captações representativas antes de escolher um plano. Inclua estados comuns, localizados, paginados, filtrados por tempo, que mudam de layout e não têm sucesso em todos os dispositivos e regiões no escopo.

Estima a matriz de solicitação

Tamanho dos contextos, páginas e frequência juntos.

Fórmula ilustrativa de volume de pedido de Yandex

Questões × Regiões × Dispositivos × Páginas × Frequência

Este é um modelo de avaliação, não uma promessa de faturamento.

Comece grátis Veja preços atuais

Lista de verificação de avaliação

Contexto: Regiões, línguas e domínios
Presentação: Dispositivos e páginas baseadas em zero
Carga útil: Variantes de HTML de fonte
Consumidor: Versões de extracção e esquema
Operações: Outras temporadas, erros, retemptadas, armazenamento

Discuss production requirements

FAQ

Perguntas da API de Pesquisa Yandex para uma avaliação fundamentada.

Use essas respostas para a seleção de produtos, então trate a documentação atual do endpoint do Yandex e as solicitações representativas como a fonte de verdade de implementação.

Read Basic Requests

O que a API de pesquisa do Yandex retorna?

A API de Pesquisa do Yandex retorna um envelope JSON com metadados de solicitação e a carga útil de HTML SERP fonte em search_results. Não define o seu esquema de registro descendente.

Quais valores são necessários para uma solicitação de Yandex?

Envie a chave API do lado do servidor, configure o motor para o yandex e passe a consulta de pesquisa em q. O texto da consulta de codificação de URL quando contém espaços ou caracteres especiais.

Como escolho a região e a língua do Yandex?

Use lr para o ID da região de localização do Yandex e lang para a linguagem de pesquisa. Um domínio do Yandex também pode ser selecionado quando documentado; valida a combinação com pesquisas representativas antes da utilização da produção.

Como funciona a pagination do Yandex?

Use p para a página de resultado. A contagem de páginas começa em 0, então p=0 solicita a primeira página. Mantenha p com o resto do contexto da solicitação ao comparar captures.

Quem mantém a extração da carga útil do Yandex?

A sua aplicação possui extração da carga útil de HTML SERP fonte, e a sua equipe possui o esquema derivado e a sua manutenção à medida que os layouts de páginas do Yandex mudam.

Como meu aplicativo deve lidar com erros de API do Yandex?

Configure um tempo limite explícito para o cliente, inspecione o status HTTP antes de usar o corpo de resposta, retenha conteúdo suficiente para diagnosticar falhas e aplique retemps limitados apenas quando se encaixam no seu fluxo de trabalho.

A tua primeira captura de Yandex .

Teste uma página regional e o seu consumidor de carga útil de origem.

Comece com o pedido documentado de pizza, e depois adicione os contextos que o seu produto realmente observará.

Comece grátis Fale com um especialista em dados

Explorar produtos

Infraestrutura de proxies

APIs de acesso à web

Datasets & feeds

Dados geridos

Objetivos de negócios

Indústria

Tipos de dados

Formação e aterragem

Formação multimodal

Fundamentos de dados

Proxies