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. Free 14 days - after pay only $29 per month!
upwork@vistorio.online
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 value of this property is 10
From Date
fromDatestringOptional
Filter jobs posted on or after this date. Set by default to 14 days ago. Due to technical limitations, for best results, try to always provide this parameter if you are interested in jobs older than a week. Use ISO format (YYYY-MM-DD) or with time (YYYY-MM-DDTHH:MM:SSZ). Leave empty to include all historical jobs. Examples: '2025-01-01' for jobs from New Year, '2025-08-01T00:00:00Z' for August 1st with specific time.
To Date
toDatestringOptional
Filter jobs posted up to this date. Use ISO format (YYYY-MM-DD) or with time (YYYY-MM-DDTHH:MM:SSZ). Leave empty to include all future jobs. Examples: '2025-12-31' for end of year, '2025-08-15T23:59:59Z' for mid-August cutoff.
Job Categories
jobCategoriesarrayOptional
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'.
Include Keywords
includeKeywords.keywordsarrayOptional
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.
Match in Title
includeKeywords.matchTitlebooleanOptional
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.
Match in Description
includeKeywords.matchDescriptionbooleanOptional
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.
Match in Skills
includeKeywords.matchSkillsbooleanOptional
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.
Exclude Keywords
excludeKeywords.keywordsarrayOptional
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.
Match in Title
excludeKeywords.matchTitlebooleanOptional
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'.
Match in Description
excludeKeywords.matchDescriptionbooleanOptional
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.
Match in Skills
excludeKeywords.matchSkillsbooleanOptional
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.
Allow Unspecified Budget
budget.allowUnspecifiedBudgetbooleanOptional
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.
Min Hourly Rate (USD)
budget.hourlyRate.minstringOptional
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.
Max Hourly Rate (USD)
budget.hourlyRate.maxstringOptional
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.
Min Average Hourly Rate (USD)
budget.avgHourlyRate.minstringOptional
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.
Max Average Hourly Rate (USD)
budget.avgHourlyRate.maxstringOptional
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.
Min Fixed Price (USD)
budget.fixedPrice.minstringOptional
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.
Max Fixed Price (USD)
budget.fixedPrice.maxstringOptional
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.
Min Connects Required
budget.connectsPrice.minintegerOptional
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.
Max Connects Required
budget.connectsPrice.maxintegerOptional
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.
Contract Durations
budget.jobDurationsarrayOptional
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.
Weekly Workloads
budget.hourlyWorkloadsarrayOptional
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.
Accept No Avg Rate History
budget.noAvgHourlyRatePaidbooleanOptional
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.
Accept Zero Hire Rate
budget.noHireRatebooleanOptional
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.
Contract-to-Hire Only
budget.onlyContractToHirebooleanOptional
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.
Min Client Hire Rate (%)
budget.minClientHireRateintegerOptional
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.
Company Size
client.companySizeRangearrayOptional
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.
Exclude Languages
client.descriptionLanguage.excludearrayOptional
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.
Include Languages Only
client.descriptionLanguage.includearrayOptional
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.
Client Hire History
client.hireHistoryarrayOptional
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.
Include Client Locations
client.includeLocationsarrayOptional
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.
Exclude Client Locations
client.excludeLocationsarrayOptional
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.
Include Industries
client.includeIndustryarrayOptional
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.
Exclude Industries
client.excludeIndustryarrayOptional
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.
Include No-Feedback Clients
client.includeWithNoFeedbackbooleanOptional
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.
Min Client Total Spent (USD)
client.totalSpent.minstringOptional
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.
Max Client Total Spent (USD)
client.totalSpent.maxstringOptional
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.
Min Client Rating
client.minFeedbackScorestringOptional
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.
Payment Method Verified
client.paymentMethodVerifiedbooleanOptional
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.
Phone Number Verified
client.phoneNumberVerifiedbooleanOptional
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
client.timezonesarrayOptional
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.
Vendor Types
vendor.typearrayOptional
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.
Required Languages
vendor.languagesarrayOptional
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.
English Proficiency
vendor.englishProficiencyEnumOptional
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.
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.
Min Job Success Score
vendor.minCustomJobScorestringOptional
Filter for jobs requiring freelancers with at least this Job Success Score (0-100). Higher requirements indicate quality-focused clients but limit your competition pool. Examples: '90+' for top-tier jobs, '80+' for quality clients, '70+' for reasonable minimum standards.
Include Vendor Locations
vendor.includeLocationsarrayOptional
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.
Featured Jobs Only
vendor.includeFeaturedbooleanOptional
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.
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.
Exclude Jobs With Questions
vendor.excludeWithQuestionsbooleanOptional
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.
Send run metadata as a separate message preceeding the job notifications. Includes run URL, several dataset URLs and total number of results.
Limit
notifications.limitintegerOptional
Limit amount of notifications sent per platform. If not all jobs fit the limit, you will receive notifications only about the newest.
Default value of this property is 3
Telegram Bot Token
notifications.telegram.tokenstringOptional
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'
Telegram Channel/Chat ID
notifications.telegram.channelIdstringOptional
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
Discord Bot Token
notifications.discord.tokenstringOptional
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'
Discord Channel ID
notifications.discord.channelIdstringOptional
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'
Slack Bot Token
notifications.slack.tokenstringOptional
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'
Slack Channel ID/Name
notifications.slack.channelIdstringOptional
Slack channel ID where notifications will be sent. Bot must be added to the channel first. Example: 'C1234567890' for channel ID
