Skip to content
Examples

Get Results

Retrieve scraped data from Upwork Jobs Scraper

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.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Upwork Jobs Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

pageintegerquery

Page number (default: 1)

Result Fields

job_idstring

Unique Upwork job posting identifier. Example: ~01abc123def456

urlstring

Direct URL to the job posting. Example: https://www.upwork.com/jobs/~01abc123def456

ciphertextstring

Upwork's public job reference (the ~02... token)

titlestring

Job title. Example: Python Developer for Data Pipeline

descriptiontext

Full job description

posted_atdatetime

Date and time published, in UTC. Example: 2026-09-14T10:30:00Z

job_created_atdatetime

Date and time created, in UTC

job_typestring

Hourly or Fixed-Price. Example: Fixed-Price

budgetstring

Human-readable budget. Example: $500

budget_amountfloat

Fixed-price budget as a number. Example: 500.0

hourly_rate_minfloat

Lower bound of hourly rate range

hourly_rate_maxfloat

Upper bound of hourly rate range

durationstring

Expected project duration. Example: 1 to 3 months

duration_weeksinteger

Expected project duration in weeks

workloadstring

Expected weekly workload on hourly jobs

experience_levelstring

Experience level the client asks for. Example: Intermediate

skillsstring

Skills attached to the posting, comma-separated. Example: Python, Pandas, Apache Airflow

Detail Fields

The following fields require job_details: true in settings.

is_enterpriseboolean

True when from an Upwork Enterprise client

freelancers_to_hireinteger

Number of freelancers the client wants

currencystring

Currency of the budget/hourly rate

proposals_countinteger

Number of proposals received

categorystring

Upwork category of the job

category_groupstring

Top-level Upwork category group

job_statusstring

Hiring status of the posting

total_hiredinteger

Freelancers already hired

total_interviewedinteger

Freelancers invited to interview

invitations_sentinteger

Invitations the client sent

last_client_activitydatetime

Last time the client acted on this posting

client_countrystring

Country of the client

client_citystring

City of the client

client_timezonestring

Timezone of the client

client_spendfloat

Total amount the client has spent on Upwork

client_ratingfloat

Average feedback score of the client, out of 5

client_reviews_countinteger

Number of reviews the client has received

client_total_jobsinteger

Number of jobs the client has posted

client_active_jobsinteger

Number of contracts currently running

client_total_hiresinteger

Number of jobs that ended in a hire

client_hoursfloat

Total hours the client has paid for

client_avg_hourly_ratefloat

Average hourly rate the client has paid

client_payment_verifiedboolean

True when payment method is verified

client_member_sincedatetime

Date the client joined Upwork

client_open_jobsinteger

Number of open job postings

allowed_applicant_countriesstring

Countries restricted to, comma-separated

min_job_success_scoreinteger

Minimum Job Success Score required

preferred_english_levelstring

English level the client asks for

rising_talent_onlyboolean

True when only Rising Talent accepted

portfolio_requiredboolean

True when portfolio is required

local_market_onlyboolean

True when restricted to client's local market

similar_job_urlsstring

URLs of similar jobs, comma-separated

Response

200
{"total_results": 1, "data": [{"job_id": "~01abc123def456", "title": "Python Developer for Data Pipeline", "job_type": "Fixed-Price", "budget_amount": 500.0, "experience_level": "Intermediate", "skills": "Python, Pandas, Apache Airflow", "posted_at": "2026-09-14T10:30:00Z"}]}