{ "openapi": "3.0.1", "info": { "title": "Upwork Job Scraper – Ranked Leads, Client Scores & 59+ Filters", "description": "Don't just scrape Upwork — rank it. Every job scored 0–100 on client pay, hire rate & spend, with 59+ filters to surface the jobs worth bidding on. Real-time new-jobs feed, AI skills & summaries, screening questions. For freelancers, agencies & job boards. $2/1,000, no monthly fee.", "version": "1.1", "x-build-id": "T2isELk8qCNlcc35a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hyperbach~upwork-scraper-ai/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hyperbach-upwork-scraper-ai", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/hyperbach~upwork-scraper-ai/runs": { "post": { "operationId": "runs-sync-hyperbach-upwork-scraper-ai", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/hyperbach~upwork-scraper-ai/run-sync": { "post": { "operationId": "run-sync-hyperbach-upwork-scraper-ai", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "clientId": { "title": "Client ID", "minLength": 1, "maxLength": 255, "type": "string", "description": "Unique identifier for the client. The service automatically tracks what jobs this client has already seen.", "default": "default" }, "limit": { "title": "Limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of items to return (1-100).", "default": 50 }, "notifications_only": { "title": "Notifications Only", "type": "boolean", "description": "Only return new jobs since last call (requires notification feed mode).", "default": false }, "fields": { "title": "Fields (output projection)", "type": "array", "description": "Optional list of field names to keep in the dataset output. If empty, all fields are returned. Saves storage cost on long runs. Example: id, title, url, job_score, questions. Always-implicit field `id` is kept whether listed or not.", "items": { "type": "string" } }, "title": { "title": "Job Title", "type": "string", "description": "The job posting title as written by the client. Contains the main description of what work needs to be done." }, "description": { "title": "Description", "type": "string", "description": "Full job description text as written by the client. Contains detailed requirements, expectations, and project scope." }, "category_name": { "title": "Category Name", "enum": [ "Accounting & Consulting", "Admin Support", "Customer Service", "Data Science & Analytics", "Design & Creative", "Engineering & Architecture", "IT & Networking", "Legal", "Sales & Marketing", "Translation", "Web, Mobile & Software Dev", "Writing" ], "type": "string", "description": "Main category of the job (e.g., Web Development, Data Science, Design). Upwork's primary job classification." }, "subcategory_name": { "title": "Subcategory Name", "enum": [ "3D Modeling & CAD", "AI & Machine Learning", "AI Apps & Integration", "Accounting & Bookkeeping", "Art & Illustration", "Audio & Music Production", "Blockchain, NFT & Cryptocurrency", "Branding & Logo Design", "Building & Landscape Architecture", "Chemical Engineering", "Civil & Structural Engineering", "Community Management & Tagging", "Content Writing", "Contract Manufacturing", "Corporate & Contract Law", "Customer Service & Tech Support", "Data Analysis & Testing", "Data Entry & Transcription Services", "Data Extraction/ETL", "Data Mining & Management", "Database Management & Administration", "Desktop Application Development", "DevOps & Solution Architecture", "Digital Marketing", "ERP/CRM Software", "Ecommerce Development", "Editing & Proofreading Services", "Electrical & Electronic Engineering", "Energy & Mechanical Engineering", "Finance & Tax Law", "Financial Planning", "Game Design & Development", "Graphic, Editorial & Presentation Design", "Information Security & Compliance", "Interior & Trade Show Design", "International & Immigration Law", "Language Tutoring & Interpretation", "Lead Generation & Telemarketing", "Legal, Medical & Technical Translation", "Management Consulting & Analysis", "Market Research & Product Reviews", "Marketing, PR & Brand Strategy", "Mobile Development", "NFT, AR/VR & Game Art", "Network & System Administration", "Other - Accounting & Consulting", "Other - Software Development", "Performing Arts", "Personal & Professional Coaching", "Photography" ], "type": "string", "description": "Specific subcategory within the main category (e.g., Front-End Development, Machine Learning). More granular classification." }, "date_posted": { "title": "Date Posted", "type": "string", "description": "When the job was posted on Upwork. Use this to find recent opportunities or analyze posting patterns. Simplest form is a relative age: 7d = posted in the last 7 days, 24h = last day, 2w = last two weeks. A bare number means days (3 = last 3 days). Or give an ISO date (YYYY-MM-DD or full ISO datetime) with >= for newer than that date, <= for older." }, "price_type": { "title": "Price Type", "enum": [ "Fixed-price", "Hourly" ], "type": "string", "description": "How the job is priced: Fixed Price (one-time payment) or Hourly (paid per hour worked)." }, "price": { "title": "Budget/Price - Fixed-price", "type": "string", "description": "The budget amount for the fixed-price job. Use numeric operators like >=1000 for jobs above $1000, or 500-2000 for budgets between $500-2000. Only applies to fixed-price jobs." }, "price_min": { "title": "Hourly Rate - Min", "type": "string", "description": "Lower end of the job's hourly rate band (Upwork jobs advertise a range like $10-35/hr). Hourly jobs only - fixed-price jobs carry their budget in `price` and leave this empty. price_min and price_max together describe the rate window you want, and a job matches when its advertised band OVERLAPS that window. price_min=35 (or >=35) means \"can pay $35/hr or more\" and returns a job advertised at $10-35/hr. The operator decides which end of the window you are setting, so <=35 here means a ceiling and behaves exactly like price_max=35 - a bare number is read as a floor, never as an exact match. Use 25-75 for work paying somewhere in $25-75. Jobs stating no rate are matched on the client's historical hourly rate instead; see include_unspecified_rate." }, "price_max": { "title": "Hourly Rate - Max", "type": "string", "description": "Upper end of the job's hourly rate band (Upwork jobs advertise a range like $10-35/hr). Hourly jobs only - fixed-price jobs carry their budget in `price` and leave this empty. Sets the ceiling of the rate window you want; a job matches when its advertised band overlaps it. price_max=50 (or <=50) means \"can be done at $50/hr or under\". The operator decides which end you are setting, so >=50 here means a floor and behaves exactly like price_min=50 - a bare number is read as a ceiling, never as an exact match. Combine with price_min for a window, e.g. price_min=35 plus price_max=90. Jobs stating no rate are matched on the client's historical hourly rate instead; see include_unspecified_rate." }, "skills": { "title": "Skills", "type": "string", "description": "Comma-separated list of required skills and technologies for the job as specified by the client." }, "experience_level": { "title": "Experience Level", "enum": [ "Entry_level", "Expert", "Intermediate" ], "type": "string", "description": "Required experience level for the job. Exact values: Entry_level, Intermediate, Expert." }, "client_location": { "title": "Client Location", "type": "string", "description": "Geographic location of the client posting the job." }, "jobs_posted": { "title": "Jobs Posted", "type": "string", "description": "Total number of jobs the client has posted on Upwork. Use numeric operators like >=10 for values above threshold, or range syntax like 5-20 for values between 5-20." }, "hire_rate": { "title": "Client Hire Rate", "type": "string", "description": "Percentage of freelancers the client has hired from total applications. Higher rates indicate clients who actively hire rather than just browse. Use >= for clients who hire frequently (>=80), or <= for selective clients (<=50). Null values indicate new clients." }, "open_jobs": { "title": "Open Jobs", "type": "string", "description": "Number of jobs the client currently has open/active. Use numeric operators like <=10 for values below threshold, or range syntax like 5-20 for values between 5-20." }, "total_spent": { "title": "Total Spent", "type": "string", "description": "Total amount the client has spent on Upwork across all their projects. Use numeric operators like >=1000000 for values above threshold, or range syntax like 500000-1000000 for values between 500000-1000000." }, "hires": { "title": "Hires", "type": "string", "description": "Total number of freelancers hired by the client. Use numeric operators like >=10 for values above threshold, or range syntax like 5-20 for values between 5-20." }, "active_hires": { "title": "Active Hires", "type": "string", "description": "Number of freelancers currently hired by the client. Use numeric operators like >=10 for values above threshold, or range syntax like 5-20 for values between 5-20." }, "avg_hourly_rate": { "title": "Client Avg Hourly Rate", "type": "string", "description": "Average hourly rate this client typically pays freelancers. Based on their historical hiring patterns. Filter by client's typical budget range. Use >= for higher-paying clients (>=60) or <= for budget-conscious clients." }, "total_hours": { "title": "Total Hours", "type": "string", "description": "Total number of hours the client has worked on Upwork across all their projects. Use numeric operators like >=100 for values above threshold, or range syntax like 50-200 for values between 50-200." }, "industry": { "title": "Industry", "enum": [ "", "Aerospace", "Agriculture & Forestry", "Art & Design", "Automotive", "Aviation", "Education", "Energy & Utilities", "Engineering & Architecture", "Fashion & Beauty", "Finance & Accounting", "Food & Beverage", "Government & Public Sector", "HR & Business Services", "Health & Fitness", "Legal", "Manufacturing & Construction", "Media & Entertainment", "Military & Defense", "Mining" ], "type": "string", "description": "Main industry the client operates in. Select from available choices." }, "company_size": { "title": "Company Size", "enum": [ "0", "1", "10", "100", "1000", "10000", "2", "500", "None" ], "type": "string", "description": "Size of the client's company. Predefined option for company size. Select from available choices." }, "job_is_premium": { "title": "Job Is Premium", "type": "boolean", "description": "Boolean flag indicating whether job is premium applies to this job." }, "engagement_label": { "title": "Engagement Label", "enum": [ "1 to 3 months", "3 to 6 months", "Less than 1 month", "More than 6 months" ], "type": "string", "description": "Expected duration or type of engagement (e.g., 1 to 3 months, 3 to 6 months, Less than 1 month, Less than 1 week, More than 6 months)." }, "engagement_weeks": { "title": "Engagement Weeks", "enum": [ "3", "9", "18", "52" ], "type": "string", "description": "Project duration in weeks. Options: 1, 3, 9, 18, 52 weeks." }, "hourly_budget_type": { "title": "Hourly Budget Type", "enum": [ "DEFAULT", "MANUAL", "NOT_PROVIDED" ], "type": "string", "description": "Type of hourly budget. Options: AS_NEEDED, DEFAULT, FULL_TIME, MANUAL, NOT_PROVIDED, NOT_SURE, PART_TIME." }, "client_invites_sent": { "title": "Client Invites Sent", "type": "string", "description": "Number of client invites sent to freelancers. Use numeric operators like >=10 for values above threshold, or range syntax like 5-20 for values between 5-20." }, "client_positions_to_hire": { "title": "Client Positions To Hire", "type": "string", "description": "Number of client positions to hire. Use numeric operators like >=10 for values above threshold, or range syntax like 2-10 for values between 2-10." }, "qual_min_hours_week": { "title": "Qual Min Hours Week", "enum": [ "0", "10", "30", "40" ], "type": "string", "description": "Minimum hours per week required for hourly jobs. Options: 10, 30, 40." }, "qual_min_success_score": { "title": "Qual Min Success Score", "enum": [ "0", "80", "90" ], "type": "string", "description": "Minimum Upwork success score required to apply for the job." }, "qual_pref_english": { "title": "Qual Pref English", "enum": [ "ANY", "CONVERSATIONAL", "FLUENT", "NATIVE" ], "type": "string", "description": "Client's preferred English proficiency level for freelancers." }, "qual_rising_talent": { "title": "Qual Rising Talent", "type": "boolean", "description": "Whether the job is open to Upwork Rising Talent (newer freelancers with potential)." }, "qual_portfolio_required": { "title": "Qual Portfolio Required", "type": "boolean", "description": "Whether the client requires a portfolio or work samples to apply." }, "qual_type": { "title": "Qual Type", "enum": [ "AGENCY", "ANY", "INDEPENDENT" ], "type": "string", "description": "Type of freelancer the client is looking for: Agency (team/company), Independent (solo freelancer), or Any (no preference)." }, "buyer_offset_utc": { "title": "Buyer Offset UTC", "type": "string", "description": "UTC offset of the buyer's timezone in milliseconds. Indicates the time difference between the buyer's local time and UTC. Values are in milliseconds. Common offsets: 0 (UTC/GMT), 3600000 (+1 hour, Europe), -28800000 (-8 hours, US West Coast), 28800000 (+8 hours, Asia). Use >= or <= to find clients in specific timezone ranges. Positive values are east of UTC, negative are west." }, "buyer_city": { "title": "Buyer City", "type": "string", "description": "City where the client is located." }, "buyer_feedback_count": { "title": "Buyer Feedback Count", "type": "string", "description": "Number of feedbacks the client has received. Use numeric operators like >=10 for values above threshold, or range syntax like 5-20 for values between 5-20." }, "buyer_score": { "title": "Buyer Score", "type": "string", "description": "Score of the client's performance on Upwork. Use numeric operators like >=5.0 for values above threshold, or range syntax like 4.7-5.0 for values between 4.7-5.0." }, "buyer_contract_date": { "title": "Buyer Contract Date", "type": "string", "description": "Date when the client first registered their account on Upwork. Indicates how long the client has been active on the platform. Use >= for clients registered after a date, <= for before a date. Format: YYYY-MM-DD or ISO datetime. A relative age also works (365d = registered within the last year). Older registration dates indicate more established clients." }, "buyer_payment_verified": { "title": "Buyer Payment Verified", "type": "boolean", "description": "Boolean flag indicating whether the client has verified their payment method on Upwork." }, "created_at": { "title": "Created At", "type": "string", "description": "Timestamp when this job record was created in our system (not the Upwork posting date). Use for tracking when jobs entered our system. Different from date_posted which is Upwork's date." }, "ai_urgency": { "title": "Urgency", "enum": [ "Immediate", "Long-Term", "Moderately Urgent", "Not Urgent", "Urgent", "Very Urgent" ], "type": "string", "description": "AI-detected urgency level of the job based on language and posting patterns." }, "ai_duration": { "title": "Duration", "enum": [ "Flexible", "Flexible Deadline", "Long-Term", "Mid-Term", "Part-Time", "Short-Term" ], "type": "string", "description": "AI-detected project duration based on job description analysis. Indicates expected length and type of engagement." }, "ai_deadline": { "title": "Deadline", "enum": [ "Fixed Deadline", "Flexible Deadline", "Immediate Deadline", "No Deadline" ], "type": "string", "description": "AI-detected deadline type for the job based on urgency indicators and time-sensitive language in the job description." }, "ai_technical_skills": { "title": "Technical Skills (AI Extracted)", "type": "string", "description": "Technical skills explicitly mentioned in the job description, extracted using AI. These are skills directly stated by the client as requirements or preferences." }, "ai_inferred_technical_skills": { "title": "Technical Skills (AI Inferred)", "type": "string", "description": "Technical skills inferred by AI from the job description context, even when not explicitly mentioned. These are skills likely needed based on project requirements and industry patterns." }, "ai_specific_requirements_before_applying": { "title": "Specific Requirements Before Applying", "type": "string", "description": "AI-extracted specific requirements that clients mention applicants must fulfill before applying, such as portfolio submissions, work samples, or specific application instructions." }, "ai_explicit_mention_of_agency": { "title": "Explicit Mention Of Agency", "enum": [ "Agencies Welcome", "No Agencies", "No Mention" ], "type": "string", "description": "AI-detected explicit mention of agency preferences in the job posting. Indicates whether the client welcomes agencies, prefers individual freelancers, or has no specific preference." }, "ai_clients_technical_understanding": { "title": "Client's Technical Understanding", "enum": [ "Expert", "High", "Low", "Moderate" ], "type": "string", "description": "AI-detected assessment of the client's technical understanding based on how they describe their project requirements. Helps identify whether the client has deep technical knowledge, moderate understanding, basic knowledge, or expert-level expertise in the domain." }, "ai_named_entities": { "title": "Named Entities", "type": "string", "description": "AI-extracted named entities from the job description including company names, technologies, frameworks, tools, locations, and other important entities mentioned by the client. This field helps identify specific brands, platforms, or technologies the client is working with." }, "ai_anti_bot_phrase": { "title": "Anti Bot Phrase", "type": "string", "description": "AI-detected anti-bot phrases and instructions used by clients in job descriptions to filter out automated applications and ensure human applicants read the full posting. These phrases typically ask applicants to include specific words, numbers, emojis, or perform certain actions in their proposals to prove they've read the requirements carefully." }, "ai_summary": { "title": "Summary", "type": "string", "description": "AI-generated summary of the job description. Provides a concise overview of the job requirements and responsibilities." }, "keywords": { "title": "Keywords Search", "type": "string", "description": "Full-text search across job title, description, skills, categories, location, industry, and AI-generated fields. Uses PostgreSQL full-text search for fast performance on millions of jobs." }, "exclude_keywords": { "title": "Exclude Keywords", "type": "string", "description": "Exclude jobs containing any of these keywords. Uses the same full-text search across job title, description, skills, categories, location, industry, and AI-generated fields. Perfect for filtering out unwanted job types or technologies." }, "job_score": { "title": "Job Score", "type": "string", "description": "Rule-based 0–100 score that ranks the job by attractiveness. Weighted across price (20), client reputation (42), client spending (40), premium status (5), and location (10). Because 82 of those 100 points come from client reputation and spending, a threshold mostly selects for good clients rather than good briefs. Half of all jobs score under 37 and only 9% reach 70, so start at >=50 and raise it. Jobs with no client spending history skip that 40-point block and therefore score low — a high threshold filters out thin postings as well as weak ones." }, "include_unspecified_rate": { "title": "Jobs With No Stated Rate", "enum": [ "off", "likely", "all" ], "type": "string", "description": "What a rate filter should do with jobs that state no rate - about a third of hourly jobs, plus every fixed-price job (their budget is in `price`). `likely` (default) also returns those jobs when the CLIENT's own historical hourly rate fits your window, which is the best evidence available when the posting itself is silent. `off` returns only jobs with a stated rate that overlaps. `all` returns every rate-unspecified job regardless of evidence." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }