Fiverr 自由职业数据 API
Fiverr - Freelance Service 是 Fiverr 的官方应用。Fiverr 是总部位于特拉维夫的自由职业服务市场,2010 年由 Micha Kaufman 与 Shai Wininger 创立,2019 年起在纽约证券交易所上市,名字源于早期 gig 统一 5 美元的定价。卖家把 logo 设计、写作、编程等数字服务打包成固定范围的 gig 上架,买家直接下单;双方都用用户名或邮箱登录,同一账户可以同时以买家和卖家身份使用。买家可浏览首页的子类目轮播(如 Graphics & Design 下的 Logo Design)与排序后的 gig 列表,借助类目筛选搜索 gig,并打开 gig 页面查看分档套餐、付费加购项、平均交付时长、卖家排队中的订单数,以及标注评价者国家的公开星级评价;公开卖家资料页展示卖家等级、Pro 身份、在线状态、响应时长、最近活跃、最近交付、技能与语言。结账支持银行卡、PayPal、Google Pay 与 Venmo,并可抵用买家信用券与报销余额;成交后,每笔交易——包括订阅订单和 Fiverr's Choice 推荐服务——都会进入买卖双方共用的订单管理列表,并附带含里程碑费用的订单收据和一条买卖双方的站内信会话。卖家另有专属主页,包含新手任务、gig 的曝光、点击与订单数、距下一卖家等级的进度,以及收入仪表盘:本月至今收入、平均售价、待清算金额、取消单与可提现资金,支持 PayPal 提现,印度卖家还会看到 GST 与 Section 194 税务项目。应用服务于美国、印度与西班牙的自由职业者和雇用他们的客户;相较 Upwork 的按小时与固定价格合同、Freelancer.com 的竞赛模式、Toptal 的筛选人才网络,以及 Thumbtack、TaskRabbit 这类本地服务应用,Fiverr 以预先打包的 gig 为核心。
gig 列表在买家下单之前,就已带着价格、评分与排队数。搜索结果卡片携带 price、rating、ratings_count、seller_level、is_pro 以及 category_name/sub_category_name 类目对,total_results 给出每个技能查询的结果规模,did_you_mean 纠正拼错的查询;完整的 gig 记录再补上 packages、extras、avgDelivery、ordersInQueue 与 currency。公开评价提供带时间的 comment,以及 averageValuation、reviewerCountryCode 与 relevancyScore;卖家资料则提供 level、responseTime、lastActive、recentDelivery、hasRepeatedBuyers、skills 与 languages。登录后的账户卡片还带有 isBuyer、isSeller、hasActiveGigs、countryCode 与 ordersAsBuyer,可把同一身份清晰拆分为买家与卖家两条足迹。
gig 一经购买,交易记录随即接手。每条订单行包含 statusTitle、deliveryDate、amount、productType、isSubscription 与 isFiverrChoice;收据把 buyerTotalAmount 与 sellerTotalAmount 分开列示,附 buyerTotalAmountInUsd 美元折算、行项 transactions 与 milestones;结账返回 methodName 与新建的 orderId;站内信会话则把 lastMessage、labels 与 hasMutualActiveOrders 关联到 related_order_id。资金按角色分别记录:卖家侧有 earnedThisMonth、pendingClearance、availableRevenueFunds、avgSellingPrice、cancellationsAmount、带标签的 revenues 分桶、paypalWithdrawEnabled 标记,以及印度税务字段 indiaGst 与 indiaSection194,旁边还有 gig 的 impressions、clicks 与 currentLevel;买家侧则有 reimbursements 与带 expirationDate 的具名 credits。
这套记录的不同部分服务于不同的构建者。记账机器人可以每晚拉取收入仪表盘与钱包余额,并逐笔核对收据中的 sellerTotalAmount,让打款与待清算金额保持对账一致;采购代理可以按技能查询翻页,维护一份 gig 价格、套餐与排队深度的本地索引;运营控制台可以列出进行中的订单,让每位买家的消息始终挂在所属订单上;供应商风控流程则可在自由职业者入驻前核查其等级、响应时长、最近交付、技能、语言与评价分。openData Studio 将这套覆盖 gig、订单与收入的双边数据变为可调用的开放数据。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
用户名或邮箱登录
POST
/v1/account/signinosint认证买家或卖家,签发会话 token、userId 与 username,供资料、订单、站内信与收入调用复用。
认证方式: 无需既有会话。JSON 请求体携带用户名或邮箱加密码;响应中的 token 即会话,后续调用以 Authorization: Bearer 附加。
- username
- password
- token
- userId
- errorKeys
POST /v1/account/signin HTTP/1.1 Content-Type: application/json { "username": "designpro", "email": "[email protected]", "password": "********" }{ "token": "eyJhbGciOiJIUzI1NiJ9...", "userId": "41234567", "username": "designpro", "errorKeys": [] }读取登录用户资料
GET
/v1/account/currentosint返回账户页使用的登录账户卡片:身份、买家/卖家标记、卖家等级、币种与订单活动。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- profile
- id
- username
- displayName
- fullName
- status
- countryCode
- currency
- level
- isBuyer
- isSeller
- hasActiveGigs
- hasActiveOrders
- ordersAsBuyer
- profileImage
GET /v1/account/current HTTP/1.1 Authorization: Bearer <token>{ "profile": { "id": "41234567", "username": "designpro", "displayName": "Alex Rivera", "fullName": "Alex Rivera", "email": "[email protected]", "status": "active", "countryCode": "US", "currency": "USD", "level": 2, "isBuyer": true, "isSeller": true, "hasActiveGigs": true, "hasActiveOrders": true, "ordersAsBuyer": 14, "profileImage": "https://cdn.example.com/profile/photos/alex.jpg" } }读取卖家钱包余额
GET
/v1/wallet/selleropenbanking读取收入与提现界面上展示的卖家可用钱包余额。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- balance
GET /v1/wallet/seller HTTP/1.1 Authorization: Bearer <token>{ "balance": 1284.5 }卖家收入分析
GET
/v1/earnings/dashboardopenfinance加载卖家收入仪表盘:本月至今收入、进行中与已完成订单金额、可用资金、收入分桶,以及是否启用 PayPal 提现。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- analytics
- earnedThisMonth
- avgSellingPrice
- activeOrders
- activeOrdersAmount
- availableRevenueFunds
- completedOrders
- completedOrdersAmount
- balance
- indiaGst
- indiaSection194
- revenues
- text
- key
- value
- paypalWithdrawEnabled
GET /v1/earnings/dashboard HTTP/1.1 Authorization: Bearer <token>{ "analytics": { "earnedThisMonth": 2140.0, "avgSellingPrice": 178.33, "activeOrders": 6, "activeOrdersAmount": 980.0, "availableRevenueFunds": 1284.5, "completedOrders": 12, "completedOrdersAmount": 2140.0, "balance": 1284.5, "indiaGst": null, "indiaSection194": null }, "revenues": [ {"text": "Available funds", "key": "available", "value": 1284.5}, {"text": "Pending clearance", "key": "pending_clearance", "value": 420.0} ], "paypalWithdrawEnabled": true }买家余额与报销
GET
/v1/wallet/buyeropenfinance返回买家侧钱包:报销金额加具名信用券(含面额与有效期),在结账时使用。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- balance
- earnings
- reimbursements
- credits
- name
- amount
- expirationDate
GET /v1/wallet/buyer HTTP/1.1 Authorization: Bearer <token>{ "balance": { "earnings": 0, "reimbursements": 2500 }, "credits": [ { "name": "Welcome credit", "amount": 1500, "expirationDate": 1767225600000 } ] }买家首页目录
GET
/v1/home/buyeropendata为买家首页注水:热门子类目轮播、CMS 推广位与排序后的 gig 列表。
认证方式: 可选 Authorization: Bearer <token>。匿名买家仍会收到类目轮播;登录调用会个性化 gigLists。
- subCategories
- cmsEntries
- gigLists
- title
- gigs
- id
- price
- sellerName
- nextCmsEntryIndex
- limit_search_promotions
- limit_top_categories
GET /v1/home/buyer?limit_search_promotions=8&limit_top_categories=12 HTTP/1.1 Authorization: Bearer <token>{ "subCategories": [ {"id": 3, "name": "Logo Design", "slug": "logo-design"} ], "cmsEntries": [ {"id": "hero_promo_q3", "type": "promotion"} ], "gigLists": [ { "title": "Most popular in Graphics & Design", "gigs": [ {"id": 3182042, "title": "I will design a modern logo", "price": 25, "sellerName": "designpro"} ] } ], "nextCmsEntryIndex": 0 }卖家主页表现
GET
/v1/home/selleropendata加载卖家主页:新手任务、gig 分析计数器、卖家等级进度与收入快照(earnedThisMonth、pendingClearance、取消单)。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- tasks
- myGigs
- impressions
- clicks
- orders
- levels
- currentLevel
- earnings
- earnedThisMonth
- pendingClearance
- ordersAmount
- cancellationsOrder
- cancellationsAmount
- avgSellingPrice
- balance
GET /v1/home/seller HTTP/1.1 Authorization: Bearer <token>{ "tasks": [ {"id": "complete_profile", "title": "Add a profile photo"} ], "myGigs": { "impressions": 12840, "clicks": 920, "orders": 14 }, "levels": { "currentLevel": 2, "nextLevel": 3 }, "earnings": { "earnedThisMonth": 2140.0, "pendingClearance": 420.0, "orders": 14, "ordersAmount": 2490.0, "cancellationsOrder": 1, "cancellationsAmount": 45.0, "avgSellingPrice": 178.33, "balance": 1284.5 } }搜索自由职业 gig
GET
/v1/catalog/searchopendata驱动搜索结果界面的 gig 搜索:分页的 gig 卡片,含价格、评分、卖家等级与类目聚合。
认证方式: 可选 Authorization: Bearer <token>。查询串携带 query_string、page 与类目过滤。
- query_string
- page
- total_results
- has_more
- search_query
- search_sort_type
- did_you_mean
- gig_list
- id
- title
- price
- rating
- ratings_count
- seller_name
- seller_level
- category_name
- sub_category_name
- is_pro
- image_url
- advanced_search
GET /v1/catalog/search?query_string=logo%20design&page=1&show_blank_facets=true HTTP/1.1 Authorization: Bearer <token>{ "total_results": 24810, "has_more": true, "search_query": "logo design", "search_sort_type": "relevance", "did_you_mean": null, "gig_list": { "gigs": [ { "id": 3182042, "title": "I will design a modern logo", "price": 25, "rating": 4.9, "ratings_count": 1842, "seller_name": "designpro", "seller_level": 2, "category_name": "Graphics & Design", "sub_category_name": "Logo Design", "is_pro": false, "image_url": "https://cdn.example.com/gigs/3182042/original/logo.jpg" } ] }, "advanced_search": [] }按 id 读取 gig 页面
GET
/v1/catalog/items/{itemId}opendata加载完整 gig 页面:套餐、加购项、排队深度、平均交付时长与结账前展示的卖家身份。
认证方式: 可选 Authorization: Bearer <token>。从广告打开时会附加 auction 或 ad_key 查询参数。
- gig
- id
- title
- price
- currency
- description
- sellerName
- sellerId
- sellerLevel
- rating
- ratingsCount
- ordersInQueue
- avgDelivery
- isPro
- categoryName
- subCategoryName
- packages
- extras
GET /v1/catalog/items/3182042 HTTP/1.1 Authorization: Bearer <token>{ "gig": { "id": 3182042, "title": "I will design a modern logo", "price": 25, "currency": "USD", "description": "A custom logo in 3 concepts.", "sellerName": "designpro", "sellerId": 41234567, "sellerLevel": 2, "rating": 4.9, "ratingsCount": 1842, "ordersInQueue": 4, "avgDelivery": 3, "isPro": false, "categoryName": "Graphics & Design", "subCategoryName": "Logo Design", "packages": [ {"id": 101, "name": "Basic", "price": 25, "deliveryTime": 3} ], "extras": [ {"id": 55, "title": "Extra revision", "price": 10} ] } }gig 评价
GET
/v1/catalog/items/{itemId}/reviewsopendata分页读取 gig 的公开评价:评论内容、星级评分、评价者国家与相关性得分。
认证方式: 可选 Authorization: Bearer <token>。游标使用上一条评价的 id 与得分。
- hasMorePages
- filter
- reviews
- id
- comment
- createdAt
- userId
- username
- averageValuation
- reviewerCountry
- reviewerCountryCode
- relevancyScore
GET /v1/catalog/items/3182042/reviews?sort_by=recent HTTP/1.1{ "hasMorePages": true, "filter": "recent", "reviews": [ { "id": "rev_9f2a", "comment": "Clean concepts, fast delivery.", "createdAt": 1758902400000, "userId": "998877", "username": "acmeco", "averageValuation": 5.0, "reviewerCountry": "United States", "reviewerCountryCode": "US", "relevancyScore": 0.92 } ] }列出买家或卖家订单
GET
/v1/orders/listopendata分页读取买家或卖家的订单管理列表,含状态、金额/币种、交付日期与套餐类型。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- type
- status
- last_order_time
- sort_by
- orders
- id
- title
- createdAt
- deliveryDate
- statusTitle
- statusIndex
- amount
- currency
- isFiverrChoice
- isSubscription
- productType
- hasNext
- sortOrder
- sectionable
GET /v1/orders/list?type=1&sort_by=0 HTTP/1.1 Authorization: Bearer <token>{ "orders": [ { "order": { "id": "FO38A1B2C3", "title": "I will design a modern logo", "createdAt": 1758902400000, "deliveryDate": 1759161600000, "statusTitle": "In progress", "statusIndex": 2, "amount": {"amount": 25.0, "currency": "USD"}, "isFiverrChoice": false, "isSubscription": false, "productType": "GIG", "selectedPackageType": "BASIC" } } ], "hasNext": true, "sortOrder": "DESC", "sectionable": true }订单收据与总额
GET
/v1/orders/{orderId}/invoiceopenfinance返回订单收据:卖家与买家各自总额、美元折算、行项交易与任何里程碑收费。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- totalAmount
- sellerTotalAmount
- buyerTotalAmount
- buyerTotalAmountInUsd
- currency
- transactions
- milestones
GET /v1/orders/FO38A1B2C3/invoice HTTP/1.1 Authorization: Bearer <token>{ "totalAmount": { "sellerTotalAmount": 20.0, "buyerTotalAmount": 25.0, "buyerTotalAmountInUsd": 25.0, "currency": "USD" }, "transactions": [ {"type": "gig_price", "amount": 25.0, "currency": "USD"} ], "milestones": [] }站内信会话串
GET
/v1/messages/threads/{username}opendata加载买卖双方站内信会话串,含最新消息、标签、双方进行中订单标记与实时频道 id。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。
- conversation
- id
- inboxConvId
- createdAt
- lastMessage
- lastMessageId
- lastMessageTimestamp
- read
- allowedToContact
- hasMutualActiveOrders
- labels
- messages
- nextPage
- firstMessageCreatedAt
- socketId
- pushkinChannel
- related_order_id
GET /v1/messages/threads/acmeco?related_order_id=FO38A1B2C3 HTTP/1.1 Authorization: Bearer <token>{ "conversation": { "id": "conv_4412", "inboxConvId": "inbox_4412", "createdAt": 1758800000000, "lastMessage": "Here is the first concept.", "lastMessageId": "msg_88", "lastMessageTimestamp": 1758902500000, "read": false, "allowedToContact": true, "hasMutualActiveOrders": true, "labels": ["custom_offer"], "messages": [ {"id": "msg_88", "body": "Here is the first concept."} ], "nextPage": false }, "firstMessageCreatedAt": 1758800000000, "socketId": "socket_9", "pushkinChannel": "user-41234567" }公开卖家资料页
GET
/v1/sellers/{sellerId}/pageosint返回卖家的公开资料页:等级、在线状态、响应时长、最近交付、技能与语言。
认证方式: 可选 Authorization: Bearer <token>。公开卖家卡片无需会话即可加载。
- username
- displayName
- level
- isPro
- isOnline
- responseTime
- lastActive
- recentDelivery
- hasRepeatedBuyers
- skills
- languages
- address
- blocked
- canBlock
GET /v1/sellers/designpro/page HTTP/1.1{ "username": "designpro", "displayName": "Alex Rivera", "email": null, "level": 2, "isPro": false, "isOnline": true, "responseTime": 2, "lastActive": 1758902400000, "recentDelivery": 1758816000000, "hasRepeatedBuyers": true, "skills": [{"name": "Logo Design"}], "languages": [{"name": "English", "level": "Native"}], "address": {"country": "United States"} }为购买会话付款
POST
/v1/checkout/sessions/{sessionId}/payopenbanking使用银行卡、PayPal、Google Pay 或 Venmo 为支付会话完成结账,并返回创建的订单 id。
认证方式: Authorization: Bearer <token>,来自 POST /v1/account/signin。请求体携带所选支付方式与处理器 nonce。
- paymentOptionId
- paymentTokenId
- methodName
- paymentMethodNonce
- payerId
- paypalExpressToken
- shouldSave
- status
- orderId
POST /v1/checkout/sessions/ps_7c2e91ab/pay HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json { "paymentOptionId": "po_card_1", "paymentTokenId": "pt_88", "methodName": "credit_card", "paymentMethodNonce": "fake-valid-nonce", "shouldSave": false }{ "status": "paid", "orderId": "FO38A1B2C3", "paymentOptionId": "po_card_1", "methodName": "credit_card" }
数据类别
- 卖家收入
- 买家余额
- gig 目录
- 订单
- 收据
- 站内信
- 资料
数据使用场景与案例
卖家损益快照
记账机器人每晚拉取 GET /v1/earnings/dashboard(earnedThisMonth、availableRevenueFunds、revenues)与 GET /v1/wallet/seller,再对照 GET /v1/orders/{orderId}/invoice 的 sellerTotalAmount,使打款与待清算金额保持对账一致。
gig 目录监控
采购代理按技能关键词分页遍历 GET /v1/catalog/search,并请求 GET /v1/catalog/items/{itemId} 补齐 packages、extras、ordersInQueue 与 sellerLevel,在本地维护价格与排队深度索引。
订单台站内信
运营控制台列出 GET /v1/orders/list(statusTitle、amount、deliveryDate),并以 related_order_id 打开 GET /v1/messages/threads/{username},让买家消息始终挂在进行中的订单上。
卖家公开信息卡
供应商风控流程在自由职业者入驻前加载 GET /v1/sellers/{sellerId}/page(level、responseTime、recentDelivery、skills、languages),并结合 GET /v1/catalog/items/{itemId}/reviews 的 averageValuation 做评估。
常见问题
Fiverr 应用开放哪些数据?
应用界面背后的市场数据集:带价格、评分与卖家等级的 gig 目录卡片,含套餐与加购项的完整 gig 页面,带收据的订单列表,买卖双方站内信会话,卖家收入与买家余额,以及结账会话。
登录如何运作?
应用在 POST /v1/account/signin 以用户名或邮箱加密码登录买家或卖家,返回 token、userId 与 username。后续调用以 Authorization: Bearer 附加该 token。
卖家收入与买家余额在哪里?
卖家分析——earnedThisMonth、availableRevenueFunds 与收入分桶——位于 GET /v1/earnings/dashboard,可提现钱包位于 GET /v1/wallet/seller,买家报销与具名信用券位于 GET /v1/wallet/buyer。
我可以在同一会话中追踪 gig 与订单吗?
可以。搜索在 GET /v1/catalog/search 运行,单个 gig 页面在 GET /v1/catalog/items/{itemId};登录后的订单列表是 GET /v1/orders/list,含买卖双方总额的收据是 GET /v1/orders/{orderId}/invoice。
与 Fiverr - Freelance Service 相似的应用
- Upwork — Upwork 是一个自由职业平台,支持按小时计费、固定价格项目以及长期合作,连接客户与独立专业人士。
- Freelancer.com — Freelancer.com 提供固定价格、按小时计费和竞赛形式的任务,覆盖全球人才库,还包含配送、摄影等本地线下工作。
- Toptal — Toptal 是一个经过筛选的人才网络,通过语言、技能和实时面试审核申请者,主要面向开发者、财务专家和设计师。
- PeoplePerHour — PeoplePerHour 是一个英国平台,将打包好的服务报价与客户发布的职位相结合,自由职业者费用随交易额增长而递减。
- Thumbtack — Thumbtack 将客户与本地服务专业人士对接,涵盖家庭服务、活动策划和课程教学,而非远程线上任务。
- TaskRabbit — TaskRabbit 专注于本地体力劳动和人工服务,如家具组装、搬家帮忙和跑腿代办,支持当天预约。
- 99designs — 99designs 是一个专注于设计的交易平台,客户可以通过设计竞赛或直接聘请设计师来完成标志、品牌、包装和网页设计。
相关主题
- fiverr api
- fiverr gigs 接口
- fiverr 卖家收入
- fiverr 订单 api
- fiverr 数据 api
- 自由职业市场数据
- fiverr 站内信会话
- fiverr 结账支付
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业