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

Upwork Services API

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

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

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Upwork Services API returns Project Catalog listings from Upwork category pages (/services/{category-slug}). Pass a category slug or full URL and receive catalog cards with titles, prices, product IDs, and pagination metadata.

Piloterr uses browser rendering to load Nuxt catalog pages and extract .project-tile cards.

Use each result's listing_url with Upwork Services Info for packages, seller info, and media.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/upwork/services?query=mobile-apps

Via POST:

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

{"query": "mobile-apps", "return_page_source": false}

ParametersLink to Parameters

Parameter Type Required Description
query string yes Category slug or /services/{slug} URL
return_page_source boolean no Raw HTML as {"result": "..."} (default: false)

Response: each listing (results[])Link to Response: each listing (results[])

Field Type Description
product_id string Catalog product ID
title string Listing title
listing_url string Product URL
price_from number | null Starting price
currency string | null ISO 4217 code
rating number | null Star rating
image_url string | null Thumbnail URL

Response: paginationLink to Response: pagination

Field Type Description
page integer Current page
per_page integer Listings on this page
total_results integer | null Total listings (often null)
total_pages integer | null Total pages (often null)
next string | null Next page URL

Upwork API workflowLink to Upwork API workflow

  1. Upwork Services: discover catalog listings by category (this endpoint)
  2. Upwork Services Info: fetch full product JSON from any listing_url
  3. Upwork Freelancer: enrich the seller profile from seller.url

Error codesLink to Error codes

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

NotesLink to Notes

  • Rejects /services/product/... URLs: use Upwork Services Info instead.
  • Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

  • Catalog discovery: harvest product IDs by category
  • Price benchmarking: compare starting prices across listings
  • Marketplace monitoring: track new catalog offerings

Related APIs

Expand your data capabilities with these complementary tools.

View All
Upwork Freelancer/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.

GET2 credits = 1 requestActive
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 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