Skip to content
Examples

Update Settings

Configure Upwork Jobs Scraper settings

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POSThttps://api.lobstr.io/v1/squids/{squid_hash}

Configure your Upwork Jobs Scraper squid settings.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Must be application/json. Value: application/json

Squid Parameters

Parameter Type Default Description
rows integer — Number of rows returned per API page
url string — Upwork search URL, keyword, or single job posting link
category string Any Only return jobs from this Upwork category
hourly_or_fixed string Any Filter by hourly or fixed-price jobs
budget_range string — Budget filter as min-max in USD, e.g. 100- or -500
experience_level string Any Entry Level, Intermediate, or Expert
client_history string Any Filter by client's hiring history
client_location string — Only return jobs from clients in this country
posted_within string Any time Only return jobs published within this window
sort string Relevance Relevance or Newest
max_results integer 1000 Stop each task after this many jobs
fetch_since string — Only collect jobs published after this threshold (24h, 7d, or YYYY-MM-DD)
fetch_since_timezone string — Timezone for fetch_since
job_details boolean false Open each job posting to collect client data (country, city, total spent, rating)

Setting job_details: true enables additional detail fields in results.

Code Examples

curl -X POST https://api.lobstr.io/v1/squids/681a0d2e2641326f7b87cda35513618a \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_results": 500,
    "sort": "Newest",
    "experience_level": "Intermediate",
    "job_details": true
  }'

Response

201
{"params": {"max_results": 500, "sort": "Newest", "experience_level": "Intermediate", "job_details": true, "hourly_or_fixed": "Any", "posted_within": "Any time"}}