Glassdoor评价 API

POST

接口健康状态

24h 健康值
正常
24h 平均耗时
—
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

评价:返回列表,默认 20 条、单次最多 200 条;主要字段 id、title、pros、cons、advice、rating。

单价 $1.39 / 千次(每次 $0.001389),失败与空结果不扣费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。

AI 提示词

复制下面这段给你常用的 AI 助手:里面写好了这个接口的参数、返回字段和示例请求,它会先问清你的需求,再帮你写采集脚本。

请帮我用 EveryInfra 的「Glassdoor 评价」接口(glassdoor/reviews)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 glassdoor,action 填 reviews,参数放在 params 里。
- 必填参数:
  - url:Glassdoor 公司 Overview 或 Reviews 页的完整 URL,保留公司 slug 与 E/IE 数字标识。
- 可选参数:
  - since:时间下界,YYYY-MM-DD:reviews 里是点评起始日期,interviews 里是面试经历起始日期。不用于 profile、salaries 和 jobs。
  - sort:reviews 点评排序:newest 最新、relevance 相关性、top_rated 评分最高。不用于 profile、salaries、interviews 和 jobs。(可选值:newest / relevance / top_rated)
  - start_date:reviews 的点评起始日期,YYYY-MM-DD;同时提供 since 时以 since 为准。不是员工入职日期或职位发布时间。
  - limit:这次调用最多返回的条数,整数,1–200;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 20)
- 返回一组记录,每条记录的主要字段:id、title、pros(评价里的优点部分)、cons(评价里的缺点部分)、advice(建议原文:reviews 是员工写…)、rating、rating_scale、job_title(职位名称)、location、employment_length_years(评价人在该公司的工作年限)、is_current_employee(评价人是否为在职员工(false…)、language;一共 25 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=glassdoor。
- 示例请求体:
{
  "platform": "glassdoor",
  "action": "reviews",
  "params": {
    "url": "https://www.glassdoor.com/Overview/Working-at-Google-EI_IE9079.11,17.htm"
  }
}
- 计费:$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是glassdoor平台标识,固定值。
actionbodystring是reviews能力标识,固定值。
urlbody.params未声明是-Glassdoor 公司 Overview 或 Reviews 页的完整 URL,保留公司 slug 与 E/IE 数字标识。profile/reviews/salaries/interviews/jobs 均围绕该公司查询,不接受一条职位 URL 当作公司定位。
sincebody.params未声明否-时间下界,YYYY-MM-DD:reviews 里是点评起始日期,interviews 里是面试经历起始日期。不用于 profile、salaries 和 jobs。
sortbody.paramsenum否-reviews 点评排序:newest 最新、relevance 相关性、top_rated 评分最高。不用于 profile、salaries、interviews 和 jobs。允许值newestrelevancetop_rated
start_datebody.params未声明否-reviews 的点评起始日期,YYYY-MM-DD;同时提供 since 时以 since 为准。不是员工入职日期或职位发布时间。
limitbody.paramsinteger (1–200)否20这次调用最多返回的条数,整数,1–200;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 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": "glassdoor",
  "action": "reviews",
  "params": {
    "url": "https://www.glassdoor.com/Overview/Working-at-Google-EI_IE9079.11,17.htm"
  }
}'

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

响应示例

真实返回样例

2026年9月26日 16:56(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。

json
{
  "id": "req_…",
  "platform": "glassdoor",
  "action": "reviews",
  "results": [
    {
      "id": 105730040,
      "title": "Great employer with no negatives to mention",
      "pros": "Great at being good employer",
      "cons": "Nothing to add here bad",
      "rating": 5,
      "job_title": "Software Engineer",
      "location": "Nevada, IA",
      "employment_length_years": 0,
      "is_current_employee": false,
      "language": "eng",
      "helpful_count": 0,
      "has_employer_response": false,
      "posted_at": "2026-09-24T21:40:27.137000+00:00",
      "company_name": "Google",
      "platform": "glassdoor",
      "rating_scale": 5
    },
    {
      "id": 2757802,
      "title": "Moving at the speed of light, burn out is inevitable",
      "pros": "1) Food, food, food.  15+ cafes on main campus (MTV) alone.  Mini-kitchens, snacks, drinks, free breakfast/lunch/dinner, all day, errr'day.\r\n\r\n2) Benefits/perks.  Free 24:7 gym access (on MTV campus).  Free (self service) laundry (washer/dryer) available.  Bowling alley.  Volley …",
      "cons": "1) Work/life balance.  What balance?  All those perks and benefits are an illusion.  They keep you at work and they help you to be more productive.  I've never met anybody at Google who actually time off on weekends or on vacations.  You may not hear management say, \"You have to …",
      "advice": "1) Don't dismiss emotional intelligence and adaptive leadership.  They're not just catch phases.  You need great managers and leaders in order to build great companies and develop great employees.  The people who may be brilliant at solving technical issues may not be (and are mo…",
      "rating": 4,
      "job_title": "Program Manager",
      "location": "Mountain View, CA",
      "employment_length_years": 9,
      "is_current_employee": false,
      "language": "eng",
      "helpful_count": 3878,
      "recommend": "NEGATIVE",
      "ceo_approval": "NO_OPINION",
      "business_outlook": "NEGATIVE",
      "rating_work_life_balance": 2,
      "rating_culture_values": 3,
      "rating_senior_leadership": 3,
      "rating_career_opportunities": 3,
      "rating_comp_benefits": 5,
      "has_employer_response": false,
      "posted_at": "2013-06-21T12:42:33.137000+00:00",
      "company_name": "Google",
      "platform": "glassdoor",
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

返回字段

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

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
title标题。平台无标题概念时(如纯文本帖)为 null。
pros评价里的优点部分,员工原文。
cons评价里的缺点部分,员工原文。
advice建议原文:reviews 是员工写给管理层的建议,interviews 是面试者留下的建议。
rating评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
job_title职位名称。
location地理位置描述,原文透传,格式随平台而异。
employment_length_years评价人在该公司的工作年限。
is_current_employee评价人是否为在职员工(false = 前员工)。
language内容语言代码(如 zh、en),由平台判定,可能不准。
helpful_count这条评价被标为「有帮助」的次数。
recommend这位评价人是否会向朋友推荐这家公司(如 POSITIVE、NEGATIVE),是这一条评价自己的回答,不是公司整体的推荐率;没答时不出现这个字段。
ceo_approval这位评价人对 CEO 赞成、反对还是没有意见(如 NO_OPINION),是这一条评价自己的回答,不是公司整体的支持率;没答时不出现这个字段。
business_outlook这位评价人对公司未来六个月前景的看法(看好、中立或不看好,如 NEGATIVE),是这一条评价自己的回答,不是公司整体的比例;没答时不出现这个字段。
rating_work_life_balance工作生活平衡评分,5 分制。
rating_culture_values企业文化与价值观评分,5 分制。
rating_diversity_inclusion多元与包容性评分,5 分制。
rating_senior_leadership高层管理评分,5 分制。
rating_career_opportunities职业发展机会评分,5 分制。
rating_comp_benefits薪酬福利评分,5 分制。
has_employer_response公司是否回复了这条评价。
posted_at发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
company_name公司名称。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

401
缺少 Key 或 Key 无效。先鉴权再校验参数,未鉴权的请求拿不到参数结构。
422
参数名或取值不对。错误信息会列出这项能力支持的参数、允许值和最接近的候选,按它改即可;发生在扣费之前。
402
余额不足,请先充值。
429
超过账户的每分钟请求上限(名下所有 Key 合计;Key 自设了更低上限时先按它算),按 Retry-After 等待后再试。需要更高上限可在控制台买提速包。
503
暂时无法完成。已预扣的费用按原账本退回;响应里的 billing 与 refund 写明实际结果,结果未知时会明确标出,不要直接重发。
200 空结果
请求完成但没有数据,不扣费(billing.reason = empty_result_refunded)。