# RemoteOK Jobs Scraper API – Remote Job Listings & Company Data (`skyline_scrapers/remoteok-scraper-new`) Actor Extract real-time remote job listings, company details, salary information, and job metadata from RemoteOK. Built for recruiters, job boards, lead generation, market research, automation workflows, and remote hiring platforms. - **URL**: https://apify.com/skyline\_scrapers/remoteok-scraper-new.md - **Developed by:** [Skyline Scrapers](https://apify.com/skyline_scrapers) (community) - **Categories:** Automation, Jobs, Lead generation - **Stats:** 5 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.00005 / actor start This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## RemoteOK Jobs Scraper API Extract remote job listings, salaries, companies, tags, skills, apply URLs, and hiring data from RemoteOK.com. This RemoteOK scraper is built for recruiters, staffing agencies, job boards, HR tech products, lead generation teams, hiring intelligence platforms, AI job tools, and market researchers. Export RemoteOK job data to JSON, CSV, Excel, XML, APIs, Google Sheets, Airtable, HubSpot, Notion, databases, and automation workflows. --- ### What is RemoteOK Jobs Scraper API? RemoteOK Jobs Scraper API extracts structured remote job data from RemoteOK using the RemoteOK public jobs feed and normalizes it into recruiter-ready datasets. It supports keyword search, RemoteOK search URL parsing, tag filtering, location and region filters, salary extraction, seniority detection, skills extraction, hiring signals, and clean export-ready output. --- ### Features - Extract RemoteOK job listings - Scrape remote companies and job URLs - Extract salary ranges and compensation data - Extract company names and company logos - Extract RemoteOK tags and detected skills - Extract apply URLs when available - Filter by keyword, tag, location, region, or country - Filter by posted date and minimum salary - Detect seniority level - Detect job category - Calculate relevance score - Calculate job quality score - Export to JSON, CSV, Excel, XML, and API --- ### What data can you extract? | Field | Included | |---|---| | Job title | Yes | | Company name | Yes | | Location / region | Yes | | Remote status | Yes | | Posted date | Yes | | Posted days ago | Yes | | Hiring signal | Yes | | Job type | Yes | | Seniority | Yes | | Category | Yes | | Salary min | Yes | | Salary max | Yes | | Salary range | Yes | | Salary type | Yes | | Skills | Yes | | Tags | Yes | | Relevance score | Yes | | Job quality score | Yes | | Description | Yes | | Job URL | Yes | | Apply URL | Yes | | Company logo | Yes | --- ### Input options #### Option 1: RemoteOK search URL ```json { "searchUrl": "https://remoteok.com/remote-python-jobs", "maxResults": 100 } ```` #### Option 2: Keyword + filters ```json { "keyword": "python developer", "location": "Worldwide", "tags": "python, backend", "maxResults": 100, "postedWithinDays": 30 } ``` #### Full input example ```json { "searchUrl": "", "keyword": "product manager", "location": "Worldwide", "region": "Europe", "country": "", "tags": "product, saas", "tagMode": "any", "maxResults": 100, "postedWithinDays": 30, "minSalary": 80000, "includeDescription": true, "includeHtmlDescription": false, "sortBy": "latest", "minRelevanceScore": 0, "excludeKeywords": "internship, unpaid", "maxRetries": 3 } ``` *** ### Output example ```json { "title": "Senior Backend Engineer", "company": "Example Company", "location": "Worldwide", "region": null, "country": null, "remote": true, "posted": "2026-05-07", "postedDaysAgo": 0, "hiringSignal": "HOT", "jobType": "Full-time", "seniority": "Senior", "category": "Engineering", "salaryMin": 120000, "salaryMax": 180000, "salaryRange": "120000-180000", "salaryType": "yearly", "skills": "Python, AWS, PostgreSQL, Docker", "tags": "python, backend, aws", "relevanceScore": 100, "jobQualityScore": 90, "description": "Remote backend engineering role focused on APIs and scalable systems.", "url": "https://remoteok.com/remote-jobs/example", "applyUrl": "https://remoteok.com/remote-jobs/example/apply", "source": "RemoteOK", "sourceId": "123456", "companyLogo": "https://remoteok.com/cdn-cgi/image/..." } ``` *** ### Use cases #### Recruitment agencies Build remote hiring datasets and identify companies actively hiring remote workers. #### Staffing firms Track remote job demand by skill, category, seniority, and region. #### Job boards and aggregators Create structured remote job feeds using RemoteOK job listings. #### Lead generation Generate B2B leads from companies hiring remote talent. #### HR analytics Analyze remote salary trends, hiring velocity, skills demand, and remote work markets. #### AI datasets Create structured remote job datasets for AI recruiting tools and job matching systems. *** ### Export formats Apify supports export to: - JSON - CSV - Excel - XML - API *** ### Integrations Use the RemoteOK Jobs Scraper API with: - Apify API - Zapier - Make - n8n - Airtable - Google Sheets - HubSpot - Salesforce - Notion - Clay - Databases *** ### SEO keywords RemoteOK Scraper, RemoteOK Jobs Scraper, RemoteOK API, RemoteOK Jobs API, RemoteOK.com Scraper, Remote Jobs Scraper, Remote Job API, Remote Hiring Data API, Remote Job Listings API, Remote Work Jobs Scraper, Remote Job Board Scraper, RemoteOK Salary Data, RemoteOK Company Data, RemoteOK Apply URL Scraper. *** ### Legal disclaimer This actor is an independent data extraction tool and is not affiliated with RemoteOK.com. # Actor input Schema ## `searchUrl` (type: `string`): Optional RemoteOK search URL. If provided, the actor extracts keyword/location/tag filters from this URL. Example: https://remoteok.com/remote-python-jobs or https://remoteok.com/remote-api%2Bbackend-jobs ## `keyword` (type: `string`): Search RemoteOK jobs by keyword, such as python developer, customer support, product manager, AI engineer, marketing, sales, or data analyst. Used when Search URL is empty. ## `location` (type: `string`): Optional RemoteOK location or region filter, such as Worldwide, Europe, USA, North America, Latin America, Asia, United Kingdom, Canada, or India. ## `region` (type: `string`): Optional region filter for RemoteOK job extraction. Example: Europe, North America, Latin America, Asia, Africa, Middle East, Oceania. ## `country` (type: `string`): Optional country filter for RemoteOK jobs. Example: United States, Canada, United Kingdom, Germany, India, Australia. ## `tags` (type: `string`): Comma-separated RemoteOK tags or skills to filter by. Example: python, react, nodejs, support, sales, design, product, devops, ai. ## `tagMode` (type: `string`): Choose whether jobs must match any tag or all tags. ## `maxResults` (type: `integer`): Maximum number of RemoteOK job listings to save to the dataset. ## `postedWithinDays` (type: `integer`): Return only RemoteOK jobs posted within this many days. Use 0 to disable this filter. ## `minSalary` (type: `integer`): Return only jobs with salaryMax at or above this value. Use 0 to disable salary filtering. ## `includeDescription` (type: `boolean`): Include cleaned RemoteOK job description text in the output dataset. ## `includeHtmlDescription` (type: `boolean`): Include the original HTML job description from RemoteOK if available. Useful for advanced processing, but makes output larger. ## `sortBy` (type: `string`): Sort RemoteOK results by latest jobs, highest salary, relevance score, or job quality score. ## `minRelevanceScore` (type: `integer`): Minimum keyword relevance score required for a job to be saved. Use 0 to disable. ## `excludeKeywords` (type: `string`): Comma-separated keywords to exclude from output. Example: internship, unpaid, crypto, sales. ## `maxRetries` (type: `integer`): Maximum retry attempts if RemoteOK API request fails. ## Actor input object example ```json { "searchUrl": "", "keyword": "", "location": "", "region": "", "country": "", "tags": "", "tagMode": "any", "maxResults": 100, "postedWithinDays": 0, "minSalary": 0, "includeDescription": true, "includeHtmlDescription": false, "sortBy": "latest", "minRelevanceScore": 0, "excludeKeywords": "", "maxRetries": 3 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("skyline_scrapers/remoteok-scraper-new").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("skyline_scrapers/remoteok-scraper-new").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call skyline_scrapers/remoteok-scraper-new --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=skyline_scrapers/remoteok-scraper-new", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "RemoteOK Jobs Scraper API – Remote Job Listings & Company Data", "description": "Extract real-time remote job listings, company details, salary information, and job metadata from RemoteOK.\nBuilt for recruiters, job boards, lead generation, market research, automation workflows, and remote hiring platforms.", "version": "0.0", "x-build-id": "ZnMwBt3G6V01YpSpN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/skyline_scrapers~remoteok-scraper-new/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-skyline_scrapers-remoteok-scraper-new", "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/skyline_scrapers~remoteok-scraper-new/runs": { "post": { "operationId": "runs-sync-skyline_scrapers-remoteok-scraper-new", "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/skyline_scrapers~remoteok-scraper-new/run-sync": { "post": { "operationId": "run-sync-skyline_scrapers-remoteok-scraper-new", "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": { "searchUrl": { "title": "RemoteOK Search URL", "type": "string", "description": "Optional RemoteOK search URL. If provided, the actor extracts keyword/location/tag filters from this URL. Example: https://remoteok.com/remote-python-jobs or https://remoteok.com/remote-api%2Bbackend-jobs", "default": "" }, "keyword": { "title": "Job Keyword", "type": "string", "description": "Search RemoteOK jobs by keyword, such as python developer, customer support, product manager, AI engineer, marketing, sales, or data analyst. Used when Search URL is empty.", "default": "" }, "location": { "title": "Location / Region", "type": "string", "description": "Optional RemoteOK location or region filter, such as Worldwide, Europe, USA, North America, Latin America, Asia, United Kingdom, Canada, or India.", "default": "" }, "region": { "title": "Region", "type": "string", "description": "Optional region filter for RemoteOK job extraction. Example: Europe, North America, Latin America, Asia, Africa, Middle East, Oceania.", "default": "" }, "country": { "title": "Country", "type": "string", "description": "Optional country filter for RemoteOK jobs. Example: United States, Canada, United Kingdom, Germany, India, Australia.", "default": "" }, "tags": { "title": "Tags / Skills", "type": "string", "description": "Comma-separated RemoteOK tags or skills to filter by. Example: python, react, nodejs, support, sales, design, product, devops, ai.", "default": "" }, "tagMode": { "title": "Tag Match Mode", "enum": [ "any", "all" ], "type": "string", "description": "Choose whether jobs must match any tag or all tags.", "default": "any" }, "maxResults": { "title": "Maximum Jobs to Extract", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of RemoteOK job listings to save to the dataset.", "default": 100 }, "postedWithinDays": { "title": "Posted Within Days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Return only RemoteOK jobs posted within this many days. Use 0 to disable this filter.", "default": 0 }, "minSalary": { "title": "Minimum Salary", "minimum": 0, "type": "integer", "description": "Return only jobs with salaryMax at or above this value. Use 0 to disable salary filtering.", "default": 0 }, "includeDescription": { "title": "Include Job Description", "type": "boolean", "description": "Include cleaned RemoteOK job description text in the output dataset.", "default": true }, "includeHtmlDescription": { "title": "Include HTML Description", "type": "boolean", "description": "Include the original HTML job description from RemoteOK if available. Useful for advanced processing, but makes output larger.", "default": false }, "sortBy": { "title": "Sort Jobs By", "enum": [ "latest", "highestSalary", "relevance", "quality" ], "type": "string", "description": "Sort RemoteOK results by latest jobs, highest salary, relevance score, or job quality score.", "default": "latest" }, "minRelevanceScore": { "title": "Minimum Relevance Score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum keyword relevance score required for a job to be saved. Use 0 to disable.", "default": 0 }, "excludeKeywords": { "title": "Exclude Keywords", "type": "string", "description": "Comma-separated keywords to exclude from output. Example: internship, unpaid, crypto, sales.", "default": "" }, "maxRetries": { "title": "Maximum Retry Attempts", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum retry attempts if RemoteOK API request fails.", "default": 3 } } }, "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 } } } } } } } } } } ```