全网搜索 · 数据 API

Yandex API

俄语区搜索结果、商品与点评——俄语市场检索与电商观察。调 POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

免费开始看文档

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

Yandex 能力清单

action	必填参数	可选参数	单次条数	模式	单价 / 次	返回字段
search	keyword	category, 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
market	keyword	city, 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
reviews	url	language, 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。

怎么调用 Yandex 关键词搜索 API？

search

使用 platform="yandex"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、name、text、address、city 等 17 个字段。

keyword必填: 检索关键词。
category可选: 分类筛选。取值随平台而异，见该能力的 allowed_values。
lang可选: 内容语言，ISO 639-1 代码（如 zh、en）。
language可选: 语言，取值格式随平台而异（可能是 en 也可能是 en-US）。
location可选: 地点，自由文本（如城市名或「城市, 州」）。取值格式随平台而异。
max_price可选: 最高价格，数值。
min_price可选: 最低价格，数值。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。

Yandex 特有返回字段与含义（4）

categories: 商家分类。
is_open_now: 当前是否营业。
lat: 纬度。
lng: 经度。

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

market

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

keyword必填: 检索关键词。
city可选: 城市名。
max_price可选: 最高价格，数值。
min_price可选: 最低价格，数值。
region可选: 地区。取值可能是国家码也可能是平台自有的地区标识，见 allowed_values。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。

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 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。
language可选: 语言，取值格式随平台而异（可能是 en 也可能是 en-US）。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。

Yandex 特有返回字段与含义（6）

business_id: 商家 ID。
business_name: 商家名称。
business_rating: 商家评分。
business_review_count: 商家评价数。
owner_reply: 商家回复。
dislike_count: 点踩数。

一次 Yandex search 调用的全过程:向 POST /api/v1/social 发送 platform="yandex"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、name、text、address 等字段;单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。

Yandex 原始字段名

EveryInfra 统一字段名

左边是 Yandex 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段，解析代码一行不用动。

只有 Yandex 返回的字段

全站 87 个平台里，这 5 个字段只有 Yandex 会返回——换别的平台拿不到这些数据。字段名与其余平台同样遵循 snake_case 命名，解析方式一致。

is_open_now
purchase_count
business_id
business_rating
business_review_count

返回字段含义

字段名跨 87 个平台统一，同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。机器可读版:/api/v1/social/fields

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

另有 Yandex 特有字段 categories · lat · lng · is_open_now · purchase_count · shop_name · shop_rating · stock · is_available · dislike_count · owner_reply · business_id · business_name · business_rating · business_review_count，保留该平台自身的语义。

30 秒调用示例

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":"咖啡"}}'

返回长这样

response.json

{
  "id": "yandex_…",
  "search": [
    {
      "id": "…",
      "url": "https://…",
      "name": "…",
      "text": "…",
      "address": "…",
      "city": "…",
      "country": "…",
      "categories": "…",
      "rating": 128,
      "rating_scale": "…",
      "review_count": 128,
      "phone": "…",
      "website": "…",
      "lat": "…",
      "lng": "…",
      "is_open_now": true,
      "platform": "yandex"
    }
  ],
  "count": 20,
  "billing": { "charged": true, "credits": 100, "cny": 0.009356 }
}

常见用例

关键词监控

按关键词轮询 Yandex 的新内容，配合 Gemini 文本 API 做情绪分类与异常波动告警。

口碑与差评告警

拉 Yandex 的评论做评分走势与差评归因，新差评第一时间入库推送。

Yandex API 常见问题

Yandex API 怎么调用?

调 POST /api/v1/social,请求体传 platform="yandex"、action 和 params。以 search 为例,必填 keyword,可选 category、lang、language、location。Yandex 共 3 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

Yandex API 怎么收费?

$1.39 / 千次/次,Yandex 全部 3 个能力同价。$1 免费额度约等于 719 次 Yandex 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

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

最多的是 reviews,单次上限 200 条(默认 20 条)。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

Yandex API 返回哪些字段?

search 返回 id、url、name、text、address、city 等 17 个字段。其中 5 个字段只有 Yandex 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

Yandex怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="yandex"、action="search",必填参数 keyword。单次最多 100 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 id、url、name、text、address。

Yandex评价怎么批量采集?

调 POST /api/v1/social,传 platform="yandex"、action="reviews",必填参数 url。单次最多 200 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,评价数据字段为 id、url、text、rating、rating_scale。

可以先免费试用 Yandex API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 Yandex 的 3 个能力都试一遍。无需信用卡。

开始调用 Yandex API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 Yandex 的能力全试一遍。

免费开始