{ "openapi": "3.0.1", "info": { "title": "Jobicy Remote Job Listings Scraper", "description": "Search remote job listings from Jobicy by keyword, region, and seniority level. Returns job title, company, salary range, job type, category, and a direct application link for each role.", "version": "1.1", "x-build-id": "jVhcKYfKlFmoj7cg0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~jobicy-remote-job-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-jobicy-remote-job-listings-scraper", "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/vexaloom-labs~jobicy-remote-job-listings-scraper/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-jobicy-remote-job-listings-scraper", "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/vexaloom-labs~jobicy-remote-job-listings-scraper/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-jobicy-remote-job-listings-scraper", "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": { "mode": { "title": "Mode", "type": "string", "description": "Search the live Jobicy feed, fetch specific job URLs/IDs, or check stored job IDs. Leave blank for search.", "default": "search" }, "keyword": { "title": "Search Keyword", "type": "string", "description": "Full-text search across Jobicy job content (3-50 characters). Leave blank to browse. Examples: python, marketing, product designer.", "default": "" }, "geo": { "title": "Location", "type": "string", "description": "Keep jobs open to this location or region. Jobicy treats worldwide roles as eligible for every location. Legacy display names such as United States or worldwide are mapped in code. Jobicy lists Malaysia in its taxonomy but its jobs API rejects that slug, so Malaysia is not offered.", "default": "" }, "industry": { "title": "Industry", "enum": [ "", "admin-support", "business", "copywriting", "design-multimedia", "supporting", "cybersecurity", "data-science", "admin", "education", "accounting-finance", "healthcare", "hr", "legal", "marketing", "management", "project-management", "qa-testing", "seller", "seo", "engineering", "technical-support", "web-app-design" ], "type": "string", "description": "Keep jobs in one Jobicy category. Leave blank for all categories.", "default": "" }, "jobType": { "title": "Job Type", "enum": [ "", "Full-Time", "Part-Time", "Contract", "Internship" ], "type": "string", "description": "Keep one employment type. Leave blank for all types.", "default": "" }, "jobLevel": { "title": "Seniority Level", "type": "string", "description": "Keep one seniority level. Leave blank for all levels. Legacy Any is accepted and keeps listings Jobicy labels Any.", "default": "" }, "postedWithinDays": { "title": "Posted Within (Days)", "minimum": 0, "maximum": 7, "type": "integer", "description": "Keep jobs published in the last N days. 0 means no date limit. Jobicy exposes the last 7 days.", "default": 0 }, "salaryDisclosedOnly": { "title": "Only Jobs With Published Salary", "type": "boolean", "description": "Keep only listings where Jobicy publishes a salary range.", "default": false }, "minAnnualSalaryUsd": { "title": "Minimum Annual Salary (USD)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Keep USD listings whose annualised maximum salary meets this figure. Hourly pay is annualised at 2,080 hours; monthly pay at 12 months. 0 disables this filter.", "default": 0 }, "excludeKeywords": { "title": "Exclude Keywords", "type": "array", "description": "Drop jobs whose title or company contains any of these terms (case-insensitive).", "items": { "type": "string" }, "default": [] }, "onlyActive": { "title": "Only Active Listings", "type": "boolean", "description": "Check each listing's current status with Jobicy and keep only active jobs.", "default": false }, "includeDetails": { "title": "Include Detail-Page Fields", "type": "boolean", "description": "Fetch each job page for its exact expiry date, company website and applicant countries. Adds requests; unavailable pages are skipped.", "default": false }, "jobUrls": { "title": "Job URLs or IDs", "type": "array", "description": "Jobicy job URLs or numeric job IDs. Used only with mode byUrls or status.", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum job listings to return (1-5,000). Jobicy's live window usually contains about 1,000-1,500 jobs.", "default": 50 } } }, "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 } } } } } } } } } }