Piloterr

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

GET
/v2/upwork/jobs

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

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 }. Parsed from window.__NUXT_DATA__ with DOM .job-tile fallback.

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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/upwork/jobs?query=string"
{
  "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
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}