Pricing
from $1.50 / 1,000 job results
Try for free
Go to Apify Store
Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP)

Try for free
Get ALL Upwork jobs instantly. Pre-indexed database delivers 10,000+ jobs at once. No cookies, no timeouts, filters that actually work. Perfect for freelancers, agencies, and Clay/Zapier automations. Pay only $0.003 per job - no subscriptions required. upwork@vistorio.online
Pricing
from $1.50 / 1,000 job results
Rating
4.8
(15)
Developer
Upwork Vibe
Actor stats
Bookmarked
1.1K
Total users
249
Monthly active users
4.7 days
Issues response
3 days ago
Last modified
Categories
Jobs
Lead generation
Automation
You can access the Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
Python
JavaScript
CLI
OpenAPI
HTTP
MCP
{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "APwz4DFcxzhePYBpl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/upwork-vibe~upwork-job-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-upwork-vibe-upwork-job-scraper",
        "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/upwork-vibe~upwork-job-scraper/runs": {
      "post": {
        "operationId": "runs-sync-upwork-vibe-upwork-job-scraper",
        "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/upwork-vibe~upwork-job-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-upwork-vibe-upwork-job-scraper",
        "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",
        "required": [
          "limit"
        ],
        "properties": {
          "limit": {
            "title": "Results Limit",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Set the maximum number of job postings to retrieve in your search results. Higher limits provide more opportunities but may take longer to process. Example: Set to 100 for quick daily scans, 1000 for comprehensive weekly searches, or 5000+ for complete market analysis.",
            "default": 10
          },
          "searchPeriod": {
            "title": "Search Period",
            "pattern": "^\\d+\\s+[a-zA-Z]+$",
            "type": "string",
            "description": "When set, overrides From Date and To Date. Sets To Date to the current moment and From Date to now minus the given period. Use a human-friendly format: '<number> <unit>'. Supported units: seconds, minutes, hours, days, weeks, months, years (singular or plural). Examples: '3 days', '2 weeks', '1 month', '1 year'. Leave empty to use From Date and To Date instead."
          },
          "fromDate": {
            "title": "From Date",
            "type": "string",
            "description": "Filter jobs posted on or after this date. Ignored if Search Period is set. Use ISO format (YYYY-MM-DD) or with time (YYYY-MM-DDTHH:MM:SSZ). Leave empty to include all historical jobs."
          },
          "toDate": {
            "title": "To Date",
            "type": "string",
            "description": "Filter jobs posted up to this date. Ignored if Search Period is set. Use ISO format (YYYY-MM-DD) or with time (YYYY-MM-DDTHH:MM:SSZ). Leave empty to include all future jobs."
          },
          "jobCategories": {
            "title": "Job Categories",
            "type": "array",
            "description": "Select specific Upwork job categories to focus your search. Each code represents a different field. Choose multiple categories to broaden your opportunities. Examples: 'Web Development', 'Art & Illustration', 'Digital Marketing', 'Content Writing'.",
            "items": {
              "type": "string",
              "enum": [
                "Accounting & Bookkeeping",
                "Financial Planning",
                "Management Consulting & Analysis",
                "Personal & Professional Coaching",
                "Recruiting & Human Resources",
                "Other - Accounting & Consulting",
                "All - Accounting & Consulting",
                "Data Entry & Transcription Services",
                "Market Research & Product Reviews",
                "Project Management (Admin)",
                "Virtual Assistance",
                "All - Admin Support",
                "Community Management & Tagging",
                "Customer Service & Tech Support",
                "All - Customer Service",
                "AI & Machine Learning",
                "Data Analysis & Testing",
                "Data Extraction/ETL",
                "Data Mining & Management",
                "All - Data Science & Analytics",
                "Art & Illustration",
                "Audio & Music Production",
                "Branding & Logo Design",
                "Graphic, Editorial & Presentation Design",
                "NFT, AR/VR & Game Art",
                "Performing Arts",
                "Photography",
                "Product Design (Creative)",
                "Video & Animation",
                "All - Design & Creative",
                "3D Modeling & CAD",
                "Building & Landscape Architecture",
                "Chemical Engineering",
                "Civil & Structural Engineering",
                "Contract Manufacturing",
                "Electrical & Electronic Engineering",
                "Energy & Mechanical Engineering",
                "Interior & Trade Show Design",
                "Physical Sciences",
                "All - Engineering & Architecture",
                "Database Management & Administration",
                "DevOps & Solution Architecture",
                "ERP/CRM Software",
                "Information Security & Compliance",
                "Network & System Administration",
                "All - IT & Networking",
                "Corporate & Contract Law",
                "Finance & Tax Law",
                "International & Immigration Law",
                "Public Law",
                "All - Legal",
                "Digital Marketing",
                "Lead Generation & Telemarketing",
                "Marketing, PR & Brand Strategy",
                "All - Sales & Marketing",
                "Language Tutoring & Interpretation",
                "Translation & Localization Services",
                "All - Translation",
                "AI Apps & Integration",
                "Blockchain, NFT & Cryptocurrency",
                "Desktop Application Development",
                "Ecommerce Development",
                "Game Design & Development",
                "Mobile Development",
                "Product Management & Scrum",
                "QA Testing",
                "Scripts & Utilities",
                "Web & Mobile Design",
                "Web Development",
                "Other - Software Development",
                "All - Web, Mobile & Software Dev",
                "Content Writing",
                "Editing & Proofreading Services",
                "Professional & Business Writing",
                "Sales & Marketing Copywriting",
                "All - Writing"
              ]
            }
          },
          "includeKeywords.keywords": {
            "title": "Include Keywords",
            "type": "array",
            "description": "List keywords that jobs MUST contain to appear in results. Jobs need to match at least one keyword. Use specific terms for better targeting. Examples: ['React', 'Next.js', 'TypeScript'] for frontend development, ['logo design', 'branding', 'corporate identity'] for design work, ['SEO', 'content marketing', 'Google Ads'] for marketing roles.",
            "items": {
              "type": "string"
            }
          },
          "includeKeywords.matchTitle": {
            "title": "Match in Title",
            "type": "boolean",
            "description": "Search for your include keywords in job titles. Recommended for finding jobs where your skills are the primary focus. Example: Enable to find 'React Developer Needed' or 'Logo Designer Required' jobs."
          },
          "includeKeywords.matchDescription": {
            "title": "Match in Description",
            "type": "boolean",
            "description": "Search for your include keywords in job descriptions. Useful for finding detailed requirements that match your expertise. Example: Find jobs mentioning 'experience with React hooks' or 'proficient in Photoshop' in the description."
          },
          "includeKeywords.matchSkills": {
            "title": "Match in Skills",
            "type": "boolean",
            "description": "Search for your include keywords in the required skills list. Ideal for targeting jobs that specifically list your technical competencies. Example: Match jobs listing 'JavaScript', 'Adobe Illustrator', or 'Google Analytics' as required skills."
          },
          "excludeKeywords.keywords": {
            "title": "Exclude Keywords",
            "type": "array",
            "description": "List keywords that will automatically exclude jobs from results. If ANY of these terms are found, the job will be filtered out. Examples: ['adult content', 'gambling', 'casino'] for ethical reasons, ['PHP 5', 'Internet Explorer', 'Flash'] for outdated tech, ['crypto', 'blockchain'] if you avoid that space.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords.matchTitle": {
            "title": "Match in Title",
            "type": "boolean",
            "description": "Exclude jobs if forbidden keywords are found in job titles. Effective for quickly filtering out unwanted job types. Example: Exclude jobs titled 'Adult Website Designer' or 'Casino Game Developer'."
          },
          "excludeKeywords.matchDescription": {
            "title": "Match in Description",
            "type": "boolean",
            "description": "Exclude jobs if forbidden keywords are found in job descriptions. Thorough filtering but may be more restrictive. Example: Exclude jobs mentioning 'adult entertainment industry' or 'gambling platform' in the description."
          },
          "excludeKeywords.matchSkills": {
            "title": "Match in Skills",
            "type": "boolean",
            "description": "Exclude jobs if forbidden keywords are found in required skills. Useful for avoiding jobs requiring specific technologies you don't work with. Example: Exclude jobs requiring 'COBOL', 'Assembly', or other technologies you don't know."
          },
          "budget.allowUnspecifiedBudget": {
            "title": "Allow Unspecified Budget",
            "type": "boolean",
            "description": "Include jobs where the client hasn't specified a budget range. These jobs may offer negotiable rates but require more discussion during the proposal process. Example: Jobs posting 'Budget negotiable' or 'Discuss rate in interview' instead of specific amounts."
          },
          "budget.hourlyRate.min": {
            "title": "Min Hourly Rate (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Set the lowest hourly rate you're willing to accept. Only jobs offering at least this amount per hour will be included. Consider your minimum viable rate for profitability. Examples: '$15' for entry-level work, '$50' for experienced developers, '$100+' for specialized expertise."
          },
          "budget.hourlyRate.max": {
            "title": "Max Hourly Rate (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Set the highest hourly rate to filter for. Useful if you want to avoid jobs that seem unrealistically high or target a specific rate range. Leave high for maximum opportunities. Examples: '$75' to avoid potentially fake high-paying posts, '$200' for realistic maximum rates."
          },
          "budget.avgHourlyRate.min": {
            "title": "Min Average Hourly Rate (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Filter by the minimum average hourly rate this client has historically paid freelancers. Indicates the client's typical spending level and payment patterns. Examples: '$20' ensures clients who typically pay decent rates, '$50+' for premium client targeting."
          },
          "budget.avgHourlyRate.max": {
            "title": "Max Average Hourly Rate (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Filter by the maximum average hourly rate this client has historically paid. Useful for targeting clients within your preferred payment range. Examples: '$100' to target mid-market clients, '$50' for budget-conscious projects."
          },
          "budget.fixedPrice.min": {
            "title": "Min Fixed Price (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Set the minimum project budget for fixed-price jobs. Only projects offering at least this total amount will be included. Consider your minimum project value requirements. Examples: '$100' for small tasks, '$1000' for substantial projects, '$5000+' for major developments."
          },
          "budget.fixedPrice.max": {
            "title": "Max Fixed Price (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Set the maximum project budget for fixed-price jobs. Useful for targeting projects within your capacity or avoiding overly complex projects. Examples: '$5000' to avoid massive enterprise projects, '$1000' for manageable smaller projects."
          },
          "budget.connectsPrice.min": {
            "title": "Min Connects Required",
            "minimum": 0,
            "type": "integer",
            "description": "Filter by minimum connects required to submit a proposal. Higher connect costs often indicate more competitive or higher-value jobs. Examples: 6+ connects usually mean premium jobs, 12+ connects often indicate very competitive positions."
          },
          "budget.connectsPrice.max": {
            "title": "Max Connects Required",
            "minimum": 0,
            "type": "integer",
            "description": "Set maximum connects you're willing to spend on a proposal. Useful for managing your connect budget and avoiding overly expensive applications. Examples: Limit to 6 connects for regular applications, 16 connects for special opportunities only."
          },
          "budget.jobDurations": {
            "title": "Contract Durations",
            "type": "array",
            "description": "Select acceptable project lengths based on your availability and preferences. Different durations suit different work styles and commitment levels. Examples: 'UP_TO_ONE_MONTH' for quick projects, 'MORE_THAN_SIX_MONTHS' for stable long-term income.",
            "items": {
              "type": "string",
              "enum": [
                "UNSPECIFIED",
                "UP_TO_ONE_MONTH",
                "UP_TO_THREE_MONTHS",
                "UP_TO_SIX_MONTHS",
                "MORE_THAN_SIX_MONTHS"
              ],
              "enumTitles": [
                "Not specified",
                "Less than 1 month",
                "1-3 months",
                "3-6 months",
                "More than 6 months"
              ]
            }
          },
          "budget.hourlyWorkloads": {
            "title": "Weekly Workloads",
            "type": "array",
            "description": "Choose acceptable weekly time commitments based on your availability. Part-time allows flexibility, full-time offers steady income. Examples: 'LESS_THAN_30_HOURS' for side projects while employed, 'MORE_THAN_30_HOURS' for full-time freelancing.",
            "items": {
              "type": "string",
              "enum": [
                "UNSPECIFIED",
                "LESS_THAN_30_HOURS",
                "MORE_THAN_30_HOURS"
              ],
              "enumTitles": [
                "Not specified",
                "Part-time (< 30 hrs/week)",
                "Full-time (30+ hrs/week)"
              ]
            }
          },
          "budget.noAvgHourlyRatePaid": {
            "title": "Accept No Avg Rate History",
            "type": "boolean",
            "description": "Include clients who have no recorded average hourly rate history. These may be new clients or those who primarily use fixed-price contracts. Example: New startups, first-time Upwork users, or clients who only hire for one-time projects."
          },
          "budget.noHireRate": {
            "title": "Accept Zero Hire Rate",
            "type": "boolean",
            "description": "Include clients who haven't successfully hired anyone yet. These are typically new clients who may offer opportunities but also carry higher risk. Example: Brand new companies on Upwork, clients still learning the platform, or those with very specific requirements."
          },
          "budget.onlyContractToHire": {
            "title": "Contract-to-Hire Only",
            "type": "boolean",
            "description": "Show only jobs that offer potential for permanent employment after the contract period. Ideal if you're seeking long-term career opportunities. Example: 'Start as contractor, potential for full-time position after 3 months' type postings."
          },
          "budget.minClientHireRate": {
            "title": "Min Client Hire Rate (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Require clients to have hired freelancers for at least this percentage of their job posts. Higher rates indicate clients who actually follow through with hiring. Examples: 50% ensures clients hire at least half the time, 80%+ for very reliable clients only."
          },
          "client.companySizeRange": {
            "title": "Company Size",
            "type": "array",
            "description": "Filter by client company size to match your preferred working environment. Larger companies often have bigger budgets but more processes, while smaller companies offer more direct interaction. Examples: Solo entrepreneurs for personal projects, 100+ employees for corporate work, startups (2-10) for innovative projects.",
            "items": {
              "type": "string",
              "enum": [
                "UNSPECIFIED",
                "SOLO_ENTERPRENEUR",
                "UP_TO_10_EMPLOYEES",
                "UP_TO_100_EMPOLOYEES",
                "UP_TO_500_EMPLOYEES",
                "UP_TO_1K_EMPLOYEES",
                "MORE_THAN_1K_EMPLOYEES"
              ],
              "enumTitles": [
                "Not specified",
                "Solo entrepreneur",
                "2-10 employees",
                "11-100 employees",
                "101-500 employees",
                "501-1000 employees",
                "1000+ employees"
              ]
            }
          },
          "client.descriptionLanguage.exclude": {
            "title": "Exclude Languages",
            "type": "array",
            "description": "Exclude job posts written in specific languages using ISO-639-2 codes. Useful if you only work with certain languages. Examples: ['fra', 'deu', 'rus'] to exclude French, German, and Russian job posts, ['spa'] to exclude Spanish-language jobs.",
            "items": {
              "type": "string"
            }
          },
          "client.descriptionLanguage.include": {
            "title": "Include Languages Only",
            "type": "array",
            "description": "Only show job posts written in these languages using ISO-639-2 codes. Ensures you can understand job requirements. Examples: ['eng'] for English-only jobs, ['eng', 'spa'] for English and Spanish jobs, ['fra'] for French-language projects.",
            "items": {
              "type": "string"
            }
          },
          "client.hireHistory": {
            "title": "Client Hire History",
            "type": "array",
            "description": "Filter by the client's hiring experience on Upwork. More experienced clients often have clearer expectations and smoother processes. Examples: 'NONE' for first-time clients with potential, 'MORE_THAN' for experienced clients with proven track records.",
            "items": {
              "type": "string",
              "enum": [
                "NONE",
                "UP_TO",
                "MORE_THAN"
              ],
              "enumTitles": [
                "No hires yet",
                "Up to 10 hires",
                "More than 10 hires"
              ]
            }
          },
          "client.includeLocations": {
            "title": "Include Client Locations",
            "type": "array",
            "description": "Only show jobs from clients in these specific locations. Examples: [{'type': 'COUNTRY', 'value': 'US'}, {'type': 'COUNTRY', 'value': 'CA'}] for North American clients, [{'type': 'REGION', 'value': 'europe'}] for European markets.",
            "items": {
              "type": "object"
            }
          },
          "client.excludeLocations": {
            "title": "Exclude Client Locations",
            "type": "array",
            "description": "Exclude jobs from clients in these specific locations. Examples: [{'type': 'COUNTRY', 'value': 'PK'}, {'type': 'COUNTRY', 'value': 'BD'}] to avoid certain regions, [{'type': 'COUNTRY', 'value': 'BR'}, {'type': 'COUNTRY', 'value': 'MX'}] for timezone preferences.",
            "items": {
              "type": "object"
            }
          },
          "client.includeIndustry": {
            "title": "Include Industries",
            "type": "array",
            "description": "Only show jobs from clients in these specific industries. Useful for building expertise in particular sectors or leveraging existing industry knowledge. Examples: ['Healthcare', 'Fintech'] for regulated industries, ['E-commerce', 'SaaS'] for tech startups, ['Education', 'Non-profit'] for mission-driven work.",
            "items": {
              "type": "string"
            }
          },
          "client.excludeIndustry": {
            "title": "Exclude Industries",
            "type": "array",
            "description": "Exclude jobs from clients in these industries. Helpful for avoiding sectors you don't want to work with due to ethical, legal, or preference reasons. Examples: ['Gambling', 'Adult Entertainment'] for ethical reasons, ['Cryptocurrency', 'MLM'] to avoid risky sectors.",
            "items": {
              "type": "string"
            }
          },
          "client.includeWithNoFeedback": {
            "title": "Include No-Feedback Clients",
            "type": "boolean",
            "description": "Include clients who haven't received any feedback ratings yet. These are typically new clients who may offer good opportunities but with unknown reliability. Example: Brand new companies just starting on Upwork, first-time project posters."
          },
          "client.totalSpent.min": {
            "title": "Min Client Total Spent (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Require clients to have spent at least this amount total on Upwork. Higher spending indicates serious clients with proven payment history and ongoing project needs. Examples: '$1000+' for established clients, '$10000+' for enterprise-level clients, '$100+' for basic verification."
          },
          "client.totalSpent.max": {
            "title": "Max Client Total Spent (USD)",
            "pattern": "^\\d+(\\.\\d{1,2})?$",
            "type": "string",
            "description": "Set an upper limit on client total spending. Useful if you prefer working with smaller clients or want to avoid overly enterprise-level projects. Examples: '$5000' for mid-market clients, '$50000' to avoid massive corporations."
          },
          "client.minFeedbackScore": {
            "title": "Min Client Rating",
            "pattern": "^[0-5](\\.\\d{1,2})?$",
            "type": "string",
            "description": "Require clients to have at least this average feedback score (0-5 scale). Higher ratings indicate clients who are easier to work with and provide clear requirements. Examples: '4.0' for good clients, '4.5+' for excellent clients only, '3.5' for reasonable minimum."
          },
          "client.paymentMethodVerified": {
            "title": "Payment Method Verified",
            "type": "boolean",
            "description": "Only include clients with verified payment methods. This significantly reduces the risk of payment issues and indicates serious, professional clients. Example: Clients with verified credit cards, PayPal accounts, or bank transfers on file."
          },
          "client.phoneNumberVerified": {
            "title": "Phone Number Verified",
            "type": "boolean",
            "description": "Only include clients with verified phone numbers. Adds an extra layer of client verification and accountability. Example: Clients who have confirmed their phone via SMS verification code."
          },
          "client.timezones": {
            "title": "Client Timezones",
            "type": "array",
            "description": "Filter for clients in specific timezones using IANA timezone identifiers. Important for real-time collaboration requirements. Examples: ['America/New_York', 'America/Los_Angeles'] for US clients, ['Europe/London', 'Europe/Berlin'] for European clients, ['Asia/Tokyo'] for Japanese market.",
            "items": {
              "type": "string"
            }
          },
          "vendor.type": {
            "title": "Vendor Types",
            "type": "array",
            "description": "Choose whether to show jobs accepting individual freelancers, agencies, or both. Agency jobs often have larger budgets but may require team capabilities. Examples: 'FREELANCER' for solo work, 'AGENCY' for team projects requiring multiple specialists.",
            "items": {
              "type": "string",
              "enum": [
                "UNSPECIFIED",
                "FREELANCER",
                "AGENCY"
              ],
              "enumTitles": [
                "Any",
                "Freelancers only",
                "Agencies only"
              ]
            }
          },
          "vendor.languages": {
            "title": "Required Languages",
            "type": "array",
            "description": "Show only jobs requiring specific languages using ISO-639-1 codes. Ensures jobs match your language capabilities. Examples: ['en'] for English-required jobs, ['es', 'en'] for bilingual Spanish-English positions, ['de'] for German-language projects.",
            "items": {
              "type": "string"
            }
          },
          "vendor.englishProficiency": {
            "title": "English Proficiency",
            "enum": [
              "BASIC",
              "CONVERSATIONAL",
              "FLUENT",
              "NATIVE"
            ],
            "type": "string",
            "description": "Filter jobs by minimum English proficiency requirement. Higher levels often correlate with better communication and more complex projects. Examples: 'BASIC' for simple tasks, 'FLUENT' for client-facing work, 'NATIVE' for content writing or complex communication."
          },
          "vendor.experienceLevel": {
            "title": "Experience Levels",
            "type": "array",
            "description": "Select which experience levels you want to target. Entry-level has less competition but lower rates, Expert level has higher rates but more competition. Examples: 'BEGINNER' for learning opportunities, 'EXPERT' for premium rates, 'INTERMEDIATE' for balanced competition.",
            "items": {
              "type": "string",
              "enum": [
                "BEGINNER",
                "INTERMEDIATE",
                "EXPERT"
              ],
              "enumTitles": [
                "Entry level",
                "Intermediate",
                "Expert"
              ]
            }
          },
          "vendor.minCustomJobScore": {
            "title": "Min Job Success Score",
            "pattern": "^[0-5](\\.\\d{1,2})?$",
            "type": "string",
            "description": "Minimum custom job quality score (0-5 scale). Higher values mean stricter quality filtering. Examples: '4.5' for top-tier jobs only, '3.5' for good quality, '2.5' for reasonable minimum."
          },
          "vendor.includeLocations": {
            "title": "Include Vendor Locations",
            "type": "array",
            "description": "Show only jobs seeking freelancers from specific locations. Examples: [{'type': 'COUNTRY', 'value': 'US'}, {'type': 'COUNTRY', 'value': 'CA'}] for North American preference, [{'type': 'COUNTRY', 'value': 'PH'}, {'type': 'COUNTRY', 'value': 'IN'}] for cost-effective regions, [{'type': 'REGION', 'value': 'europe'}] for GDPR compliance.",
            "items": {
              "type": "object"
            }
          },
          "vendor.includeFeatured": {
            "title": "Featured Jobs Only",
            "type": "boolean",
            "description": "Show only featured job posts that clients have paid extra to promote. These jobs often have higher visibility and may indicate more serious clients with larger budgets. Example: Jobs with the 'Featured' badge that appear at the top of search results."
          },
          "vendor.includeWithoutCountryPreference": {
            "title": "Include Location-Agnostic Jobs",
            "type": "boolean",
            "description": "Include jobs where clients have no specific location preferences for freelancers. These jobs are open to talent worldwide and often increase your opportunities. Example: Jobs that say 'Location: Anywhere' or have no geographic restrictions."
          },
          "vendor.excludeWithQuestions": {
            "title": "Exclude Jobs With Questions",
            "type": "boolean",
            "description": "Skip jobs that require answering screening questions as part of the proposal. Saves time if you prefer simpler application processes. Example: Jobs asking 'What is your experience with React?' or 'Describe your design process' before proposal submission."
          },
          "jobIds": {
            "title": "Job IDs",
            "maxItems": 1000,
            "type": "array",
            "description": "Provide a list of Upwork job UIDs to fetch directly (max 1000). Each job requires a separate API call, so this is significantly slower than filter search.\n\nWhen this field is populated, all search filters (keywords, budget, client, vendor) are ignored — only the listed jobs are returned.\n\nThis feature has separate per-job pricing ($0.01/job). Please review the pricing page.\n\nYou can use UIDs from previous search results or from Upwork job URLs.\n\nExample: ['2036837541226083470', '2036123456789012345']",
            "items": {
              "type": "string"
            }
          },
          "addons.enableClientDetails": {
            "title": "Client Details",
            "type": "boolean",
            "description": "Enriches each job result with client work history and feedback from previous freelancers.\n\nRequires an additional API call per job. Enabling this will slow down processing — consider extending your timeout window.\n\nRecommendation: test your filters without addons first to verify result count."
          },
          "addons.enableClientActivity": {
            "title": "Client Activity",
            "type": "boolean",
            "description": "Provides real-time job activity metrics per listing:\n• Number of proposals received\n• Last viewed by client timestamp\n• Number of candidates currently interviewing\n• Number of invites sent by client\n• Number of unanswered invites\n\nRequires an additional API call per job. Enabling this will slow down processing — consider extending your timeout window.\n\nRecommendation: test your filters without addons first to verify result count."
          },
          "addons.enableJobAttachments": {
            "title": "Job Attachments",
            "type": "boolean",
            "description": "Not yet available. Coming soon: fetches file attachments posted by the client with the job listing (PDFs, images, mockups).\n\nEnabling this checkbox will not affect your results or charges."
          },
          "notifications.shouldSendRunMetadata": {
            "title": "Send run metadata",
            "type": "boolean",
            "description": "Send run metadata as a separate message preceeding the job notifications. Includes run URL, several dataset URLs and total number of results."
          },
          "notifications.limit": {
            "title": "Limit",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Limit amount of notifications sent per platform. If not all jobs fit the limit, you will receive notifications only about the newest.",
            "default": 3
          },
          "notifications.telegram.token": {
            "title": "Telegram Bot Token",
            "type": "string",
            "description": "Bot token for sending Telegram notifications. Create a bot via @BotFather on Telegram to get this token. Used to send job alerts, status updates, and error notifications directly to your Telegram. Example: '1234567890:ABCdefGHIjklMNOpqrsTUVwxyz'"
          },
          "notifications.telegram.channelId": {
            "title": "Telegram Channel/Chat ID",
            "type": "string",
            "description": "Telegram chat or channel ID where notifications will be sent. Can be a personal chat ID (starts with numbers) or channel ID (starts with -). Get your chat ID by messaging @userinfobot. Examples: '123456789' for personal chat, '-1001234567890' for channel"
          },
          "notifications.discord.token": {
            "title": "Discord Bot Token",
            "type": "string",
            "description": "Discord bot token for sending notifications. Create a bot application in Discord Developer Portal and copy the bot token. Requires bot to be added to your server with 'Send Messages' permission. Example: 'MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.Gh1234.abcdefghijklmnopqrstuvwxyz1234567890'"
          },
          "notifications.discord.channelId": {
            "title": "Discord Channel ID",
            "type": "string",
            "description": "Discord channel ID where notifications will be posted. Enable Developer Mode in Discord settings, right-click the channel, and select 'Copy ID'. Bot must have access to this channel. Example: '987654321098765432'"
          },
          "notifications.slack.token": {
            "title": "Slack Bot Token",
            "type": "string",
            "description": "Slack bot token (starts with 'xoxb-') for posting notifications. Create a Slack app, add bot token scopes 'chat:write' and 'channels:read', then install to workspace. Example: 'xoxb-1234567890123-1234567890123-abcdefghijklmnopqrstuvwx'"
          },
          "notifications.slack.channelId": {
            "title": "Slack Channel ID/Name",
            "type": "string",
            "description": "Slack channel ID where notifications will be sent. Bot must be added to the channel first. Example: 'C1234567890' for channel ID"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
Upwork Job Search API - Get 10,000+ Jobs Instantly OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP) from the options below:
OpenAPI.json
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP) API in Python
Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP) API in JavaScript
Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP) API through CLI
Upwork Job Scraper | Scrape up to 10k Jobs ✨ (MCP) API
[Deprecated] Upwork Scraper

upwork-vibe/upwork-scraper
DEPRECATED, use https://apify.com/upwork-vibe/upwork-job-scraper instead. Get ALL Upwork jobs instantly. Pre-indexed database delivers 10,000+ jobs at once. No cookies, no timeouts, filters that actually work. Perfect for freelancers, agencies, and Clay/Zapier automations. upwork@vistorio.online
Upwork Vibe
122
4.3
Upwork Extractor

jupri/upwork
💫 Scrape Upwork.com Jobs
cat
1.5K
4.7
Upwork Details Scraper

corpusculus/upwork-details-scraper
Search for jobs on upwork.
oxo
1.0
Upwork Job Scraper

matthewjames/upwork-job-scraper
Scrape recent and relevant Upwork.com jobs, bypasses captchas.
Matthew James
456
4.9
Upwork Job Scraper (Pay Per Result)

matthewjames/upwork-job-scraper-pay-per-result
Scrape recent and relevant Upwork.com jobs, bypasses captchas.
Matthew James
Upwork Job Scraper

neatrat/upwork-job-scraper
Scrape Upwork jobs without limits 🌟 Bypass CAPTCHAs & apply custom filters. Apify is retiring rental Actors, so pricing is changing. For many users around ~7k jobs/month, cost should stay near the old $25. You still get the same no-cookie setup, with in-house Upwork accounts and proxies built in.
Neatrat
2.9K
3.1
Upwork Job Scraper

deltaspider/upwork-job-scraper
Automatically and efficiently scrape Upwork.com job listings.
delta spider
291
4.1
Upwork Job Extractor ⚡

flash_mage/upwork
upwork job extractor ⚡| 0.001 | fast, cheap, cost-effective, reliable, up-to-date, and highly stable data scraping service, optimized for long-term use with the fastest crawling speeds, low container usage, and pricing to boost your upwork job scraper performance!
Flash Mage
747
4.6
Upwork Jobs Finder

sentry/upwork-jobs-finder
Upwork Jobs Finder scrapes Upwork job listings by keyword and exports structured freelance job data, including title, budget, hourly rate, skills, and description. Ideal for Upwork lead generation, job monitoring, market research, and automation workflows.
Sentry
Automatically Apply to Upwork Jobs

big-brain.io/upwork-application
Pass a job application URL, Upwork login information, and messaging and automatically apply to a job. Pair with an Upwork's scraper to apply within minutes of a job being posted.