APIS.md

Remote Job Board APIs - Comprehensive List

This document lists all available job board APIs for remote full-stack software engineering positions, categorized by free/paid status.

Currently Implemented ✅

1. RemoteOK - FREE

   • URL: https://remoteok.com/api
   • Status: ✅ Implemented
   • Notes: One of the largest remote job boards, returns ~100 jobs

2. Remotive - FREE (with 24h delay) / PAID (real-time)

   • URL: https://remotive.com/api/remote-jobs
   • Status: ✅ Implemented (using free version)
   • Notes: Returns 1,500+ jobs, excellent for software-dev category

3. Arbeitnow - FREE

   • URL: https://www.arbeitnow.com/api/job-board-api
   • Status: ✅ Implemented
   • Notes: European focus, includes remote filter

High Priority - Free APIs 🎯

4. Himalayas - FREE

   • URL: https://himalayas.app/api
   • Limit: 20 jobs per request (as of March 2025)
   • Status: ❌ Not implemented
   • Notes: High-quality remote jobs, well-curated

5. JustRemote - UNKNOWN

   • URL: https://justremote.co
   • Status: ❌ Not implemented
   • Notes: Popular remote job board, need to investigate API availability

6. Remote Leaf - PAID

   • URL: https://remoteleaf.com/remote-jobs-api
   • Status: ❌ Not implemented
   • Notes: Claims to be "world's biggest API feed of remote jobs data"
   • Cost: Unknown, requires contact

General Job APIs (with remote filter) 🌐

7. Adzuna - FREE (with API key)

   • URL: https://developer.adzuna.com
   • Auth: Requires API key
   • Limit: Unknown
   • Status: ❌ Not implemented
   • Notes: Aggregates jobs from multiple sources, has remote filter
   • Formats: JSON, JSONP, XML

8. Reed - FREE (with API key)

   • URL: https://www.reed.co.uk/developers
   • Auth: Requires API key
   • Limit: 1,000 requests/day per key (Jobseeker API)
   • Status: ❌ Not implemented
   • Notes: UK-focused, has remote options

9. USAJobs - FREE

   • URL: https://developer.usajobs.gov
   • Auth: Requires API key
   • Status: ❌ Not implemented
   • Notes: US government jobs, many remote positions
   • Focus: Government positions (might not be high-paying for private sector)

Potential APIs (Need Investigation) 🔍

10. Findwork.dev

    • URL: https://findwork.dev
    • Status: ❌ Need to investigate API availability
    • Notes: Developer-focused job board

11. WeWorkRemotely

    • URL: https://weworkremotely.com
    • Status: ❌ No public API found
    • Notes: One of the largest remote job boards, but no official API
    • Alternative: Would need HTML scraping (fragile)

12. Wellfound (formerly AngelList Talent)

    • URL: https://wellfound.com
    • Status: ❌ Need to investigate API availability
    • Notes: Startup jobs, many remote positions

13. Stack Overflow Jobs

    • URL: https://stackoverflow.com/jobs
    • Status: ⚠️ Deprecated (Stack Overflow shut down their job board)
    • Notes: No longer available

Aggregator APIs 📊

14. Indeed API

    • URL: https://indeed.com
    • Status: ⚠️ No public API (partner access only)
    • Notes: Largest job board but no public API

15. LinkedIn Jobs API

    • URL: https://developer.linkedin.com
    • Status: ⚠️ Requires LinkedIn partnership
    • Notes: Restricted access, complex authentication

16. Glassdoor API

    • URL: https://www.glassdoor.com
    • Status: ⚠️ No public job search API
    • Notes: Company reviews available via partner API

Specialized Tech APIs 💻

17. GitHub Jobs

    • Status: ⚠️ Discontinued
    • Notes: GitHub shut down their job board in 2021

18. Honeypot (EU focused)

    • URL: https://www.honeypot.io
    • Status: ❌ Need to investigate API
    • Notes: Developer-focused, European market

19. Hired

    • URL: https://hired.com
    • Status: ❌ No public API found
    • Notes: Reverse job board (companies apply to you)

API Comparison Matrix

API	Status	Cost	Auth	Rate Limit	Jobs/Request	Quality	Focus
RemoteOK	✅	FREE	No	Unknown	~100	High	Remote-first
Remotive	✅	FREE*	No	Unknown	1,500+	High	Tech/Remote
Arbeitnow	✅	FREE	No	Unknown	100	Medium	EU/Remote
Himalayas	❌	FREE	Unknown	20/req	20	High	Remote-first
Adzuna	❌	FREE	API Key	Unknown	Unknown	Medium	General
Reed	❌	FREE	API Key	1,000/day	Unknown	Medium	UK-focused
USAJobs	❌	FREE	API Key	Unknown	Unknown	Medium	Gov't jobs
Remote Leaf	❌	PAID	Unknown	Unknown	Unknown	Unknown	Remote

*Remotive free version has 24-hour delay

Implementation Priority

Phase 1 (High Value, Easy)

1. ✅ RemoteOK - Done
2. ✅ Remotive - Done
3. ✅ Arbeitnow - Done
4. Himalayas - Free, well-documented

Phase 2 (Medium Value, Requires API Key)

5. Adzuna - Large aggregator
6. Reed - UK market
7. USAJobs - Government positions

Phase 3 (Investigation Required)

8. JustRemote - Check if API exists
9. Findwork.dev - Check if API exists
10. Wellfound - Check API availability

Phase 4 (Paid/Complex)

11. Remote Leaf - Paid API
12. LinkedIn - Complex auth, partnership required
13. Indeed - No public API

Recommendations for High-Paying Remote Full-Stack Jobs

Best Sources:

1. RemoteOK - Large volume, good quality
2. Remotive - Excellent curation, many high-paying roles
3. Himalayas - High-quality, well-vetted positions
4. Adzuna - Aggregates from multiple sources

Focus Locations for High Pay:

• United States (especially SF Bay Area, NYC, Seattle)
• Dubai / UAE
• Switzerland
• Canada (Toronto, Vancouver)
• UK (London)
• Germany (Berlin, Munich)
• Singapore
• Australia (Sydney, Melbourne)

Notes

• Most free APIs have rate limits
• Some APIs (like Remotive) have paid tiers with better features
• Always respect rate limits and ToS
• Consider caching responses to minimize API calls
• Some APIs require attribution/backlinks

API Key Management

For APIs requiring keys:

1. Store keys in environment variables
2. Implement rate limiting
3. Add retry logic with exponential backoff
4. Monitor API usage
5. Have fallback mechanisms if API is down

Next Steps

1. Implement Himalayas API (free, 20 jobs per request)
2. Investigate JustRemote and Findwork.dev for API availability
3. Set up API key management system
4. Implement Adzuna (requires registration for API key)
5. Consider paid Remote Leaf API if free sources insufficient