Freelancer Jobs Search API

Search fresh Freelancer.com job listings updated every 5 minutes. Filter by skills, budget, currency, and project type. Includes client verification data, ratings, and 40+ fields per job.

原始信息汇总

Freelancer Jobs Search API 数据集概述

基本描述

• API名称：Freelancer Jobs Search API
• 数据源：Freelancer.com
• 数据更新频率：每5分钟更新一次
• 数据特点：提供实时数据，包含40多个字段的丰富信息，包括技能分类、投标统计、截止日期、客户信息和验证标志。

功能与用途

• 主要功能：以编程方式搜索Freelancer.com的工作列表。
• 适用场景：适用于求职板、自由职业者工具、市场研究和职业平台。
• 核心优势：
  • 新项目在发布后几分钟内即可获取。
  • 支持多货币预算（USD, EUR, INR, GBP等）并包含货币名称。
  • 使用与Upwork Jobs API相同的API密钥。

接口端点

• 端点：GET /freelancer
• 基础URL：https://upwork-jobs-search-api.p.rapidapi.com

查询参数

参数	类型	是否必需	描述
q	string	是*	搜索查询。支持：, (AND), `
skills	string	是*	逗号分隔的技能名称（例如：Python,React）
limit	integer	否	每页结果数，1-100（默认：100）
project_type	string	否	fixed 或 hourly
budget_min	number	否	最低预算（以项目货币计）
budget_max	number	否	最高预算（以项目货币计）
currency	string	否	按货币代码过滤（例如：USD, EUR, INR）
language	string	否	按项目语言过滤（例如：en, fr, es）
is_urgent	boolean	否	仅过滤紧急项目
is_nda	boolean	否	仅过滤需要保密协议（NDA）的项目
sort_order	string	否	desc（默认，最新优先）或 asc（最旧优先）

• 参数 q 或 skills 至少需要一个。

请求头

请求头	是否必需	描述
X-RapidAPI-Key	是	您的RapidAPI订阅密钥
X-RapidAPI-Host	是	upwork-jobs-search-api.p.rapidapi.com
X-Cursor	否	来自先前响应的分页游标

响应格式与字段

• 响应结构：包含 data（工作对象数组）、next_cursor（分页游标）和 meta（元数据）的JSON对象。
• 工作对象主要字段：
  • 项目信息：project_id, url, title, description, published_at, project_type, status, language。
  • 预算信息：budget_min, budget_max, budget_currency_code, budget_currency_name。
  • 技能信息：skills（包含 id, name, category_id, category_name 的对象数组）。
  • 投标信息：bid_count, bid_avg, bid_deadline。
  • 项目标志：is_featured, is_urgent, is_nda, is_sealed 等。
  • 客户信息：client_country, client_city, client_country_code, client_member_since, client_rating_avg, client_review_count, 以及多项验证标志（如 client_payment_verified）。

错误响应

• 格式：包含 error 对象的JSON，其中有 code 和 message 字段。
• 常见错误码：
  • 400 invalid_params：缺少或无效的查询参数。
  • 401 unauthorized：缺少或无效的API密钥。
  • 429 credits_exhausted：超出速率限制。
  • 500 search_error：内部服务器错误。

与Upwork API (/upwork) 的主要区别

特性	Upwork (/upwork)	Freelancer (/freelancer)
预算货币	始终为USD	原始货币（USD, EUR, INR, GBP等）
技能格式	字符串数组 ["Python", "React"]	对象数组 [{id, name, category_id, category_name}]
客户数据	丰富（雇佣数、支出、评分）	国家、城市、注册时间、评分、验证标志
预算过滤器	独立的小时制/固定价格控制	单一的 budget_min/budget_max 范围
独特过滤器	experience_level, premium	currency, language, is_urgent, is_nda
截止日期	不可用	bid_deadline（绝对时间戳）

订阅计划

• BASIC：$0.00 / 月
• PRO：$2.00 / 月
• ULTRA：$6.00 / 月
• MEGA：$20.00 / 月