Piloterr

Upwork Jobs

GET
/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.

Credit cost: 2 credits per call

Autorización

ApiKeyAuth
headerx-api-key<token>

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

Parámetros de consulta

query*string

Upwork skill slug or full freelance-jobs URL.

Examples:

api-development
https://www.upwork.com/freelance-jobs/api-development/

Returns { skill, title, results[], pagination }.

Use Upwork Freelancer to enrich a candidate profile from a freelancer URL.

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

Cuerpo de la respuesta

Successful response

application/json
  1. response
skill?string
title?string
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/upwork/jobs?query=string'
Example Response
{  "skill": "api-development",  "title": "Find the Best API Developer Jobs",  "results": [    {      "title": "Full-stack Shopify + Make.com + Gemini AI Automation Setup",      "job_id": "022071658395247542131",      "skills": [        "HTML",        "HTML5",        "CSS",        "Shopify"      ],      "currency": "USD",      "duration": "1 to 3 months",      "job_type": "fixed",      "posted_at": "2026-06-29T18:13:45+0000",      "budget_max": null,      "budget_min": 800,      "posted_ago": "14 hours ago",      "description": "Dear Expert,\nBelow you can find a description of my project where your expertise would be needed.\nProject Overview: I am looking for a full-stack automation expert/agency to build a completely turnkey...",      "listing_url": "https://www.upwork.com/freelance-jobs/apply/Full-stack-Shopify-Make-com-Gemini-Automation-Setup_~022071658395247542131/",      "hours_per_week": null,      "experience_level": "Expert"    },    {      "title": "Looking for an AI Agent Developer for Social Media Automation",      "job_id": "022071659921584263119",      "skills": [        "Lead Generation",        "Artificial Intelligence",        "Python"      ],      "currency": "USD",      "duration": "1 to 3 months",      "job_type": "fixed",      "posted_at": "2026-06-29T18:19:49+0000",      "budget_max": null,      "budget_min": 13000,      "posted_ago": "13 hours ago",      "description": "I am looking to build an AI agent that can manage and handle social media profiles across platforms like Facebook, Instagram, LinkedIn, and TikTok.\nThe goal is to create an AI-powered system that can ...",      "listing_url": "https://www.upwork.com/freelance-jobs/apply/Looking-for-Agent-Developer-for-Social-Media-Automation_~022071659921584263119/",      "hours_per_week": null,      "experience_level": "Expert"    }  ],  "pagination": {    "next": null,    "page": 1,    "per_page": 30,    "total_pages": 206,    "total_results": 6156  }}