{"openapi":"3.0.3","info":{"title":"Upwork job-board API (ReefAPI)","version":"1.2.2","description":"Upwork job-board API — live freelance jobs from upwork.com in clean JSON: title, full brief, fixed or hourly budget, required skills, experience level, project length, posting timestamp, proposal count, and the client's country, spend, hire count and rating. Search with Upwork's own filters or pull one job in full. No login required. Call POST /upwork/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/upwork-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"Upwork job-board API documentation","url":"https://reefapi.com/docs/upwork"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"upwork","description":"Upwork job-board API — live freelance jobs from upwork.com in clean JSON: title, full brief, fixed or hourly budget, required skills, experience level, project length, posting timestamp, proposal count, and the client's country, spend, hire count and rating. Search with Upwork's own filters or pull one job in full. No login required."}],"paths":{"/upwork/v1/search":{"post":{"operationId":"upwork_search","summary":"Search live Upwork jobs by keyword and Upwork's own filters — category and subcategory, contract type, experience level, project length, weekly workload, client location, how many people the client ha","description":"Search live Upwork jobs by keyword and Upwork's own filters — category and subcategory, contract type, experience level, project length, weekly workload, client location, how many people the client has hired, client timezone — plus a posted-within-N-hours cut. Returns title, full description, budget, skills, posting timestamp and coarse client signals for each job, with the total match count.","tags":["upwork"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"python scraping","description":"Keyword to search job titles and descriptions. Omit it to browse the whole open board (109k+ jobs) newest-first."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":20,"example":20,"description":"How many jobs to return (1–200). Upwork serves 50 per page, so anything over 50 costs extra page fetches."},"offset":{"type":"integer","minimum":0,"maximum":5000,"default":0,"example":0,"description":"Skip this many results before returning `limit` (0–5000)."},"category":{"type":"string","example":"Web, Mobile & Software Dev","description":"Only jobs in this Upwork category: its name ('Web, Mobile & Software Dev', 'Design & Creative') or its uid. Comma-separated for several (either matches). Call `filters` for all names and uids."},"subcategory":{"type":"string","example":"Web Development","description":"Only jobs in this Upwork subcategory: its name or uid. Comma-separated for several. Call `filters` for the list (each category's `subcategories`)."},"job_type":{"type":"string","enum":["hourly","fixed"],"example":"hourly","description":"Contract type. Accepts both, comma-separated."},"experience_level":{"type":"string","enum":["entry","intermediate","expert"],"example":"expert","description":"Experience level the buyer asked for. Comma-separated for several."},"duration":{"type":"string","enum":["week","month","semester","ongoing"],"example":"month","description":"Project length: week = less than a month, month = 1–3 months, semester = 3–6 months, ongoing = more than 6 months. The spelled-out labels ('1_to_3_months', 'more_than_6_months') are accepted too."},"workload":{"type":"string","enum":["as_needed","full_time"],"example":"full_time","description":"Hours per week: as_needed (under 30) or full_time (30+)."},"client_location":{"type":"string","example":"United Kingdom","description":"Where the CLIENT is: a country ('Germany'), a region ('Europe') or a sub-region ('Northern Europe'). Comma-separated for several. Call `filters` for the exact 263 accepted values."},"client_hires":{"type":"string","enum":["0","1-9","10-"],"example":"10-","description":"How many freelancers this client has ever hired: 0 (never hired), 1-9, or 10- (ten or more)."},"timezone":{"type":"string","example":"America/Los_Angeles","description":"Client timezone, as an IANA name. Call `filters` for the 72 values Upwork accepts."},"skill_uid":{"type":"string","example":"996364628025274386","description":"Require a specific Upwork SKILL, by its numeric uid. Take the uid from any job's `skills_detail[].uid` in a previous response — Upwork publishes no skill directory to a logged-out visitor, so that is where the values come from. Comma-separated for several."},"sort":{"type":"string","enum":["relevance","newest"],"default":"relevance","example":"newest","description":"Result order. `newest` sorts by posting time."},"posted_within_hours":{"type":"integer","minimum":1,"maximum":2160,"example":24,"description":"Only jobs posted in the last N hours. Upwork gives a logged-out visitor no posted-date filter, so this one is applied by us: the search is forced to newest-first and paging stops at the first job older than the window. `filtered_out` in the response says how many rows the cut removed."}}},"example":{"query":"python","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/upwork/v1/job":{"post":{"operationId":"upwork_job","summary":"Everything Upwork publishes about one job: the full brief, budget (fixed amount or hourly range), category and occupation, skills with mandatory/nice-to-have weighting, experience level, project lengt","description":"Everything Upwork publishes about one job: the full brief, budget (fixed amount or hourly range), category and occupation, skills with mandatory/nice-to-have weighting, experience level, project length in weeks, freelancer requirements (countries, languages, minimum job-success score and hours), how many people have applied, been interviewed and been hired, and the client's history — country, city, timezone, total spend, jobs posted, hires, hours billed, review count, rating and member-since date. Plus Upwork's own list of similar jobs. Note that Upwork withholds a minority of listed jobs from anyone who is not signed in; those return NOT_FOUND. `search` already carries the full brief, budget, skills and posting time for every job, so this endpoint is for the ones you shortlist.","tags":["upwork"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"~021967158918616440889","description":"The job: its cipher id ('~02…' as `search` returns in `cipher_id`), a full Upwork job URL, or the bare numeric id."}},"required":["id"]},"example":{"id":"~022103052334483241712"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/upwork/v1/filters":{"post":{"operationId":"upwork_filters","summary":"The exact filter vocabulary Upwork's own job search ships — every accepted client location (263 countries, regions and sub-regions), timezone (72), contract type, experience level, project length, wor","description":"The exact filter vocabulary Upwork's own job search ships — every accepted client location (263 countries, regions and sub-regions), timezone (72), contract type, experience level, project length, workload and client-hire band. Read straight off the live search page, so it cannot drift from what `search` accepts.","tags":["upwork"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}