{
  "openapi": "3.0.1",
  "info": {
    "title": "Jora Jobs Scraper",
    "description": "Scrape job listings from Jora.com across Australia, New Zealand, and Singapore. Extract titles, companies, salaries, locations, job types, full descriptions, employer ratings, and posting dates. Pay only per result with proxies included. Supports deduplication.",
    "version": "1.0",
    "x-build-id": "kxAYC1kK1JhrOsYlp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~jora-scraper-ppe/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-jora-scraper-ppe",
        "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/silentflow~jora-scraper-ppe/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-jora-scraper-ppe",
        "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/silentflow~jora-scraper-ppe/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-jora-scraper-ppe",
        "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": {
          "startUrls": {
            "title": "🔗 Jora links",
            "type": "array",
            "description": "Jora search pages, read page after page (e.g. <code>https://au.jora.com/Software-Developer-jobs</code>, or a link copied from Jora with its filters), or single job pages to refresh a known list of postings (e.g. <code>https://au.jora.com/job/Data-Analyst-…</code>).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searches": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "One search per keyword, e.g. <code>registered nurse</code>, <code>data analyst</code>, <code>electrician</code>.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "City, suburb or state, e.g. <code>Sydney NSW</code>, <code>Melbourne VIC</code>, <code>Brisbane</code>. Leave empty to search all of Australia.",
            "default": ""
          },
          "maxItems": {
            "title": "🔢 Max jobs",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "How many jobs to collect in total. Jora shows about 500 jobs per search; when you ask for more, the actor splits a broad search into narrower ones (by work type, date posted, newest first) and keeps going, without duplicates.",
            "default": 50
          },
          "postedWithin": {
            "title": "🗓️ Date posted",
            "enum": [
              "anytime",
              "24h",
              "3d",
              "7d",
              "14d",
              "30d"
            ],
            "type": "string",
            "description": "Only jobs listed within this window. <code>Last 24 hours</code> is the setting for a daily feed of new jobs.",
            "default": "anytime"
          },
          "sort": {
            "title": "↕️ Sort by",
            "enum": [
              "relevance",
              "date"
            ],
            "type": "string",
            "description": "<code>Newest first</code> puts the freshest jobs at the top, so a capped run collects the latest postings.",
            "default": "relevance"
          },
          "workType": {
            "title": "💼 Work type",
            "type": "string",
            "description": "Only jobs of this work type.",
            "default": "any"
          },
          "salaryMin": {
            "title": "💰 Minimum salary (AUD a year)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Keeps only jobs that list a salary reaching this yearly amount, e.g. <code>90000</code>. Hourly, daily, weekly and monthly pay is converted to a year. Jobs that do not show a salary are left out."
          },
          "distanceKm": {
            "title": "📏 Radius (km)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Distance around the location: <code>0</code> (that place only), <code>5</code>, <code>10</code>, <code>25</code>, <code>50</code> or <code>100</code> km. Needs a location. Leave empty for Jora's usual area."
          },
          "scrapeDetails": {
            "title": "📝 Full job details",
            "type": "boolean",
            "description": "Opens each job page to add the full description, the advertiser (the agency or job board that posted the job, next to the employer), the company's review count and reviews link, and the apply link. Slower: one more page per job.",
            "default": false
          },
          "country": {
            "title": "🌏 Country",
            "enum": [
              "au",
              "nz",
              "sg"
            ],
            "type": "string",
            "description": "Jora lists jobs in Australia. Its New Zealand and Singapore sites have closed and return no jobs.",
            "default": "au"
          },
          "maxPages": {
            "title": "📄 Max pages per search",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Stop each search after this many result pages (Jora shows about 15 jobs per page). Leave empty to let Max jobs decide."
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Show detailed logs.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}