Name: Jobs API: Live Jobs from Company Career Sites and ATS
Brand: pratham-org
SKU: api-pratham-org-career-site-jobs
Availability: InStock
Author: API Market

Pratham Kumar

# Career Site Jobs API

## Overview

The Career Site Jobs API returns live job openings collected from company career sites and the applicant tracking systems (ATS) behind them, such as Greenhouse, Lever, Ashby, Workday, SmartRecruiters and Workable, plus Indian HR platforms (Keka, greytHR, Zoho Recruit, RippleHire), large employer career sites (Amazon, Netflix, Accenture, Infosys, Wipro, HCLTech, Capgemini, KPMG India) and the Himalayas remote board. It has 2 endpoints. The jobs endpoint searches the index and returns up to 10 jobs per call, newest first, filtered by category, subcategory, experience level, country, state, city, work mode, company, source, keywords and posting date. The categories endpoint returns every valid value for those filters: 19 categories with 114 subcategories, the experience levels, the 25 sources and the work modes. Call it once to build your filter menus, then pass the same names to the jobs endpoint. According to the provider, the index holds about 920,000 live jobs from more than 30,000 companies and is rebuilt every day from the source sites, so calls read a ready index instead of scraping live.

It is built for teams running job boards and niche job sites, job alert and newsletter products, AI agents that match candidates to openings, recruiters and sales teams watching who is hiring, and analysts counting roles by category, level or location. Every response uses the same envelope: `success` and a `data` object. A jobs page has `count`, a `jobs` array and a `nextCursor` string that you pass back as `cursor` for the next page; it is `null` when there are no more results. Each job carries a stable `id`, `title`, `company`, an `applyUrl` that points to the posting on the career site or board it was read from, `category`, `subcategory`, `experienceLevel`, `workMode`, `isRemote`, the location text as posted plus parsed `locations` (country, state, city), the `source`, and `postedAt` and `lastSeenAt` dates. Fields the posting does not provide, such as `companyDomain` or `experienceMin`, are left out instead of being returned empty. Job descriptions and salaries are not included.

## Features

*   **2 endpoints**: Job search with filters and cursor paging, and a list of every valid category, subcategory, experience level, source and work mode.
*   **Rich filters**: Categories, subcategories, experience levels, countries, states, cities, work modes, worldwide remote, company, source, include and exclude keywords, and posting date (`postedWithinDays` or `postedAfter`).
*   **Flexible inputs**: Lists take comma-separated values or a repeated parameter, names are case-insensitive, and common aliases work (`usa`, `uk`, `uae`, and `Bangalore` for `Bengaluru`).
*   **Structured jobs**: Category, subcategory and experience level are already assigned, locations are parsed into country, state and city, and remote jobs carry a `remoteScope` of `worldwide`, `region`, `country` or `unknown`.
*   **Stable ids**: Each job `id` is an MD5 hash of its apply URL, so it stays the same across daily refreshes and you can skip jobs you already have.
*   **Data source**: Jobs are read from company career sites and ATS boards (25 sources). The provider reports about 920,000 live jobs from more than 30,000 companies, refreshed daily.
*   **Cursor paging**: Up to 10 jobs per call, newest first, with `nextCursor` for the next page.
*   **Rate limit**: 1 request per second on the Free plan, 2 per second on PRO and ULTRA, and 3 per second on MEGA.

## Use Cases

*   **Job boards and niche sites**: Fill a board for one country, one role family or one tech stack with fresh openings every day.
*   **Job alerts**: Send users only new matching jobs by calling with `postedWithinDays=1` and skipping `id` values you have already sent.
*   **AI agents and copilots**: Let an agent find openings that match a candidate profile with exact filters instead of a web search.
*   **Hiring signals for sales**: See what a company is hiring for with `company=`, or which companies are hiring for a skill with `keywords=`.
*   **Recruiting research**: Track the open roles of target companies and competitors by category, level and location.
*   **Labour market research**: Count openings by category, experience level, country or remote type.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/pratham-org/career-site-jobs
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search jobs

Searches live jobs and returns up to 10 per call, newest first, with a cursor for the next page. All filters are optional. List filters take comma-separated values or a repeated parameter, and names are case-insensitive.

**Method:** `GET`

**Endpoint:** `/api/public/v1/jobs`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `keywords` | query | Search terms matched against job title and company (prefix match). A job matches any term. Example: `react,node`. | string | No | - | - |
| `excludeKeywords` | query | Drops jobs whose title or company contains any of these terms. Example: `intern,contract`. | string | No | - | - |
| `categories` | query | Category names from `/api/public/v1/categories`, such as `Software Engineering` or `Data & AI`. | string | No | - | - |
| `subcategories` | query | Subcategory names, alone or as `Category › Subcategory`, such as `Backend,Mobile`. A subcategory narrows its category. | string | No | - | - |
| `experienceLevels` | query | One or more of `Fresher`, `Junior`, `Mid-level`, `Senior`, `Staff+`, `Not specified`. | string | No | - | - |
| `countries` | query | Country names or common aliases (`usa`, `uk`, `uae`). Example: `India,United States`. | string | No | - | - |
| `states` | query | State or province names. Example: `Karnataka`. | string | No | - | - |
| `city` | query | City names; spelling variants match (`Bangalore` = `Bengaluru`). Example: `Bengaluru,Pune`. | string | No | - | - |
| `includeWorldwideRemote` | query | Also return remote jobs open worldwide, which have no country. Sent alone, it returns only those jobs. | boolean | No | - | - |
| `includeUnspecifiedLocation` | query | Also return jobs whose posting gives no usable location. Sent alone, it returns only those jobs. | boolean | No | - | - |
| `workModes` | query | One or more of `remote`, `hybrid`, `onsite`. | string | No | - | - |
| `sources` | query | Source ids (alias `ats`), such as `greenhouse,lever`. See `/api/public/v1/categories` for all 25. | string | No | - | - |
| `company` | query | Company names, case-insensitive. For a name that contains a comma, send it as its own `company=` parameter. | string | No | - | - |
| `postedWithinDays` | query | Only jobs posted in the last N days. Minimum `1`. | integer | No | - | - |
| `postedAfter` | query | Only jobs posted on or after this date, `YYYY-MM-DD`, inclusive. | string | No | - | - |
| `limit` | query | Jobs per call. For more, page with `cursor`. | integer | No | `10` | 10 |
| `cursor` | query | The `nextCursor` value from the previous page. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/pratham-org/career-site-jobs/api/public/v1/jobs?subcategories=Backend&countries=India&experienceLevels=Mid-level" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "success": true,
  "data": {
    "count": 10,
    "jobs": [
      {
        "id": "0fe61b4affffb6ad515566d7e2280c37",
        "title": "Back-End Developer (Job ID: 2266)",
        "company": "ConverseNow.ai",
        "applyUrl": "https://himalayas.app/companies/conversenow-ai/jobs/back-end-developer-job-id-2266-2823013905",
        "category": "Software Engineering",
        "subcategory": "Backend",
        "experienceLevel": "Mid-level",
        "experienceMin": 3,
        "workMode": "remote",
        "isRemote": true,
        "remoteScope": "country",
        "location": "India",
        "locations": [
          {
            "country": "India"
          }
        ],
        "country": "India",
        "source": "himalayas",
        "ats": "himalayas",
        "postedAt": "2026-10-17",
        "lastSeenAt": "2026-10-17T12:01:03.521Z"
      },
      {
        "id": "80792af1a4bf45f0f0023a1aa241408e",
        "title": "Java Backend Developer - Vadodara",
        "company": "Capco",
        "companyDomain": "capco.com",
        "companyLogo": "https://www.google.com/s2/favicons?domain=capco.com&sz=128",
        "applyUrl": "https://job-boards.greenhouse.io/capco/jobs/8288585",
        "category": "Software Engineering",
        "subcategory": "Backend",
        "experienceLevel": "Mid-level",
        "experienceMin": 4,
        "workMode": "onsite",
        "isRemote": false,
        "location": "India - Pune",
        "locations": [
          {
            "country": "India",
            "state": "Maharashtra",
            "city": "Pune"
          }
        ],
        "city": "Pune",
        "country": "India",
        "source": "greenhouse",
        "ats": "greenhouse",
        "postedAt": "2026-10-16",
        "lastSeenAt": "2026-10-17T10:33:09.056Z"
      }
    ],
    "nextCursor": "eyJzb3J0VmFsdWUiOiIyMDI2LTEwLTA2IiwidXJsIjoiaHR0cHM6Ly9oaW1hbGF5YXMuYXBwL2NvbXBhbmllcy9iamFrL2pvYnMvYmFja2VuZC1zb2Z0d2FyZS1lbmdpbmVlci1haS1maW5hbmNlLWFnZW50LTgwODMwNTk5NDkifQ"
  }
}
```

The full response had 10 jobs; two are shown. To get the next 10, repeat the same request with `&cursor=` set to the `nextCursor` value. Jobs without a known `companyDomain`, `city` or `experienceMin` simply omit those fields.

#### 2. List filter values

Returns every valid value for the jobs filters: the 19 categories, each with its subcategories (114 in total), the experience levels, the 25 sources with their display names, and the work modes. The values change rarely, so cache the response instead of calling it before every search.

**Method:** `GET`

**Endpoint:** `/api/public/v1/categories`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| - | - | This endpoint takes no parameters. | - | - | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/pratham-org/career-site-jobs/api/public/v1/categories" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "success": true,
  "data": {
    "categories": [
      {
        "name": "Software Engineering",
        "subcategories": [
          "Backend",
          "Frontend",
          "Full-stack",
          "Mobile",
          "Embedded & hardware",
          "QA & Test",
          "Enterprise apps (SAP, Salesforce...)",
          "Games & graphics",
          "General software"
        ]
      },
      {
        "name": "DevOps, Cloud & Infrastructure",
        "subcategories": [
          "DevOps / SRE / Cloud",
          "Sysadmin & Network",
          "Other infrastructure"
        ]
      },
      {
        "name": "Data & AI",
        "subcategories": [
          "Machine learning & AI",
          "Data engineering",
          "Analytics & BI",
          "AI training & annotation",
          "Other data"
        ]
      }
    ],
    "experienceLevels": [
      "Fresher",
      "Junior",
      "Mid-level",
      "Senior",
      "Staff+",
      "Not specified"
    ],
    "sources": [
      {
        "id": "greenhouse",
        "name": "Greenhouse"
      },
      {
        "id": "lever",
        "name": "Lever"
      },
      {
        "id": "ashby",
        "name": "Ashby"
      },
      {
        "id": "smartrecruiters",
        "name": "SmartRecruiters"
      }
    ],
    "workModes": [
      "remote",
      "hybrid",
      "onsite"
    ]
  }
}
```

The full response lists all 19 categories and all 25 sources; three categories and four sources are shown here.

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and returns a page of jobs, or the filter value lists. |
| 400 | Bad Request | A filter value is not valid, for example an unknown category, experience level or source. The error message says which value is wrong. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path does not exist. Check that it starts with `/api/public/v1/`. |
| 429 | Too Many Requests | You went over your plan's requests-per-second limit, or you have used all the calls in your plan. |
| 500 | Internal Server Error | Something failed while processing the request. Retry after a short delay. |

## Rate Limits

The Free plan allows 1 request per second, the PRO and ULTRA plans allow 2 requests per second, and the MEGA plan allows 3 requests per second. The Free plan is a 7-day trial with 50 calls and stops at that limit. PRO includes 1,500 calls, ULTRA 6,000 and MEGA 25,000, and the paid plans keep working past their included calls at an overage rate. The provider also documents a limit of 60 requests per minute per user. Requests above these limits, or after the Free plan's calls are used up, return `429 Too Many Requests`. Back off before retrying and honour any `Retry-After` header. When you page through a large result set, pace the cursor calls to stay under your plan's per-second limit. In our tests the categories endpoint answered in about 0.8 seconds and job searches in 1.1 to 2.0 seconds.

## FAQ

**How do I get more than 10 jobs?**

Each call returns at most 10 jobs. Take the `nextCursor` value from the response and send it as `cursor` with the same filters to get the next 10. Keep going until `nextCursor` is `null`. Each page counts as one call.

**Where do the jobs come from?**

From company career sites and the ATS boards behind them: Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Teamtailor, Personio, BambooHR, Rippling and Breezy HR, Indian HR platforms such as Keka, greytHR, Zoho Recruit and RippleHire, the career sites of Amazon, Netflix, Accenture, Infosys, Wipro, HCLTech, Capgemini and KPMG India, and the Himalayas remote board. The `source` field on each job says which one. It is not a LinkedIn or Indeed scraper.

**Can the same job appear twice?**

Yes. An opening posted on two sources, for example on a company's Greenhouse board and on Himalayas, comes back as two jobs with different `id` values. In our test search for Stripe remote jobs, the same Account Executive role appeared once from each source. If that matters, dedupe on `applyUrl` or on `title` plus `company`.

**Why does a location filter leave out some remote jobs?**

Location filters only match jobs with a known location. Remote jobs that are open worldwide have no country, so add `includeWorldwideRemote=true` to include them. Jobs whose posting gives no usable location are added with `includeUnspecifiedLocation=true`.

**Do jobs include descriptions or salaries?**

No. Each job has the title, company, category, subcategory, experience level, work mode, location, apply link and dates. Follow `applyUrl` to read the full posting on the career site.

**How fresh is the data?**

The provider rebuilds the index every day from the source sites. `postedAt` is the posting date, or the date the job was first found when the site gives none, and `lastSeenAt` is the last time the job was seen live. Use `postedWithinDays` or `postedAfter` to fetch only recent jobs.

**What values can I use for categories and experience levels?**

Call `/api/public/v1/categories` for the full list. Experience levels are `Fresher`, `Junior`, `Mid-level`, `Senior`, `Staff+` and `Not specified`. Names are case-insensitive, and a subcategory can be sent alone or as `Category › Subcategory`.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Jobs API that returns live job listings from Greenhouse, Lever, Workday and other company career sites, with filters for role, experience, location and remote.

Jobs API: Live Jobs from Company Career Sites and ATS

Free