{
  "openapi": "3.0.1",
  "info": {
    "title": "Upwork Jobs History — 3M+ Postings Since 2024, by Period, Skill",
    "description": "Every Upwork job posting since November 2024: the last 3, 6 or 12 months or all of it, narrowed by category and skill. Full description, budget, skills, and the client's spend, hires and rating as they stood the day the job was posted. $0.20 per 1,000 rows, less on paid plans; free estimate.",
    "version": "0.1",
    "x-build-id": "C6a2JCTHCAzbKgHcZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hyperbach~upwork-jobs-history/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hyperbach-upwork-jobs-history",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/hyperbach~upwork-jobs-history/runs": {
      "post": {
        "operationId": "runs-sync-hyperbach-upwork-jobs-history",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/hyperbach~upwork-jobs-history/run-sync": {
      "post": {
        "operationId": "run-sync-hyperbach-upwork-jobs-history",
        "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": {
          "period": {
            "title": "Period",
            "enum": [
              "3m",
              "6m",
              "12m",
              "all"
            ],
            "type": "string",
            "description": "How far back from today. The newest 30 days are not on sale, so the last 3 months deliver about two months of postings; the status message names the exact days. from/to below replace this.",
            "default": "12m"
          },
          "from": {
            "title": "From (exact date)",
            "pattern": "^\\s*\\d{4}-(0?[1-9]|1[0-2])(-\\d{1,2})?\\s*$",
            "type": "string",
            "description": "First day, YYYY-MM-DD (YYYY-MM means that month's first day). Replaces period. Collection began on 2024-11-01."
          },
          "to": {
            "title": "To (exact date)",
            "pattern": "^\\s*\\d{4}-(0?[1-9]|1[0-2])(-\\d{1,2})?\\s*$",
            "type": "string",
            "description": "Last day, included, YYYY-MM-DD (YYYY-MM means that month's last day). Empty: the newest day on sale, 30 days behind today."
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Upwork's top-level categories. Empty: all of them, with the uncategorized postings too.",
            "items": {
              "type": "string",
              "enum": [
                "web-mobile-software-dev",
                "design-creative",
                "sales-marketing",
                "admin-support",
                "accounting-consulting",
                "engineering-architecture",
                "writing",
                "data-science-analytics",
                "it-networking",
                "customer-service",
                "translation",
                "legal",
                "uncategorized"
              ],
              "enumTitles": [
                "Web, Mobile & Software Dev",
                "Design & Creative",
                "Sales & Marketing",
                "Admin Support",
                "Accounting & Consulting",
                "Engineering & Architecture",
                "Writing",
                "Data Science & Analytics",
                "IT & Networking",
                "Customer Service",
                "Translation",
                "Legal",
                "Uncategorized (no category on Upwork, about 1% of postings)"
              ]
            }
          },
          "subcategories": {
            "title": "Subcategories",
            "type": "array",
            "description": "Upwork's subcategories, e.g. Ecommerce Development or AI & Machine Learning. A posting must be in one of them. Combined with categories, only subcategories inside those categories count. Empty: no subcategory filter.",
            "items": {
              "type": "string",
              "enum": [
                "Web Development",
                "Web & Mobile Design",
                "Ecommerce Development",
                "Mobile Development",
                "Scripts & Utilities",
                "QA Testing",
                "AI Apps & Integration",
                "Other - Software Development",
                "Game Design & Development",
                "Desktop Application Development",
                "Product Management & Scrum",
                "Blockchain, NFT & Cryptocurrency",
                "Video & Animation",
                "Graphic, Editorial & Presentation Design",
                "Branding & Logo Design",
                "Art & Illustration",
                "Performing Arts",
                "Product Design",
                "Audio & Music Production",
                "Photography",
                "NFT, AR/VR & Game Art",
                "Digital Marketing",
                "Lead Generation & Telemarketing",
                "Marketing, PR & Brand Strategy",
                "Virtual Assistance",
                "Data Entry & Transcription Services",
                "Market Research & Product Reviews",
                "Project Management",
                "Accounting & Bookkeeping",
                "Recruiting & Human Resources",
                "Financial Planning",
                "Management Consulting & Analysis",
                "Other - Accounting & Consulting",
                "Personal & Professional Coaching",
                "3D Modeling & CAD",
                "Building & Landscape Architecture",
                "Civil & Structural Engineering",
                "Contract Manufacturing",
                "Electrical & Electronic Engineering",
                "Interior & Trade Show Design",
                "Energy & Mechanical Engineering",
                "Physical Sciences",
                "Chemical Engineering",
                "Content Writing",
                "Editing & Proofreading Services",
                "Professional & Business Writing",
                "Sales & Marketing Copywriting",
                "Data Analysis & Testing",
                "AI & Machine Learning",
                "Data Extraction/ETL",
                "Data Mining & Management",
                "Network & System Administration",
                "DevOps & Solution Architecture",
                "Information Security & Compliance",
                "ERP/CRM Software",
                "Database Management & Administration",
                "Customer Service & Tech Support",
                "Community Management & Tagging",
                "Translation & Localization Services",
                "Language Tutoring & Interpretation",
                "Legal, Medical & Technical Translation",
                "Corporate & Contract Law",
                "Public Law",
                "International & Immigration Law",
                "Finance & Tax Law"
              ],
              "enumTitles": [
                "Web, Mobile & Software Dev › Web Development",
                "Web, Mobile & Software Dev › Web & Mobile Design",
                "Web, Mobile & Software Dev › Ecommerce Development",
                "Web, Mobile & Software Dev › Mobile Development",
                "Web, Mobile & Software Dev › Scripts & Utilities",
                "Web, Mobile & Software Dev › QA Testing",
                "Web, Mobile & Software Dev › AI Apps & Integration",
                "Web, Mobile & Software Dev › Other - Software Development",
                "Web, Mobile & Software Dev › Game Design & Development",
                "Web, Mobile & Software Dev › Desktop Application Development",
                "Web, Mobile & Software Dev › Product Management & Scrum",
                "Web, Mobile & Software Dev › Blockchain, NFT & Cryptocurrency",
                "Design & Creative › Video & Animation",
                "Design & Creative › Graphic, Editorial & Presentation Design",
                "Design & Creative › Branding & Logo Design",
                "Design & Creative › Art & Illustration",
                "Design & Creative › Performing Arts",
                "Design & Creative › Product Design",
                "Design & Creative › Audio & Music Production",
                "Design & Creative › Photography",
                "Design & Creative › NFT, AR/VR & Game Art",
                "Sales & Marketing › Digital Marketing",
                "Sales & Marketing › Lead Generation & Telemarketing",
                "Sales & Marketing › Marketing, PR & Brand Strategy",
                "Admin Support › Virtual Assistance",
                "Admin Support › Data Entry & Transcription Services",
                "Admin Support › Market Research & Product Reviews",
                "Admin Support › Project Management",
                "Accounting & Consulting › Accounting & Bookkeeping",
                "Accounting & Consulting › Recruiting & Human Resources",
                "Accounting & Consulting › Financial Planning",
                "Accounting & Consulting › Management Consulting & Analysis",
                "Accounting & Consulting › Other - Accounting & Consulting",
                "Accounting & Consulting › Personal & Professional Coaching",
                "Engineering & Architecture › 3D Modeling & CAD",
                "Engineering & Architecture › Building & Landscape Architecture",
                "Engineering & Architecture › Civil & Structural Engineering",
                "Engineering & Architecture › Contract Manufacturing",
                "Engineering & Architecture › Electrical & Electronic Engineering",
                "Engineering & Architecture › Interior & Trade Show Design",
                "Engineering & Architecture › Energy & Mechanical Engineering",
                "Engineering & Architecture › Physical Sciences",
                "Engineering & Architecture › Chemical Engineering",
                "Writing › Content Writing",
                "Writing › Editing & Proofreading Services",
                "Writing › Professional & Business Writing",
                "Writing › Sales & Marketing Copywriting",
                "Data Science & Analytics › Data Analysis & Testing",
                "Data Science & Analytics › AI & Machine Learning",
                "Data Science & Analytics › Data Extraction/ETL",
                "Data Science & Analytics › Data Mining & Management",
                "IT & Networking › Network & System Administration",
                "IT & Networking › DevOps & Solution Architecture",
                "IT & Networking › Information Security & Compliance",
                "IT & Networking › ERP/CRM Software",
                "IT & Networking › Database Management & Administration",
                "Customer Service › Customer Service & Tech Support",
                "Customer Service › Community Management & Tagging",
                "Translation › Translation & Localization Services",
                "Translation › Language Tutoring & Interpretation",
                "Translation › Legal, Medical & Technical Translation",
                "Legal › Corporate & Contract Law",
                "Legal › Public Law",
                "Legal › International & Immigration Law",
                "Legal › Finance & Tax Law"
              ]
            }
          },
          "skills": {
            "title": "Skills (any of)",
            "maxItems": 50,
            "type": "array",
            "description": "A posting matches when any of its skills contains one of these as whole words, ignoring case: shopify matches Shopify and Shopify Theme; machine learning matches Machine Learning Model. Empty: no skill filter. Rows that do not match are not delivered and not charged.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 3000000,
            "type": "integer",
            "description": "Stop after this many rows. Empty: every posting in the selection. The run's maximum charge is honoured as well: a run never delivers more rows than it pays for."
          },
          "estimate": {
            "title": "Estimate only (free)",
            "type": "boolean",
            "description": "Count the postings in the selection and price them for your plan, by month and by category, without delivering any. Free: no run charge, no rows. The answer is in the status message, the log, and the Estimate on the Output tab.",
            "default": false
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}