POST

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

播客:返回列表,默认 20 条、单次最多 100 条;主要字段 id、url、type、name、text、artists。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 spotify,action 填 podcast。 单价 $1.39 / 千次(每次 $0.001389),失败和空结果都不收费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。

Spotify 播客接口按 keyword 搜索播客,content_type 选 podcasts_shows 查节目,选 podcast_episodes_individual_episodes 查单集;不传时默认搜节目。每行带名称 name、发行方 publisher、剧集数量 episode_count、简介 text 和链接 url。它回答「这个主题下有哪些播客节目、哪些单集」,适合选题调研和竞品节目梳理。

publisher 和 episode_count 是播客专用字段。不指定数量时返回 20 条,上限 100 条。关键词搜索那一页的参数和返回字段与这个接口相同,只是 content_type 换成了别的取值。

AI 提示词

#
请帮我用 EveryInfra 的「Spotify 播客」接口(spotify/podcast)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 spotify,action 填 podcast,参数放在 params 里。
- 必填参数:
  - keyword:search 的音乐检索词,类型由 content_type 选择;podcast 默认搜索播客节目,不是单集详情查询。
- 可选参数:
  - content_type:search 使用 tracks、artists、albums、playlists;podcast 仅使用 podcasts_shows(节目)或 podcast_episodes_individual_episodes…(可选值:podcast_episodes_individual_episodes / podcasts_shows)
  - limit:这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 20)
- 返回一组记录,每条记录的主要字段:id、url、type、name、text、artists(参与艺人列表)、album_name(专辑名称)、owner_name(歌单创建者(歌单类结果用))、publisher(发行方(播客用))、image_url、duration_ms(时长)、play_count(播放次数);一共 20 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=spotify。
- 示例请求体:
{
  "platform": "spotify",
  "action": "podcast",
  "params": {
    "keyword": "true crime"
  }
}
- 计费:$1.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是spotify平台标识,固定值。
actionbodystring是podcast能力标识,固定值。
keywordbody.paramsstring是-search 的音乐检索词,类型由 content_type 选择;podcast 默认搜索播客节目,不是单集详情查询。
content_typebody.paramsstring (enum)否-search 使用 tracks、artists、albums、playlists;podcast 仅使用 podcasts_shows(节目)或 podcast_episodes_individual_episodes(单集)。不可跨 action 混用。允许值podcast_episodes_individual_episodespodcasts_shows
limitbody.paramsinteger (1–100)否20这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。

代码示例

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "spotify",
  "action": "podcast",
  "params": {
    "keyword": "true crime"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

响应示例

#
2026年9月26日 16:56(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "spotify",  "action": "podcast",  "results": [    {      "id": "5YNYcVmxKGsd8Q73mssWT9",      "url": "https://open.spotify.com/show/5YNYcVmxKGsd8Q73mssWT9",      "type": "show",      "name": "Canadian True Crime",      "text": "From the snowy streets of small-town Canada to the darkest corners of the big cities, join Aussie-Canadian host Kristi Lee for an immersive deep dive into the nation's most compelling crimes.With meticulous research and a trauma-informed approach, Kristi takes you beyond the head…",      "image_url": "https://i.scdn.co/image/ab6765630000ba8a42c23d101ed9e52c6592c869",      "episode_count": 240,      "rank": 1,      "platform": "spotify"    },    {      "id": "3DgfoleqaW61T2amZQKINx",      "url": "https://open.spotify.com/show/3DgfoleqaW61T2amZQKINx",      "type": "show",      "name": "Crime Junkie",      "text": "Does hearing about a true crime case always leave you scouring the internet for the truth behind the story? Dive into your next mystery with Crime Junkie. Every Monday, join your host Ashley Flowers as she unravels all the details of infamous and underreported true crime cases wi…",      "image_url": "https://i.scdn.co/image/ab6765630000ba8abe2cc3efd92b817b54d9bcb2",      "episode_count": 530,      "rank": 2,      "platform": "spotify"    }  ],  "count": 20,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url该记录在原平台上的可访问链接。
type记录类型,取值随能力而定(如 video / image / text)。
name名称。用于账号/商品/商家类能力,指该对象本身的名字。
text正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
artists参与艺人列表。
album_name专辑名称。
owner_name歌单创建者(歌单类结果用)。
publisher发行方(播客用)。
image_url图片链接。多图能力可能返回 image_urls 数组。
duration_ms时长,单位毫秒(不是秒,除以 1000 才是秒)。
play_count播放次数。
follower_count粉丝数。null 表示不公开,不等于 0。
monthly_listener_count月听众数。这是 Spotify 上衡量艺人热度的核心指标。
track_count曲目总数。
episode_count剧集数量(播客用)。
release_date发行日期。
is_explicit是否含限制级内容。
preview_url30 秒试听片段链接,可能为 null。
rank排行榜名次。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

常见问题

#

查节目和查单集怎么选?

#

content_type 传 podcasts_shows 查节目,传 podcast_episodes_individual_episodes 查单集。keyword 是检索词,不是单集详情查询。看节目用 episode_count 知道出了多少集,看单集用 duration_ms 知道有多长。

content_type 能不能填 tracks 或 artists?

#

不能。content_type 不可跨接口混用:播客接口只认 podcasts_shows 和 podcast_episodes_individual_episodes,tracks、artists、albums、playlists 属于关键词搜索。想搜歌曲或艺人,请改用关键词搜索。

单集时长怎么换算?

#

duration_ms 的单位是毫秒,不是秒,除以 1000 才得到秒。做时长统计前先换算,否则会差一千倍。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

Google Analytics 同意才加载 隐私