{
  "openapi": "3.0.1",
  "info": {
    "title": "Upwork Job Scraper-ethum",
    "description": "The Upwork Job Scraper is a powerful automated tool that extracts targeted freelance opportunities from Upwork based on your specific search criteria. Filter jobs by keywords, hourly rates, client verification status, categories, and experience levels to find the perfect projects for your skills.",
    "version": "0.1",
    "x-build-id": "VWfupyTKZ4ZvigpLY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hidayat-ethum~upwork-job-scraper-ethum/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hidayat-ethum-upwork-job-scraper-ethum",
        "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/hidayat-ethum~upwork-job-scraper-ethum/runs": {
      "post": {
        "operationId": "runs-sync-hidayat-ethum-upwork-job-scraper-ethum",
        "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/hidayat-ethum~upwork-job-scraper-ethum/run-sync": {
      "post": {
        "operationId": "run-sync-hidayat-ethum-upwork-job-scraper-ethum",
        "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": {
          "query": {
            "title": "🔍 Search Query",
            "type": "string",
            "description": "The primary search term for jobs (e.g., 'Workflow Automation')."
          },
          "limit": {
            "title": "♾️ Limit",
            "type": "integer",
            "description": "Maximum number of jobs to fetch.",
            "default": 50
          },
          "sort": {
            "title": "🔃 Sort By",
            "enum": [
              "relevance",
              "newest",
              "client_spend",
              "client_rating"
            ],
            "type": "string",
            "description": "The sorting order for the search results.",
            "default": "relevance"
          },
          "username": {
            "title": "🧍 Username",
            "type": "string",
            "description": "Your Upwork username."
          },
          "password": {
            "title": "🤐 Password",
            "type": "string",
            "description": "Your Upwork password."
          },
          "payment_verified": {
            "title": "💳 Payment Verified",
            "type": "boolean",
            "description": "Filter for clients with a verified payment method.",
            "default": false
          },
          "previous_clients": {
            "title": "👥 Previous Clients",
            "type": "boolean",
            "description": "Filter for jobs from your previous clients.",
            "default": false
          },
          "proposal_min": {
            "title": "⬇️ Minimum Number of Proposals",
            "type": "integer",
            "description": "The minimum number of proposals for a job.",
            "default": 0
          },
          "proposal_max": {
            "title": "⬆️ Maximum Number of Proposals",
            "type": "integer",
            "description": "The maximum number of proposals for a job.",
            "default": 0
          },
          "search_any": {
            "title": "🔎 Any of These Words",
            "type": "string",
            "description": "A space-separated list of keywords. The job must contain at least one of these words."
          },
          "search_exact": {
            "title": "🔍Exact Phrase",
            "type": "string",
            "description": "The exact phrase that must be found in the job posting."
          },
          "search_none": {
            "title": "🔎 None of These Words",
            "type": "string",
            "description": "A space-separated list of words to exclude from the search."
          },
          "search_title": {
            "title": "🔍 Search in Title Only",
            "type": "string",
            "description": "Keywords that must appear in the job title."
          },
          "category": {
            "title": "📂 Category",
            "type": "array",
            "description": "Select one or more categories.",
            "items": {
              "type": "string",
              "enum": [
                "accounting & consulting",
                "personal & professional coaching",
                "accounting & bookkeeping",
                "financial planning",
                "recruiting & human resources",
                "management consulting & analysis",
                "other - accounting & consulting",
                "admin support",
                "data entry & transcription services",
                "virtual assistance",
                "project management",
                "market research & product reviews",
                "customer service",
                "community management & tagging",
                "customer service & tech support",
                "data science & analytics",
                "data analysis & testing",
                "data extraction & etl",
                "data mining & management",
                "ai & machine learning",
                "design & creative",
                "art & illustration",
                "audio & music production",
                "branding & logo design",
                "nft, ar/vr & game art",
                "graphic, editorial & presentation design",
                "performing arts",
                "photography",
                "product design",
                "video & animation",
                "engineering & architecture",
                "building & landscape architecture",
                "chemical engineering",
                "civil & structural engineering",
                "contract manufacturing",
                "electrical & electronic engineering",
                "interior & trade show design",
                "energy & mechanical engineering",
                "physical sciences",
                "3d modeling & cad",
                "it & networking",
                "database management & administration",
                "erp & crm software",
                "information security & compliance",
                "network & system administration",
                "devops & solution architecture",
                "legal",
                "corporate & contract law",
                "international & immigration law",
                "finance & tax law",
                "public law",
                "sales & marketing",
                "digital marketing",
                "lead generation & telemarketing",
                "marketing, pr & brand strategy",
                "translation",
                "language tutoring & interpretation",
                "translation & localization services",
                "web, mobile & software dev",
                "blockchain, nft & cryptocurrency",
                "ai apps and integration",
                "desktop application development",
                "ecommerce development",
                "game design & development",
                "mobile development",
                "other - software development",
                "product management",
                "qa & testing",
                "scripts & utilities",
                "web & mobile design",
                "web development",
                "writing",
                "sales & marketing copywriting",
                "content writing",
                "editing & proofreading services",
                "professional & business writing"
              ],
              "enumTitles": [
                "📂 Accounting & Consulting",
                "🔵 Personal & Professional Coaching",
                "🔵 Accounting & Bookkeeping",
                "🔵 Financial Planning",
                "🔵 Recruiting & Human Resources",
                "🔵 Management Consulting & Analysis",
                "🔵 Other - Accounting & Consulting",
                "📂 Admin Support",
                "🔵 Data Entry & Transcription Services",
                "🔵 Virtual Assistance",
                "🔵 Project Management",
                "🔵 Market Research & Product Reviews",
                "📂 Customer Service",
                "🔵 Community Management & Tagging",
                "🔵 Customer Service & Tech Support",
                "📂 Data Science & Analytics",
                "🔵 Data Analysis & Testing",
                "🔵 Data Extraction & ETL",
                "🔵 Data Mining & Management",
                "🔵 AI & Machine Learning",
                "📂 Design & Creative",
                "🔵 Art & Illustration",
                "🔵 Audio & Music Production",
                "🔵 Branding & Logo Design",
                "🔵 NFT, AR/VR & Game Art",
                "🔵 Graphic, Editorial & Presentation Design",
                "🔵 Performing Arts",
                "🔵 Photography",
                "🔵 Product Design",
                "🔵 Video & Animation",
                "📂 Engineering & Architecture",
                "🔵 Building & Landscape Architecture",
                "🔵 Chemical Engineering",
                "🔵 Civil & Structural Engineering",
                "🔵 Contract Manufacturing",
                "🔵 Electrical & Electronic Engineering",
                "🔵 Interior & Trade Show Design",
                "🔵 Energy & Mechanical Engineering",
                "🔵 Physical Sciences",
                "🔵 3D Modeling & CAD",
                "📂 IT & Networking",
                "🔵 Database Management & Administration",
                "🔵 ERP & CRM Software",
                "🔵 Information Security & Compliance",
                "🔵 Network & System Administration",
                "🔵 Devops & Solution Architecture",
                "📂 Legal",
                "🔵 Corporate & Contract Law",
                "🔵 International & Immigration Law",
                "🔵 Finance & Tax Law",
                "🔵 Public Law",
                "📂 Sales & Marketing",
                "🔵 Digital Marketing",
                "🔵 Lead Generation & Telemarketing",
                "🔵 Marketing, PR & Brand Strategy",
                "📂 Translation",
                "🔵 Language Tutoring & Interpretation",
                "🔵 Translation & Localization Services",
                "📂 Web, Mobile & Software Dev",
                "🔵 Blockchain, NFT & Cryptocurrency",
                "🔵 AI Apps and Integration",
                "🔵 Desktop Application Development",
                "🔵 Ecommerce Development",
                "🔵 Game Design & Development",
                "🔵 Mobile Development",
                "🔵 Other - Software Development",
                "🔵 Product Management",
                "🔵 QA & Testing",
                "🔵 Scripts & Utilities",
                "🔵 Web & Mobile Design",
                "🔵 Web Development",
                "📂 Writing",
                "🔵 Sales & Marketing Copywriting",
                "🔵 Content Writing",
                "🔵 Editing & Proofreading Services",
                "🔵 Professional & Business Writing"
              ]
            },
            "default": []
          },
          "expertise_level_number": {
            "title": "🎚️ Expertise Level",
            "type": "array",
            "description": "Select one or more desired expertise levels.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3"
              ],
              "enumTitles": [
                "🟢 Entry Level",
                "🟡 Intermediate",
                "🔴 Expert"
              ]
            },
            "default": []
          },
          "fixed": {
            "title": "💸 Fixed-Price Jobs",
            "type": "boolean",
            "description": "Include fixed-price jobs in the search.",
            "default": false
          },
          "fixed_min": {
            "title": "⬇️ Minimum Fixed Price",
            "type": "integer",
            "description": "The minimum budget for fixed-price jobs.",
            "default": 0
          },
          "fixed_max": {
            "title": "⬆️ Maximum Fixed Price",
            "type": "integer",
            "description": "The maximum budget for fixed-price jobs.",
            "default": 0
          },
          "fixed_price_catagory_num": {
            "title": "💲 Fixed-Price Categories",
            "type": "array",
            "description": "Numeric codes for fixed-price job categories.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5"
              ],
              "enumTitles": [
                "0-99",
                "100-499",
                "500-999",
                "1000-4999",
                "5000-"
              ]
            },
            "default": []
          },
          "hourly": {
            "title": "🪙 Hourly Jobs",
            "type": "boolean",
            "description": "Include hourly jobs in the search.",
            "default": false
          },
          "hourly_min": {
            "title": "⬇️ Minimum Hourly Rate",
            "type": "integer",
            "description": "The minimum hourly rate.",
            "default": 0
          },
          "hourly_max": {
            "title": "⬆️ Maximum Hourly Rate",
            "type": "integer",
            "description": "The maximum hourly rate.",
            "default": 0
          },
          "hires_min": {
            "title": "⬇️ Minimum Hires",
            "type": "integer",
            "description": "The minimum number of previous hires for a client.",
            "default": 0
          },
          "hires_max": {
            "title": "⬆️ Maximum Hires",
            "type": "integer",
            "description": "The maximum number of previous hires for a client.",
            "default": 0
          },
          "contract_to_hire": {
            "title": "🤝 Contract-to-Hire",
            "type": "boolean",
            "description": "Filter for contract-to-hire opportunities.",
            "default": false
          },
          "workload": {
            "title": "💼 Workload",
            "type": "array",
            "description": "Select the desired workload.",
            "items": {
              "type": "string",
              "enum": [
                "part_time",
                "full_time"
              ],
              "enumTitles": [
                "Less than 30 hrs/week",
                "More than 30 hrs/week"
              ]
            },
            "default": []
          },
          "projectDuration": {
            "title": "🕝 Job Duration",
            "type": "array",
            "description": "Select the desired job duration.",
            "items": {
              "type": "string",
              "enum": [
                "week",
                "month",
                "semester",
                "ongoing"
              ],
              "enumTitles": [
                "Less than one month",
                "1 to 3 months",
                "3 to 6 months",
                "More than 6 months"
              ]
            },
            "default": []
          },
          "log_level": {
            "title": "🎚️ Log Level",
            "enum": [
              "INFO",
              "DEBUG",
              "WARNING",
              "ERROR"
            ],
            "type": "string",
            "description": "Select the desired log level.",
            "default": "INFO"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}