# Remote Jobs API
> A live board of remote job openings as an API, powered by the Jobicy remote job board. Search currently-open remote positions and narrow them with filters that actually work: by free-text keyword, by industry, by world region and by seniority level. /v1/jobs returns matching openings — each with the job title, the hiring company and its logo, the industry and job-type tags, the geographic region the role is open to, the seniority level, a plain-text excerpt and full description, the publication date and a direct apply URL. Filter with tag (a keyword such as python, react or sales that is matched against the listing), industry (dev for software engineering, plus design, marketing, copywriting, finance, hr, data-science, business, management and more), geo (usa, canada, uk, europe, emea, latam, asia, australia or anywhere) and level (junior, midweight, senior, manager); count caps how many are returned (1-50). Every filter is verified to genuinely narrow the result set, so a search for one industry never returns another. /v1/meta documents the available filter values. Ideal for job aggregators and niche job boards, career and recruiting sites, remote-work dashboards, and Slack/Discord/Telegram job-alert bots. Listings are live and change as roles open and close. Data from the Jobicy remote job board, free to use.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/remotejobs-api/..."
```

## Pricing
- **Free** (Free) — 1,800 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 42,000 calls/Mo, 5 req/s
- **Pro** ($26/Mo) — 190,000 calls/Mo, 12 req/s
- **Mega** ($70/Mo) — 720,000 calls/Mo, 35 req/s

## Endpoints

### Jobs

#### `GET /v1/jobs` — Search & filter open remote jobs

**Parameters:**
- `industry` (query, optional, string) — Industry, e.g. dev, design, marketing Example: `dev`
- `tag` (query, optional, string) — Keyword, e.g. python
- `geo` (query, optional, string) — Region, e.g. usa, europe, anywhere
- `level` (query, optional, string) — Seniority, e.g. senior
- `count` (query, optional, string) — Max results (1-50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/remotejobs-api/v1/jobs?industry=dev"
```

**Response:**
```json
{
    "data": {
        "jobs": [
            {
                "id": 145227,
                "url": "https://jobicy.com/jobs/145227-senior-full-stack-ai-native-developer",
                "level": "Senior",
                "title": "Senior Full Stack AI Native Developer",
                "region": "Spain",
                "company": "Leadtech",
                "excerpt": "As part of the Development team as a Full-Stack Developer, you will be instrumental in building and scaling our platforms and products. You will work across our entire A.I technology...",
                "industry": [
                    "Programming"
                ],
                "job_type": [
                    "Full-Time"
                ],
                "description": "As part of the Development team as a Full-Stack Developer, you will be instrumental in building and scaling our platforms and products. You will work across our entire A.I technology stack to deliver a seamless and powerful user experience. You will be joining projects with a shipping fast approach and a modern tech stack. Extensive knowledge of Javascript/Typescript. Design, implement, and maintain RESTful APIs with NextJS/Express to manage user authentication, data processing, and orchestrate analysis workflows Model Context Protocol (MCP) Knowledge Agents with Claude SDK: to Build AI agents access to real-time data, APIs, and tools Create AI Agents that can actually take actions, Combine the reasoning power of LLMs with real-wo
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Usage notes & filter values

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/remotejobs-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "A live board of currently-open remote jobs. /v1/jobs returns open positions and filters them upstream — by free-text keyword (tag=python), by industry (industry=dev, design, marketing, finance, hr, data-science, …), by region (geo=usa, europe, uk, emea, latam, asia, anywhere) and by seniority (level=junior, midweight, senior, manager); count caps the number returned (1-50). Each job carries the title, company name and logo, industry and job-type tags, the geographic region it's open to, the seniority level, a plain-text excerpt and full description, the publication date and a direct apply URL. All filters are verified to actually narrow results. Data from the Jobicy remote job board (free to use); listings change as roles open and close. Ideal for job aggregators, career sites, remote-work dashboards and Slack/Discord job bots.",
        "source": "Jobicy — remote job board (jobicy.com)",
        "filters": {
            "geo": [
                "usa",
                "canada",
                "uk",
                "europe",
                "emea",
                "latam",
                "asia",
                "australia",
                "anywhere"
            ],
            "level": [
                "any",
                "junior",
                "midweight",
                "senior",
                "manager"
            ],
            "industry": [
                "dev",
                "design",
                "marketing",
    
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/remotejobs-api
OpenAPI spec: https://www.oanor.com/api/remotejobs-api/openapi.json