{ "openapi": "3.0.1", "info": { "title": "Jobs Index", "description": "Jobs Index provides access to 11+ million organically-collected jobs from hundreds of thousands of direct employer company career websites.\nData you can trust! JobsIndex is offered by Aspen Tech Labs Inc, which has been making jobs data content available for nearly 20 years.", "version": "0.1", "x-build-id": "rAsFDs2xPMyoMqxoY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aspen-technology-labs-inc~jobsindex-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aspen-technology-labs-inc-jobsindex-api", "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/aspen-technology-labs-inc~jobsindex-api/runs": { "post": { "operationId": "runs-sync-aspen-technology-labs-inc-jobsindex-api", "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/aspen-technology-labs-inc~jobsindex-api/run-sync": { "post": { "operationId": "run-sync-aspen-technology-labs-inc-jobsindex-api", "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": { "id": { "title": "Job ID", "type": "string", "description": "Optional job ID filter. Use a specific JobsIndex job ID to retrieve known job records." }, "what": { "title": "Job search query", "type": "string", "description": "Main job search query. Supports keywords, exact phrases, boolean logic (AND, OR, NOT or &, |, !), and field targeting. Examples: python developer OR junior javascript, \"data scientist\", @(title) (manager), @(title,description) (python), @(company_name) ((=\"google, inc.\") OR (microsoft AND corporation)). Maximum 700 raw URL chars or 500 decoded chars." }, "where": { "title": "Location search query", "type": "string", "description": "Free-text location search. Supports place names, boolean logic, and field targeting. Examples: Germany, San Francisco, @country United States, @(city,metro_area) (Denver). Structured fields such as country, region, city, postal_code, and metro_area take priority when also provided. Maximum 700 raw URL chars or 500 decoded chars." }, "country": { "title": "Country", "type": "string", "description": "Country for job location filter." }, "region": { "title": "Region", "type": "string", "description": "Region, state, or province." }, "city": { "title": "City", "type": "string", "description": "City filter." }, "postal_code": { "title": "Postal code", "type": "string", "description": "Postal or ZIP code." }, "metro_area": { "title": "Metro area", "type": "string", "description": "Metropolitan area filter." }, "title": { "title": "Job title", "type": "string", "description": "Job title filter." }, "company_name": { "title": "Company name", "type": "string", "description": "Company name filter." }, "company_domain": { "title": "Company domain", "type": "string", "description": "Company website domain, for example ibm.com." }, "category": { "title": "Category", "type": "string", "description": "Job category, for example Healthcare or Retail." }, "sub_category": { "title": "Sub-category", "type": "string", "description": "More specific job function." }, "industry": { "title": "Industry", "type": "string", "description": "Company industry." }, "posted": { "title": "Posted time frame", "type": "string", "description": "Relative posting age, such as 1h, 1d, 1w, 1m, or an ISO date: YYYY, YYYY-MM, YYYY-MM-DD." }, "salary": { "title": "Salary filter", "type": "string", "description": "Salary amount/range filter. Format: 1-9 digits followed by y, m, w, d, or h; optional range A-B. Examples: 20h-30h, 35h, 20h-200000y." }, "employment_type": { "title": "Employment type", "type": "string", "description": "Employment type, for example Full-Time or Part-Time." }, "remote": { "title": "Remote / work arrangement", "enum": [ "", "remote", "on-site", "hybrid" ], "type": "string", "description": "Work arrangement filter. Supported values: remote, on-site, hybrid." }, "seniority": { "title": "Seniority", "type": "string", "description": "Seniority level, for example Junior, Middle, Senior." }, "page": { "title": "Page number", "minimum": 0, "type": "integer", "description": "Page number. Starts from 0. Pagination is capped by query shape: no company filter up to 1000 items, company filter with another filter up to 20 items, company filter only up to 5 items." }, "size": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of results per page. Maximum 100." } } }, "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 } } } } } } } } } }