Upwork Jobs Scraper Extract structured job listings from Upwork.com. Ideal for job seekers, recruiters, and market researchers looking to analyze job market trends, skills in demand, and competitive insights. --- ## Features - Comprehensive Job Scraping: - Extract detailed job postings including titles, descriptions, budgets, and requirements. - Support for various job types (hourly, fixed-price) and experience levels. - Advanced Search Filters: - Filter by location, job type, budget range, client history, and more. - Support for complex search queries with multiple parameters. - Performance Optimized: - Configurable concurrency and retry settings for reliable scraping. - Built-in proxy rotation with residential IP support to avoid blocks. - Structured Data Output: - Clean, normalized data in JSON format ready for analysis. - Consistent schema for easy integration with databases and analytics tools. --- ## Getting Started ### Basic Usage 1. Configure Input: - Add Upwork job URLs to the startUrls array. - Set your preferred scraping limits and proxy settings. 2. Run the Scraper: - Execute the scraper via Apify platform or CLI. - Monitor progress through the Apify dashboard. 3. Export Data: - Download results in JSON, CSV, or other supported formats. - Use webhooks or API to integrate with your workflow. ### Example Input json { "startUrls": [ { "url": "https://www.upwork.com/jobs/~0123456789abcdef" }, { "url": "https://www.upwork.com/freelance-jobs/apply/Pitchbook-Data-Extraction-for-Paddle-Companies_~021933418908659249795/" }, { "url": "https://www.upwork.com/nx/search/jobs/?q=web+development" } ], "maxItems": 100, "maxConcurrency": 10, "minConcurrency": 1, "maxRequestRetries": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } --- ## Input Configuration ### Input Fields Explained | Parameter | Description | Default | |-----------------------|-----------------------------------------------------------------------------|---------| | startUrls | Array of Upwork job URLs or search result pages to start scraping. | [] | | maxItems | Maximum number of job listings to scrape per run. | 100 | | maxConcurrency | Maximum number of pages to process simultaneously. | 10 | | minConcurrency | Minimum number of pages to keep in processing queue. | 1 | | maxRequestRetries | Number of times to retry failed requests before giving up. | 100 | | proxy | Proxy configuration for making requests. Residential proxies recommended. | Apify Proxy | | cookies | (Optional) Authentication cookies if accessing protected content. | [] | ### Supported URL Formats #### 1. Job Search URLs Search for jobs using Upwork's search functionality: https://www.upwork.com/nx/search/jobs/?q=airbnb #### 2. Individual Job Postings Scrape specific job postings using these URL formats: https://www.upwork.com/freelance-jobs/apply/Pitchbook-Data-Extraction-for-Paddle-Companies_~021933418908659249795/ https://www.upwork.com/jobs/~021897592604309915141 #### 3. Advanced Search with Filters Use Upwork's advanced search parameters: https://www.upwork.com/nx/search/jobs/?q=full+stack+data+scientist&sort=recency&location=Americas,Europe --- ## Advanced Search Parameters The scraper supports various Upwork search parameters that can be included in your start URLs: - q: Search query (e.g., web+development) - sort: Sort order (recency, relevance) - location: Filter by location (comma-separated values) - t: Job type (0 for hourly, 1 for fixed-price) - amount: Budget range (e.g., 100-500) - client_hires: Client hiring history (e.g., 0,1-9,10-) - payment_verified: Show only verified payments (1 for true) - timezone: Filter by timezone (comma-separated values) Example with multiple filters: https://www.upwork.com/nx/search/jobs/?q=react&sort=recency&location=Americas,Europe&t=1&amount=100-500&payment_verified=1 --- ## Output Structure json { "hiredApplicantNames": null, "opening": { "job": { "status": "ACTIVE", "postedOn": "2025-06-22T08:27:45.795Z", "publishTime": "2025-06-22T08:27:46.991Z", "sourcingTime": null, "startDate": null, "deliveryDate": null, "workload": null, "contractorTier": "INTERMEDIATE", "description": "We are Nova9 Marketing, a fast-growing digital marketing startup based in Seychelles, focused on helping Airbnbs, boutique hotels, and short-term rentals grow their online presence and increase direct bookings.\n\nOur services range from OTA listing optimization and dynamic pricing to social media management, visual branding, and Meta (Facebook/Instagram) ads.\n\nWe’re now looking to bring on a Social Media Manager with strong experience in Instagram and Facebook content creation, especially for brands in hospitality, real estate, travel, or lifestyle.\n\nThis is a long-term, remote position with the opportunity to manage multiple client accounts as we grow. You’ll be working closely with our video editor, virtual assistant, and creative director to deliver premium social media experiences for our clients.\n\n🛠 What You’ll Be Responsible For:\n\t•\tCreating monthly content plans (feed + story + Reel structure)\n\t•\tWriting engaging, branded captions with CTAs and emojis\n\t•\tSelecting and suggesting photos or clips from client shoot folders\n\t•\tCoordinating 6 Reels/month (our editor will handle the video – you guide the direction)\n\t•\tScheduling content via Later, Metricool, or similar\n\t•\tMonitoring basic engagement (replying to DMs/comments 2–3 times per week)\n\t•\tDelivering monthly performance reports using in-platform analytics\n\n✅ Requirements:\n\t•\t1+ year experience managing Instagram and Facebook for clients (travel/hospitality preferred)\n\t•\tConfident writing engaging, on-brand captions in English\n\t•\tBasic understanding of Reels hooks, trends, and storytelling\n\t•\tComfortable using Canva, Later/Metricool/Buffer, and Google Drive\n\t•\tHighly organized and proactive communicator\n\t•\tBonus: Familiarity with TikTok and short-form video trends\n💼 Scope & Rate:\n\t•\tWe’re offering $250–$300/month to start per client\n\t•\tFirst project will be a trial month for 1 property account\n\t•\tIf successful, we’ll increase workload and scale you into multiple accounts\n\t•\tFlexible working hours – we care more about quality and reliability than timezone\n\n🌴 Why Work With Us:\n\t•\tWe’re a creative team building something big in a niche with global growth potential\n\t•\tYou’ll work with beautiful, high-quality content (tropical hotels, beach villas, aerial shots)\n\t•\tDirect line of communication with the founder – no corporate fluff\n\t•\tRemote, independent, outcome-driven environment\n\t•\tLong-term growth opportunities — we want team players, not gig hoppers", "info": { "ciphertext": "~021936702637394960044", "id": "1936702637394960044", "type": "FIXED", "access": "PUBLIC_INDEX", "title": "Social Media Manager for Airbnb & Hotels", "hideBudget": false, "createdOn": "2025-06-22T08:27:45.795Z", "notSureProjectDuration": false, "notSureFreelancersToHire": false, "notSureExperienceLevel": false, "notSureLocationPreference": false, "premium": false }, "segmentationData": [ { "customValue": null, "label": "Ongoing project", "name": "Employment", "sortOrder": 1, "type": "EMPLOYMENT", "value": "EMPLOYMENT_POSITION", "skill": null } ], "sandsData": { "occupation": { "freeText": null, "ontologyId": "upworkOccupation:socialmediamarketing", "prefLabel": "Social Media Marketing", "id": "1017484851352698999", "uid": "1017484851352698999" }, "ontologySkills": [ { "groupId": "1549040540813496320", "id": "1045317701570953216", "freeText": null, "prefLabel": "Travel & Hospitality", "groupPrefLabel": "Industry" } ], "additionalSkills": [ { "groupId": null, "id": "1052162208978227208", "freeText": null, "prefLabel": "Facebook" }, { "groupId": null, "id": "1052162208978227206", "freeText": null, "prefLabel": "Instagram" }, { "groupId": null, "id": "1204836476859301888", "freeText": null, "prefLabel": "Social Media Content Creation" }, { "groupId": null, "id": "1031626781101637632", "freeText": null, "prefLabel": "Social Media Management" } ] }, "category": { "name": "Digital Marketing", "urlSlug": "digital-marketing" }, "categoryGroup": { "name": "Sales & Marketing", "urlSlug": "sales-marketing" }, "budget": { "amount": 300, "currencyCode": "USD" }, "annotations": { "tags": [ "jsi_contractToHire", "contractToHireSet", "searchable", "C2HJobsOptInEducation" ] }, "engagementDuration": { "label": "1 to 3 months", "weeks": 9 }, "extendedBudgetInfo": { "hourlyBudgetMin": null, "hourlyBudgetMax": null, "hourlyBudgetType": null }, "attachments": [], "clientActivity": { "lastBuyerActivity": "2025-06-22T08:52:15.177Z", "totalApplicants": 20, "totalHired": 0, "totalInvitedToInterview": 0, "unansweredInvites": 0, "invitationsSent": 0, "numberOfPositionsToHire": 1 } }, "qualifications": { "countries": null, "earnings": null, "groupRecno": null, "languages": null, "localDescription": null, "localFlexibilityDescription": null, "localMarket": false, "minJobSuccessScore": 0, "minOdeskHours": 0, "onSiteType": null, "prefEnglishSkill": "ANY", "regions": null, "risingTalent": false, "shouldHavePortfolio": false, "states": null, "tests": null, "timezones": null, "type": "ANY", "locationCheckRequired": false, "group": null, "location": null, "locations": null }, "questions": [] }, "buyer": { "enterprise": false, "isPaymentMethodVerified": false, "info": { "location": { "offsetFromUtcMillis": 0, "countryTimezone": "Etc/UTC (UTCZ)", "city": null, "country": "Seychelles" }, "stats": { "totalAssignments": 0, "activeAssignmentsCount": 0, "hoursCount": 0, "feedbackCount": 0, "score": 0, "totalJobsWithHires": 0, "totalCharges": null }, "company": { "name": null, "companyId": "1931041000145612262", "isEDCReplicated": null, "contractDate": "2025-06-06T00:00:00.000Z", "profile": { "industry": "Travel & Hospitality", "size": 1 } }, "jobs": { "openCount": 3, "postedCount": 3, "openJobs": [ { "id": "1936712169910544263", "uid": "1936712169910544263", "isPtcPrivate": false, "ciphertext": "~021936712169910544263", "title": "Meta Ads Specialist for Airbnb & Boutique Hotels", "type": "FIXED" }, { "id": "1936698126381745887", "uid": "1936698126381745887", "isPtcPrivate": false, "ciphertext": "~021936698126381745887", "title": "OTA Listing & Pricing Optimization Expert (Airbnb/Booking/VRBO)", "type": "FIXED" } ] }, "avgHourlyJobsRate": null }, "workHistory": [] }, "currentUserInfo": { "owner": false, "freelancerInfo": { "profileState": "AUTO_ACCEPTED", "applied": null, "devProfileCiphertext": "~01d7fa411418639c50", "hired": null, "application": null, "pendingInvite": null, "contract": null, "hourlyRate": { "amount": 99 }, "qualificationsMatches": { "matches": [ { "clientPreferred": "all", "clientPreferredLabel": "Any", "freelancerValue": "IC", "freelancerValueLabel": "Not Specified", "qualification": "FreelancerType", "qualified": true }, { "clientPreferred": "0", "clientPreferredLabel": "At least 0%", "freelancerValue": "0", "freelancerValueLabel": "0%", "qualification": "MinimumJobSuccessScore", "qualified": true }, { "clientPreferred": "0", "clientPreferredLabel": "Any", "freelancerValue": "4", "freelancerValueLabel": "Native Or Bilingual", "qualification": "EnglishLevel", "qualified": true }, { "clientPreferred": "0", "clientPreferredLabel": "At least 0 hours", "freelancerValue": "0", "freelancerValueLabel": "0", "qualification": "HoursBilled", "qualified": true }, { "clientPreferred": "ANY", "clientPreferredLabel": "Any", "freelancerValue": "0.00", "freelancerValueLabel": "0.00", "qualification": "Earnings", "qualified": true }, { "clientPreferred": "Any", "clientPreferredLabel": null, "freelancerValue": "en", "freelancerValueLabel": "English", "qualification": "Language", "qualified": true } ] } } }, "similarJobs": [], "workLocation": { "onSiteCity": null, "onSiteCountry": null, "onSiteReason": null, "onSiteReasonFlexible": null, "onSiteState": null, "onSiteType": null }, "phoneVerificationStatus": { "status": "VERIFIED" }, "applicantsBidsStats": null, "specializedProfileOccupationId": "1017484851352698999", "applicationContext": { "freelancerAllowed": false, "clientAllowed": true }, "basicInfo": { "id": "1936702637394960044", "title": "Social Media Manager for H^Airbnb^H & Hotels", "description": "We are Nova9 Marketing, a fast-growing digital marketing startup based in Seychelles, focused on helping Airbnbs, boutique hotels, and short-term rentals grow their online presence and increase direct bookings.\n\nOur services range from OTA listing optimization and dynamic pricing to social media management, visual branding, and Meta (Facebook/Instagram) ads.\n\nWe’re now looking to bring on a Social Media Manager with strong experience in Instagram and Facebook content creation, especially for brands in hospitality, real estate, travel, or lifestyle.\n\nThis is a long-term, remote position with the opportunity to manage multiple client accounts as we grow. You’ll be working closely with our video editor, virtual assistant, and creative director to deliver premium social media experiences for our clients.\n\n🛠 What You’ll Be Responsible For:\n\t•\tCreating monthly content plans (feed + story + Reel structure)\n\t•\tWriting engaging, branded captions with CTAs and emojis\n\t•\tSelecting and suggesting photos or clips from client shoot folders\n\t•\tCoordinating 6 Reels/month (our editor will handle the video – you guide the direction)\n\t•\tScheduling content via Later, Metricool, or similar\n\t•\tMonitoring basic engagement (replying to DMs/comments 2–3 times per week)\n\t•\tDelivering monthly performance reports using in-platform analytics\n\n✅ Requirements:\n\t•\t1+ year experience managing Instagram and Facebook for clients (travel/hospitality preferred)\n\t•\tConfident writing engaging, on-brand captions in English\n\t•\tBasic understanding of Reels hooks, trends, and storytelling\n\t•\tComfortable using Canva, Later/Metricool/Buffer, and Google Drive\n\t•\tHighly organized and proactive communicator\n\t•\tBonus: Familiarity with TikTok and short-form video trends\n💼 Scope & Rate:\n\t•\tWe’re offering $250–$300/month to start per client\n\t•\tFirst project will be a trial month for 1 property account\n\t•\tIf successful, we’ll increase workload and scale you into multiple accounts\n\t•\tFlexible working hours – we care more about quality and reliability than timezone\n\n🌴 Why Work With Us:\n\t•\tWe’re a creative team building something big in a niche with global growth potential\n\t•\tYou’ll work with beautiful, high-quality content (tropical hotels, beach villas, aerial shots)\n\t•\tDirect line of communication with the founder – no corporate fluff\n\t•\tRemote, independent, outcome-driven environment\n\t•\tLong-term growth opportunities — we want team players, not gig hoppers", "relevanceEncoded": "{\"position\":\"3\"}", "ontologySkills": [ { "uid": "1045317701570953216", "parentSkillUid": null, "prefLabel": "Travel & Hospitality", "prettyName": "Travel & Hospitality", "freeText": null, "highlighted": false }, { "uid": "1052162208978227208", "parentSkillUid": null, "prefLabel": "Facebook", "prettyName": "Facebook", "freeText": null, "highlighted": false }, { "uid": "1052162208978227206", "parentSkillUid": null, "prefLabel": "Instagram", "prettyName": "Instagram", "freeText": null, "highlighted": false }, { "uid": "1204836476859301888", "parentSkillUid": null, "prefLabel": "Social Media Content Creation", "prettyName": "Social Media Content Creation", "freeText": null, "highlighted": false }, { "uid": "1031626781101637632", "parentSkillUid": null, "prefLabel": "Social Media Management", "prettyName": "Social Media Management", "freeText": null, "highlighted": false } ], "isSTSVectorSearchResult": false, "connectPrice": 8, "applied": false, "upworkHistoryData": { "client": { "paymentVerificationStatus": null, "country": "Seychelles", "totalReviews": 0, "totalFeedback": 0, "hasFinancialPrivacy": false, "totalSpent": null }, "freelancerClientRelation": { "lastContractRid": null, "companyName": null, "lastContractTitle": null } }, "jobTile": { "job": { "id": "1936702637394960044", "ciphertext": "~021936702637394960044", "jobType": "FIXED", "weeklyRetainerBudget": null, "hourlyBudgetMax": null, "hourlyBudgetMin": null, "hourlyEngagementType": null, "contractorTier": "IntermediateLevel", "sourcingTimestamp": null, "createTime": "2025-06-22T08:27:45.795Z", "publishTime": "2025-06-22T08:27:46.991Z", "enterpriseJob": false, "personsToHire": 1, "premium": false, "totalApplicants": 20, "hourlyEngagementDuration": null, "fixedPriceAmount": { "isoCurrencyCode": null, "amount": "300.0" }, "fixedPriceEngagementDuration": { "id": "474250516458926082", "rid": 3, "label": "1 to 3 months", "weeks": 9, "ctime": "2014-06-04T17:59:10.123Z", "mtime": "2014-06-04T17:59:10.123Z" } } } } } ### Field Explanations #### Job Opening Details | Field | Type | Description | Example/Notes | |-------|------|-------------|---------------| | opening.job.status | String | Current status of the job posting | ACTIVE, CLOSED, etc. | | opening.job.postedOn | String | When the job was originally posted | ISO 8601 format | | opening.job.publishTime | String | When the job was published | ISO 8601 format | | opening.job.description | String | Full job description including requirements and responsibilities | HTML/text content | | opening.job.contractorTier | String | Experience level required | INTERMEDIATE, EXPERT, etc. | | opening.job.workload | String | Expected workload | FULL_TIME, PART_TIME, etc. | | opening.job.info.title | String | Job title | Plain text | | opening.job.info.ciphertext | String | Encoded job identifier | Used in URLs | | opening.job.info.type | String | Job type | FIXED, HOURLY | | opening.job.budget.amount | Number | Budget amount | Currency specified in budget.currencyCode | | opening.job.budget.currencyCode | String | Currency code | USD, EUR, etc. | | opening.job.engagementDuration.weeks | Number | Expected project duration in weeks | | | opening.job.engagementDuration.label | String | Human-readable duration | e.g., "1 to 3 months" | | opening.job.clientActivity.totalApplicants | Number | Total number of applicants | | | opening.job.clientActivity.totalHired | Number | Number of candidates hired | | | opening.job.clientActivity.lastBuyerActivity | String | Timestamp of last buyer activity | ISO 8601 format | #### Skills & Categories | Field | Type | Description | Example/Notes | |-------|------|-------------|---------------| | opening.job.sandsData.occupation.prefLabel | String | Main job category | e.g., "Social Media Marketing" | | opening.job.sandsData.occupation.ontologyId | String | Internal category ID | | | opening.job.sandsData.ontologySkills[] | Array | Industry/topical skills | Array of skill objects | | opening.job.sandsData.additionalSkills[] | Array | Specific skills/tools | Array of skill objects | | opening.job.category.name | String | Job category | e.g., "Digital Marketing" | | opening.job.categoryGroup.name | String | Category group | e.g., "Sales & Marketing" | #### Client/Buyer Information | Field | Type | Description | Example/Notes | |-------|------|-------------|---------------| | buyer.info.location.country | String | Client's country | | | buyer.info.location.countryTimezone | String | Client's timezone | | | buyer.info.stats.totalAssignments | Number | Total jobs posted by client | | | buyer.info.stats.hoursCount | Number | Total hours worked by client | | | buyer.info.stats.feedbackCount | Number | Number of feedback entries | | | buyer.info.stats.score | Number | Client's rating score | | | buyer.info.company.profile.industry | String | Client's industry | | | buyer.info.company.profile.size | Number | Company size | | | buyer.info.jobs.openCount | Number | Currently open jobs | | | buyer.info.jobs.postedCount | Number | Total jobs posted | | | buyer.info.jobs.openJobs[] | Array | List of client's other open jobs | Array of job objects | #### Application & Engagement | Field | Type | Description | Example/Notes | |-------|------|-------------|---------------| | currentUserInfo.freelancerInfo.profileState | String | Current user's application state | e.g., "AUTO_ACCEPTED" | | currentUserInfo.freelancerInfo.hourlyRate.amount | Number | User's hourly rate | | | currentUserInfo.freelancerInfo.qualificationsMatches.matches[] | Array | How user matches job requirements | Array of qualification objects | | applicationContext.freelancerAllowed | Boolean | If current user can apply | | | applicationContext.clientAllowed | Boolean | If current user can manage the job | | #### Job Metadata | Field | Type | Description | Example/Notes | |-------|------|-------------|---------------| | basicInfo.id | String | Unique job ID | | | basicInfo.title | String | Job title | | | basicInfo.description | String | Full job description | | | basicInfo.connectPrice | Number | Cost to apply (in Connects) | | | basicInfo.ontologySkills[] | Array | Skills associated with the job | Array of skill objects | | basicInfo.jobTile.job.jobType | String | Type of job | FIXED, HOURLY | | basicInfo.jobTile.job.totalApplicants | Number | Number of applicants | | | basicInfo.jobTile.job.fixedPriceAmount.amount | String | Fixed price amount | If job type is FIXED | | basicInfo.jobTile.job.hourlyBudgetMin | Number | Minimum hourly rate | If job type is HOURLY | | basicInfo.jobTile.job.hourlyBudgetMax | Number | Maximum hourly rate | If job type is HOURLY | | basicInfo.jobTile.job.contractorTier | String | Required experience level | | --- ## Support - For issues or feature requests, please use the Issues section of this actor. - If you need customization or have questions, feel free to contact the author: - Author's website: https://muhamed-didovic.github.io/ - Email: muhamed.didovic@gmail.com ## Additional Services - Request customization or whole dataset: muhamed.didovic@gmail.com - If you need anything else scraped, or this actor customized, email: muhamed.didovic@gmail.com - For API services of this scraper (no Apify fee, just usage fee for the API), contact: muhamed.didovic@gmail.com