SuperAPI AI 工具集

people-company-search-fiber

数据与分析

查看项目

更新于 10-16 03:01

技能介绍

用途

该技能面向人员、公司、投资人和职位的搜索与数据补全,核心数据来源为 LinkedIn。它可帮助你在招聘、销售线索挖掘、市场调研等场景中,根据描述或条件找到目标人物与公司,并获取较为丰富的档案信息。

主要能力

  • 人物相关:用自然语言描述搜索人物档案;按条件筛选搜索人员;通过邮箱反查人物及其 LinkedIn 资料;实时抓取指定 LinkedIn 个人主页;用多种参数(LinkedIn 标识、邮箱、姓名、职位、公司信息等)进行综合人物查询。
  • 公司相关:用自然语言描述搜索公司;按条件筛选搜索公司;实时抓取指定 LinkedIn 公司主页;用多种参数(LinkedIn 标识、名称、域名等)进行综合公司查询。
  • 内容与互动:抓取 LinkedIn 个人主页的近期帖子;抓取指定帖子的评论;抓取指定帖子的特定类型互动(reactions)。帖子分页每页最多 50 条,评论分页每页最多 10 条。
  • 搜索条件转换:把自由文本(如“美国 50–200 人的 A 轮创业公司”)转换为公司搜索过滤条件,或转换为人物档案搜索过滤条件。
  • 其他:搜索投资人(支持灵活筛选);搜索职位发布;校验单个邮箱是否可能退信(采用瀑布式策略,可处理 catch-all 邮箱)。

使用方式

  1. 凭据准备:从 ~/.gooseworks/credentials.json 读取 API Key 与 API Base,示例命令: export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])") export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))") 若该文件不存在,需要运行 npx gooseworks login。
  2. 认证方式:所有端点使用 Bearer 认证,请求头为 -H "Authorization: Bearer $GOOSEWORKS_API_KEY"。
  3. 调用方式:通过 POST 请求发送到 $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run,请求体中指定 api 为 fiber、path 为具体端点路径及相应 body。资料建议优先使用专用代理路由 $GOOSEWORKS_API_BASE/v1/proxy/fiber/... 以获得更清晰的计费跟踪。
  4. 分页:多个搜索端点支持 cursor 分页参数,可通过上一次响应的 cursor 获取下一页;pageSize 可控制返回数量。
  5. 详细数据开关:部分接口提供 getDetailedEducation、getDetailedWorkExperience 参数,用于返回教育或工作经历的深度信息(如学校/公司的 LinkedIn 网址、网站、位置等),开启会拖慢接口调用。

适用场景

  • 招聘或人才搜寻:按地点、经验、职位等条件查找候选人档案。
  • 销售与线索挖掘:按行业、规模、融资阶段等条件查找公司或联系人,并进行邮箱校验。
  • 市场与投资研究:搜索投资人、公司、职位发布,获取公司与人物情报。
  • 内容分析:获取指定 LinkedIn 主页的帖子、评论与互动数据。

限制与费用参考

  • 费用:/v1/natural-language-search/profiles 为 $0.02/条(pageSize × $0.02),未指定 pageSize 时默认 $0.50;/v1/people-search 同为 $0.02/条,未指定 pageSize 时默认 $0.50;/v1/natural-language-search/companies 费用不定;/v1/kitchen-sink/person 费用不定(单次查询);/v1/validate-email/single 约 $0.02。
  • 资料提到更便宜的人物搜索替代方案:Apollo mixed_people/search 每次调用固定 $0.01,与结果数量无关,可在可用时使用 $GOOSEWORKS_API_BASE/v1/proxy/apollo/mixed_people/search。
  • liveFetch 或实时抓取会获取最新 LinkedIn 数据,可能产生额外费用。
  • 通过邮箱反查人物时,若同时掌握姓名、公司等信息,使用 Kitchen Sink 端点可获得更好结果。
  • 资料未提供其余端点的具体价格、速率限制或数据合规细节,暂未提供。