Skip to main content
Network status
Log in
Piloterr
Back to library

Upwork Freelancer API

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.

Active2 credits = 1 requestGET/v2/upwork/freelancer
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Upwork Freelancer API returns public profile data from Upwork freelancer pages. Pass a profile ID (~0161...), username, or full profile URL and receive structured JSON with bio, hourly rate, skills, ratings, and agency info.

Piloterr uses browser rendering to load the Nuxt profile page and extract DOM metadata.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/upwork/freelancer?query=~0161ad91037ca6144b

Via POST:

POST https://api.piloterr.com/v2/upwork/freelancer
Content-Type: application/json

{"query": "https://www.upwork.com/freelancers/~0161ad91037ca6144b", "return_page_source": false}

ParametersLink to Parameters

Parameter Type Required Description
query string yes Profile ID, username, or /freelancers/... URL
return_page_source boolean no Raw HTML as {"result": "..."} (default: false)

Response fieldsLink to Response fields

Field Type Description
user_id string Numeric Upwork user ID
profile_id string Profile token (e.g. ~0161...)
username string | null Public username when available
name string Display name
title string Professional headline
description string Profile summary
location string | null Location label
hourly_rate number | null Hourly rate
currency string ISO 4217 code
rating number | null Average rating
review_count integer | null Review count
job_success_score integer | null Job Success Score (0–100)
total_hours integer | null Total billed hours
is_agency boolean Agency profile flag
agency_name string | null Agency name
verified boolean Verified badge
skills string[] Listed skills
profile_image_url string | null Avatar URL
url string Canonical profile URL

Upwork API workflowLink to Upwork API workflow

  1. Upwork Jobs: discover open roles by skill
  2. Upwork Freelancer: enrich talent profiles (this endpoint)
  3. Upwork Services: browse Project Catalog listings by category
  4. Upwork Services Info: fetch full catalog product details; seller.url links back here

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query
404 Profile not parseable
500 Rendering or parsing error

NotesLink to Notes

  • Costs 2 credits per call (browser rendering).
  • Accepted paths: /freelancers/~{id} and /freelancers/{username}.

Main use casesLink to Main use cases

  • Talent sourcing: enrich candidate profiles before outreach
  • Vendor vetting: check ratings, JSS, and hourly rates
  • Agency research: identify agency-backed freelancers

Related APIs

Expand your data capabilities with these complementary tools.

View All
Upwork Jobs/v2/upwork/jobs

Upwork Jobs API: search freelance job listings by skill slug or URL. Returns budgets, skills, experience level and pagination via browser rendering.

GET2 credits = 1 requestActive
Upwork Search/v2/upwork/search

Effortlessly extract detailed freelance painter profiles from Upwork for recruitment, market analysis, and more with our Upwork Search API.

GET1 credit = 1 requestPrivate
Upwork Services/v2/upwork/services

Upwork Services API: browse Project Catalog listings by category slug or URL. Returns prices, product IDs and pagination via browser rendering.

GET2 credits = 1 requestActive
Upwork Services Info/v2/upwork/services/info

Upwork Services Info API: fetch Project Catalog product details from a product URL. Returns packages, pricing, seller, media and breadcrumbs via browser rendering.

GET2 credits = 1 requestActive
Upwork Talent/v2/upwork/talent

Extract detailed freelancer profiles from Upwork with our API. Access skills, experience, ratings, and more to enhance project success.

GET1 credit = 1 requestPrivate

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert