{ "openapi": "3.0.1", "info": { "title": "Remote Jobs Scraper – Remotive, Remote OK, Jobicy, Arbeitnow", "description": "Remote job postings from four public job boards (Remotive, Remote OK, Jobicy, Arbeitnow) in one normalized, newest-first schema, de-duplicated so the same job is never billed twice. Filter by keyword, company, location, salary and posted date; every row links back to the original posting.", "version": "0.1", "x-build-id": "3f0Tt6e6Z3gZKnymF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetchsmith~remote-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetchsmith-remote-jobs-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/fetchsmith~remote-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fetchsmith-remote-jobs-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/fetchsmith~remote-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fetchsmith-remote-jobs-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": { "sources": { "title": "Job boards", "type": "array", "description": "Which public job-board APIs to pull from. Any subset of: \"remotive\" (Remotive, remote tech/design/marketing roles, worldwide), \"remoteok\" (Remote OK, ~100 most recent postings, USD salary ranges on many rows), \"jobicy\" (Jobicy, 50 most recent, salary range + currency + period on many rows), \"arbeitnow\" (Arbeitnow, a general European board — only its rows flagged remote are returned). Leave empty for all four. An unknown name fails the run rather than being silently ignored.", "items": { "type": "string", "enum": [ "remotive", "remoteok", "jobicy", "arbeitnow" ] }, "default": [ "remotive", "remoteok", "jobicy", "arbeitnow" ] }, "searchKeyword": { "title": "Keyword", "type": "string", "description": "Only keep postings whose title, company, category or tags contain this text (case-insensitive), e.g. \"python\" or \"customer support\". It is also passed to Remotive's and Jobicy's own search parameters, so those two boards filter server-side as well. Leave empty for all postings." }, "titleExcludeKeyword": { "title": "Title exclude keyword", "type": "string", "description": "Drop postings whose title contains this text (case-insensitive), e.g. \"Senior\" to exclude senior roles. Leave empty for no exclusion." }, "companyKeyword": { "title": "Company filter", "type": "string", "description": "Only keep postings whose company name contains this text (case-insensitive). Leave empty for all companies." }, "locationKeyword": { "title": "Location / region filter", "type": "string", "description": "Only keep postings whose location field contains this text (case-insensitive), e.g. \"USA\", \"Europe\", \"Germany\". Note that remote boards store a hiring REGION (\"USA, Canada\", \"Worldwide\", \"UK\") rather than a city, and some rows have no location at all — those are dropped when this filter is set. Leave empty for all locations." }, "postedAfter": { "title": "Posted on or after", "type": "string", "description": "Only keep postings published on or after this date, in YYYY-MM-DD (UTC). The whole day is included. A value that is not a real YYYY-MM-DD calendar date FAILS the run with an explanatory error — it is never ignored, because ignoring it would return and charge for jobs outside your window. Rows with no publication date are dropped when this filter is set." }, "postedBefore": { "title": "Posted on or before", "type": "string", "description": "Only keep postings published on or before this date, in YYYY-MM-DD (UTC). The whole day is included (ends 23:59:59.999Z). Same strict parsing as \"Posted on or after\": a typo fails the run instead of silently widening the result set." }, "salaryOnly": { "title": "Only postings with salary info", "type": "boolean", "description": "Keep only postings that carry a salary range or salary text. Remote OK and Jobicy supply numeric ranges on many rows; Remotive supplies a free-text range; Arbeitnow supplies none, so enabling this drops all Arbeitnow rows.", "default": false }, "dedupe": { "title": "De-duplicate across boards", "type": "boolean", "description": "Fold postings that appear on more than one board into a single row (matched on normalized company + job title, newest kept). The row then lists the other boards in \"alsoOn\" and their links in \"duplicateUrls\". De-duplication happens BEFORE charging, so you are never billed twice for one job. Turn off to get one row per board copy.", "default": true }, "includeDescription": { "title": "Include job description HTML", "type": "boolean", "description": "Add the board's full job description HTML as \"descriptionHtml\". Off by default because descriptions are large and most pipelines only need the structured fields plus the link.", "default": false }, "maxPagesPerSource": { "title": "Max pages per source", "minimum": 1, "maximum": 20, "type": "integer", "description": "Only affects Arbeitnow, the one paginated source (250 postings per page). The other three boards return their whole feed in one request.", "default": 2 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many unique postings have been pushed (and charged).", "default": 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 } } } } } } } } } }