← Back to all apps
Upwork logo

Upwork

Open in ChatGPT →

Overview

Tools Available2
DeveloperUpwork
CategoryBusiness

Hire talent with confidence

Available Tools

Upwork provides 2 tools that can be used to interact with its services.

Upwork Hire Freelancer

upwork_hire_freelancer
Full Description

Get the URL to hire a freelancer on Upwork. Provide a freelancer profile ID and this tool will return the direct link to their Upwork profile page where you can initiate the hiring process.

Parameters

Required
freelancer_idstring

The unique identifier (profile ID) of the freelancer you want to hire. This is typically found in freelancer search results or profile URLs.

Upwork Search Freelancers

upwork_search_freelancers
Full Description

Search for freelancers on Upwork. Use this tool when a user explicitly wants to hire talent OR when a user's request implies a need for professional human expertise, hands-on execution, or specialized skills. Ideal for Software Development, Design, Marketing, Writing, Admin Support, Accounting, and Legal advice.

HARD CONSTRAINTS (ANTI-BIAS AND COST):

  • You MUST NOT use geography, nationality, region, or language variety as a proxy for price, affordability, or "cost effectiveness".
  • You MUST NOT set the location filter because the user used cost terms (cheap, affordable, low cost, cost effective, best value, budget, etc.).
  • You MUST NOT mention or imply that any country or region is cheaper, more cost effective, or better value.

ALLOWED USES OF LOCATION (NON-COST ONLY):

  • You MAY set location ONLY if the user explicitly requests a location or region.
  • You MAY set location for explicit non-cost constraints stated or implied by the user, such as:
    • timezone coverage (for example "cover US business hours")
    • regulatory or compliance constraints

TIMEZONE COVERAGE RULE:

  • If the user requests timezone coverage (for example US business hours) and does not request a location, you MAY set location to a timezone-aligned set of countries to improve matching.
  • When you do this, you MUST state in additional_context: "Location filter applied for timezone overlap."
  • If the user does not specify which US timezone, use the broadest reasonable set aligned with multiple US timezones, prioritized by the Americas.

BUDGET RULES:

  • Use hourly_rate_max ONLY if the user provides a numeric maximum (for example "under $25/hr"). Do not guess.
  • Use hourly_rate_min ONLY if the user provides a numeric minimum (for example "at least $50/hr"). Do not guess.
  • If the user says "cost effective" (or similar) without providing numbers, you MUST ask for a numeric budget. While waiting, you may run an initial search without hourly_rate_min/max.

INTERACTION RULE:

  • If budget is mentioned without numbers, you MUST ask: "What is your hourly max (or monthly budget and hours/week)?" and proceed with a budget-agnostic search in parallel.

TIMEZONE TO LOCATION MAPPING GUIDANCE (DEFAULTS WHEN USER DID NOT SPECIFY A REGION):

  • This guidance is non-exhaustive. Do not treat any country list as the only valid set.
  • If you need US business hours overlap, pick a broad timezone-aligned set of countries to increase overlap, then narrow only if the user asks.
  • Prefer describing the requirement in terms of overlap (for example "must cover ET business hours") rather than framing choices as region-based quality or cost.
  • Example starting points (not exhaustive):
    • ET coverage: countries in the Americas with strong overlap with ET
    • CT coverage: countries in the Americas with strong overlap with CT
    • MT coverage: countries in the Americas with strong overlap with MT
    • PT coverage: countries in the Americas with strong overlap with PT
    • Any US timezone coverage: a broad Americas-focused set spanning multiple US timezones

IMPORTANT:

  • The mapping above is for timezone overlap only. It must never be framed as a cost decision.

Parameters

Required
querystring

The primary search keywords. Combine the role (e.g., 'Developer') with specific skills (e.g., 'React') or the deliverable (e.g., 'Logo Design').

Optional
additional_contextstring

A comprehensive project brief. INSTRUCTIONS: 1) Include responsibilities, required tools, communication requirements, availability, success criteria, and relevant skills. - If relevant, include the Upwork category or specialty (e.g., "Web Development", "Graphic Design"). - If relevant, include language requirements (e.g., "Must be fluent in English"). 2) Always include timezone coverage requirements here (for example "Must cover US business hours ET"). 3) If you set location due to timezone coverage, you MUST include this exact sentence: "Location filter applied for timezone overlap." 4) Do NOT include any reasoning that ties cost, affordability, or quality to geography. 5) If the user did not provide numeric rates, do not invent them here.

Default: null
hourly_rate_maxnumber

Maximum hourly rate in USD. Use ONLY if the user explicitly provides a numeric maximum.

Default: null
hourly_rate_minnumber

Minimum hourly rate in USD. **Use ONLY if the user explicitly states a minimum price** (e.g., 'I want someone charging at least $50/hr'). Do not use this to infer quality; use 'additional_context' for that.

Default: null
locationarray

Filter by specific country names. HARD RULES: - Set this ONLY if (a) the user explicitly requests a location or region, OR (b) a non-cost constraint requires it (for example timezone coverage, compliance). - DO NOT set this due to cost language. MAPPING INSTRUCTIONS: - Cities/states: map to country in this array, and repeat the city/state in additional_context. - Regions: if the user explicitly asks for a region like "LATAM", include 3 to 5 countries as examples. - Timezone coverage: if the user asks for US hours, you MAY use the timezone mapping guidance in the tool description to populate this field.

Default: null

Links

WebsitePrivacy PolicyTerms of Service