RemoteOK Scraper - Remote Job Listings

Extract remote job listings from RemoteOK.com using their official public API. No proxy needed — fast and reliable.

Description

This Actor fetches remote job listings from RemoteOK's publicly available JSON API (https://remoteok.com/api). It supports filtering by keyword, job tag, location, and maximum result count.

• No browser automation — pure API access
• No proxy required — RemoteOK's API is open and public
• HTML-cleaned descriptions — <br>, <p>, and other HTML tags are stripped from job descriptions

Input Parameters

Parameter	Type	Required	Default	Description
keyword	string	No	—	Filter jobs by keyword (matches title, description, and tags). Example: "python", "react"
tag	string	No	—	Filter by job category tag. Example: "dev", "design", "sales"
maxResults	integer	No	100	Maximum number of job listings to return (1–1000)
location	string	No	—	Filter by location. Example: "USA", "Europe", "Worldwide"

Example Input

{
  "keyword": "python",
  "tag": "dev",
  "maxResults": 50,
  "location": "USA"
}

Output

Each item in the dataset represents one job listing with the following fields:

Field	Type	Description
id	string	Unique job ID
slug	string	URL slug
company	string	Company name
company_logo	string	URL of the company logo image
position	string	Job title / position name
tags	array	Array of skill/category tags
location	string	Job location (e.g., "Worldwide", "USA Only")
salary_min	number	Minimum annual salary (USD), if available
salary_max	number	Maximum annual salary (USD), if available
date	string	ISO 8601 date the job was posted
description	string	Plain-text job description (HTML removed)
url	string	URL to the job detail page on RemoteOK
apply_url	string	Direct application URL

Sample Output

[
  {
    "id": "12345",
    "slug": "senior-python-developer-at-acme-corp",
    "company": "Acme Corp",
    "company_logo": "https://remoteok.com/assets/img/jobs/abc123.png",
    "position": "Senior Python Developer",
    "tags": ["python", "django", "dev", "backend"],
    "location": "USA Only",
    "salary_min": 90000,
    "salary_max": 130000,
    "date": "2026-03-01T12:00:00Z",
    "description": "We are looking for a Senior Python Developer to join our remote team...",
    "url": "https://remoteok.com/remote-jobs/senior-python-developer-at-acme-corp",
    "apply_url": "https://acmecorp.com/jobs/apply/123"
  }
]

How to Use

On Apify Platform

1. Go to the Actor page on Apify Store
2. Click Try for free
3. Fill in the input fields (keyword, tag, etc.)
4. Click Start and wait for the run to finish
5. Download results as JSON, CSV, or Excel

Via Apify API

curl -X POST \
  "https://api.apify.com/v2/acts/YOUR_USERNAME~remoteok-scraper/runs" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "react",
    "maxResults": 50
  }' \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Local Development

# Install dependencies
pip install -r requirements.txt

# Set up input
mkdir -p storage/key_value_stores/default
echo '{"keyword": "python", "maxResults": 10}' > storage/key_value_stores/default/INPUT.json

# Run the Actor
python -m src

Rate Limiting

This Actor respects RemoteOK's API by:

• Waiting at least 2 seconds before making requests
• Retrying failed requests up to 3 times with exponential backoff

Disclaimer

This actor uses RemoteOK's publicly available API. Please use responsibly and respect rate limits.

Data belongs to their respective owners. This Actor is not affiliated with RemoteOK.

License

Apache-2.0