Piloterr

Upwork Freelancer

GET
/v2/upwork/freelancer

Upwork Freelancer API: fetch public freelancer profile data from a profile ID, username or URL. Returns bio, hourly rate, skills, ratings and agency info via browser rendering.

Credit cost: 2 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Upwork freelancer profile ID, username, or full profile URL.

Examples:

~0161ad91037ca6144b
https://www.upwork.com/freelancers/example-user
https://www.upwork.com/freelancers/adnans2

Returns a flat profile object with bio, hourly rate, skills, ratings, and agency info.

Pair with Upwork Jobs for role discovery or Upwork Services Info seller URLs.

return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
url?string
name?string
title?string
rating?number
skills?array<string>
user_id?string
currency?string
location?string
username?string
verified?boolean
is_agency?boolean
profile_id?unknown
agency_name?string
description?string
hourly_rate?integer
total_hours?integer
review_count?integer
job_success_score?integer
profile_image_url?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/upwork/freelancer?query=string'
Example Response
{  "url": "https://www.upwork.com/freelancers/example-user",  "name": "Alex Martin",  "title": "Your technology partner in Mobile & web app development",  "rating": 4.9,  "skills": [    "Website",    "HTML",    "CSS",    "JavaScript",    "HTML5",    "CSS 3",    "Microsoft SharePoint Administration",    "Microsoft Office SharePoint Server"  ],  "user_id": "000000000000000000",  "currency": "USD",  "location": "Rajkot , India",  "username": "example-user",  "verified": true,  "is_agency": true,  "profile_id": null,  "agency_name": "AllianceTek Inc",  "description": "View Alex Martin profile on Upwork, the world’s work marketplace. Viraj has completed 55 jobs on Upwork. Check out the complete profile and discover more professionals with the skills you need.",  "hourly_rate": 32,  "total_hours": 12029,  "review_count": 38,  "job_success_score": 100,  "profile_image_url": "https://www.upwork.com/placeholder/example-user.jpg"}