万有引擎
搜索⌘K
中文
登录免费开始

全网搜索 · 数据 API

Yandex

Yandex API

从 Yandex Maps 商户与 Market 商品两类对象入手，按城市读取地点和商品信息，区分商户点评、商品价格及店铺评分，供俄语市场资料整理使用。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

3

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Yandex 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcategory, lang, language, location, max_price, min_price, sort默认 20 · 最多 100同步$1.39 / 千次id · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform
marketkeywordcity, max_price, min_price, region, sort默认 20 · 最多 100同步$1.39 / 千次id · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform
reviewsurllanguage, sort默认 20 · 最多 200同步$1.39 / 千次id · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform

Yandex 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Yandex 市场与地点搜索 API？

market

使用 platform="yandex"、action="market" 调用“市场与地点搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、price、currency、rating 等 17 个字段。

Yandex market 的参数分别是什么意思？

keyword必填
search 的地图商户关键词，market 的商品关键词；地图点评与电商商品不是同一数据集。
city可选
market 的城市选择，例如 moscow 莫斯科、saint_petersburg 圣彼得堡；按完整允许值选取，不用于地图 search 的 location。

官方配送说明将方式、时间和费用与城市及商品关联，准确条件见商品和结算页面；用于提醒商品搜索价格不等于最终配送总价或配送承诺。官方来源：Yandex Market：配送条件取决于城市和商品来源核查：

查看全部 16 个允许值

chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburg

max_price可选
对应 action 的最高价格条件，与 min_price 配合；不是最高评分。
min_price可选
market 为商品最低价，search 为地图商户价格筛选，两者价格含义不同；不应把商户价位直接当商品单价或 API 费用。
region可选
market 的数字城市地区码，默认 213（莫斯科）；不是 RU 国家代码。优先使用更明确的 city，传 city 会覆盖 region。
sort可选
search 使用 relevance、distance；market 使用 popular、top_rated；reviews 使用 newest、relevance、top_rated、lowest_rated。不可跨 action 混用。
查看全部 2 个允许值

populartop_rated

Yandex 特有返回字段与含义（5）
shop_name
店铺名（市场类目用）。
shop_rating
店铺评分。
is_available
是否有货。
stock
库存。
purchase_count
购买数。

怎么调用 Yandex 评价 API？

reviews

使用 platform="yandex"、action="reviews" 调用“评价”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、text、rating、rating_scale、posted_at 等 17 个字段。

Yandex reviews 的参数分别是什么意思？

url必填
reviews 的地图商户完整 URL，也可在 url 中直接填 businessId；不是 Yandex Market 商品链接。
language可选
search 的默认界面语言 ru，reviews 默认 en；search 显式传 lang 时覆盖 language。

官方说明当评价语言不同于界面语言时可能显示翻译，并可切回原文；因此本 API 的语言参数不能直接当作评论原文语言或翻译保证。官方来源：Yandex Maps：评价原文与界面翻译来源核查：

sort可选
search 使用 relevance、distance；market 使用 popular、top_rated；reviews 使用 newest、relevance、top_rated、lowest_rated。不可跨 action 混用。
查看全部 4 个允许值

lowest_ratednewestrelevancetop_rated

Yandex 特有返回字段与含义（6）
business_id
商家 ID。
business_name
商家名称。
business_rating
商家评分。
business_review_count
商家评价数。
owner_reply
商家回复。
dislike_count
点踩数。
Yandex search 调用流程一次 Yandex search 调用的全过程：向 POST /api/v1/social 发送 platform="yandex"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、name、text、address 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "yandex"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurlnametextaddress
一次 Yandex search 调用的全过程：向 POST /api/v1/social 发送 platform="yandex"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、name、text、address 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

Yandex 原始字段名

EveryInfra 统一字段名

左边是 Yandex 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Yandex 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 5 个字段名只在 Yandex 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • is_open_now
  • purchase_count
  • business_id
  • business_rating
  • business_review_count

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
text
正文内容，已去除 HTML 标签。长文可能被截断。
address
详细地址，原文透传。
city
城市名，用原平台的语言书写，未做中英归一。
country
国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
categories
商家分类。
rating
评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
phone
联系电话，原文透传，未做号码格式归一。
website
账号或商家填写的外链网址。
lat
纬度。
lng
经度。
is_open_now
当前是否营业。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
title
标题。平台无标题概念时（如纯文本帖）为 null。
price
价格数值，不含货币符号；币种见 currency。
currency
价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
rating_count
参与评分的人数。null 表示不公开，不等于 0。
purchase_count
购买数。
category
分类名称，取值为原平台的分类体系，未做跨平台归一。
shop_name
店铺名（市场类目用）。
shop_rating
店铺评分。
stock
库存。
is_available
是否有货。
image_url
图片链接。多图能力可能返回 image_urls 数组。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
language
内容语言代码（如 zh、en），由平台判定，可能不准。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
dislike_count
点踩数。
comment_count
评论数。null 表示不公开，不等于 0。
author_name
作者昵称（显示名）。
owner_reply
商家回复。
business_id
商家 ID。
business_name
商家名称。
business_rating
商家评分。
business_review_count
商家评价数。

请求填写示例

search 使用地图商户关键词，这里查圣彼得堡博物馆；不是通用网页搜索。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

yandex_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"yandex","action":"search","params":{"keyword":"музей Санкт-Петербург"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "name": null,
  "text": null,
  "address": null,
  "city": null,
  "country": null,
  "categories": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "phone": null,
  "website": null,
  "lat": null,
  "lng": null,
  "is_open_now": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

怎样在指定城市查找 Yandex Maps 商户？

search 用 keyword 查地图商户，location 指定城市，category 指定业务类别，适合核对地址、营业状态和联系方式。

查看 search 的 category 参数 →
  • location 默认 Moscow；地图 search 不使用电商 market 的 city。category 如 restaurants、cafes、coffee_shops 对应不同商户类别，none 表示不指定；它们不是商品分类。lang 明确传入时覆盖 language，不能视为自动翻译或原文语言保证。
  • rating 与 review_count 描述商户评分信息，lat、lng 是地理坐标，is_open_now 是返回时的营业标记而非持续营业保证。本 action 不带逐条评论正文；商户价位参数不能当作电商单件售价或接口调用费用。

怎样按 Yandex Market 城市比较商品与店铺？

market 用 keyword 搜商品，以 city 选择市场城市，再比较商品价格、评分和店铺信息。

查看 market 的 city 参数 →
  • city 使用 moscow、saint_petersburg 等目录允许值，并覆盖原始 region；它与地图 search 的 location 不是同一个参数。min_price/max_price 是商品价格条件，sort 的 popular 与 top_rated 分别按热度和评分，不与地图 distance 混用。
  • price 必须结合 currency，rating 是商品评分而 shop_rating 是卖家评分；rating_count、review_count、purchase_count 不是同一个数量。stock 与 is_available 不是库存锁定或可配送保证，最终配送方式、时效和费用仍取决于城市、商品及下单页面。

怎样区分 Yandex 商户单条评价与总体评分？

reviews 用地图商户完整 URL 或直接在 url 中填写 businessId，读取评价原文、评分与商家回复。

查看 reviews 的 url 参数 →
  • url 不接受 Yandex Market 商品对象作为商户评价目标；language 默认 en，sort 默认 newest，但当前未公布评价排序 allowedValues，不能借用 search 或 market 的枚举。界面语言与文本原始语言不同，不把 language 当作已验证的翻译开关。
  • rating 是单条评价分数，business_rating 是商户总体评分；url 返回商户地址，不一定是评价永久链接。text 最多保留 3000 字符、owner_reply 最多 1500 字符，comment_count 仅是数量，不含回复树；缺少字段不等于没有回复或零评价。

Yandex API 常见问题

Yandex API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="yandex"、action 和 params。以 search 为例，必填 keyword，可选 category、lang、language、location。search 使用地图商户关键词，这里查圣彼得堡博物馆；不是通用网页搜索。 Yandex 共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Yandex API 怎么收费？

$1.39 / 千次，Yandex 全部 3 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Yandex 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Yandex API 一次能返回多少条数据？

Yandex 有 3 个列表接口，包括 search、market、reviews。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Yandex API 返回哪些字段？

当前目录为 search 列出 id、url、name、text、address、city 等 17 个字段名。按全站当前目录统计，5 个字段名只在 Yandex 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

怎样在指定城市查找 Yandex Maps 商户？

search 用 keyword 查地图商户，location 指定城市，category 指定业务类别，适合核对地址、营业状态和联系方式。 location 默认 Moscow；地图 search 不使用电商 market 的 city。category 如 restaurants、cafes、coffee_shops 对应不同商户类别，none 表示不指定；它们不是商品分类。lang 明确传入时覆盖 language，不能视为自动翻译或原文语言保证。 rating 与 review_count 描述商户评分信息，lat、lng 是地理坐标，is_open_now 是返回时的营业标记而非持续营业保证。本 action 不带逐条评论正文；商户价位参数不能当作电商单件售价或接口调用费用。

怎样按 Yandex Market 城市比较商品与店铺？

market 用 keyword 搜商品，以 city 选择市场城市，再比较商品价格、评分和店铺信息。 city 使用 moscow、saint_petersburg 等目录允许值，并覆盖原始 region；它与地图 search 的 location 不是同一个参数。min_price/max_price 是商品价格条件，sort 的 popular 与 top_rated 分别按热度和评分，不与地图 distance 混用。 price 必须结合 currency，rating 是商品评分而 shop_rating 是卖家评分；rating_count、review_count、purchase_count 不是同一个数量。stock 与 is_available 不是库存锁定或可配送保证，最终配送方式、时效和费用仍取决于城市、商品及下单页面。

怎样区分 Yandex 商户单条评价与总体评分？

reviews 用地图商户完整 URL 或直接在 url 中填写 businessId，读取评价原文、评分与商家回复。 url 不接受 Yandex Market 商品对象作为商户评价目标；language 默认 en，sort 默认 newest，但当前未公布评价排序 allowedValues，不能借用 search 或 market 的枚举。界面语言与文本原始语言不同，不把 language 当作已验证的翻译开关。 rating 是单条评价分数，business_rating 是商户总体评分；url 返回商户地址，不一定是评价永久链接。text 最多保留 3000 字符、owner_reply 最多 1500 字符，comment_count 仅是数量，不含回复树；缺少字段不等于没有回复或零评价。

可以先免费试用 Yandex API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Yandex 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

更多全网搜索 API

SimilarWeb API全网搜索 APIYahoo Finance API全部 89 平台 ↗

开始调用 Yandex API

加微信领 $1 免费额度，先选一个 Yandex 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始