---
title: Extract Company Job Postings API
slug: extract-company-job-postings
url: https://apyhub.com/octopagis/service/extract-company-job-postings
provider: Octopagis
categories: [Retrieval Kit]
tags: [ats, job-postings, careers-data, recruiting, talent-intelligence]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 2
atoms: 100-250
mcp: true
---

# Extract Company Job Postings API

ATS Feed Detector API finds public ATS feeds from a target or a list of targets, then returns filtered job postings and board data. Free tier, no card.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/octopagis/extract-company-job-postings` | What it does Detects a public ATS feed for the given target and returns structured job postings plu… | 100 |
| POST | `https://api.eu.apyhub.com/octopagis/extract-company-job-postings/batch` | What it does Reads public ATS job feeds for one target or a list of up to five targets, then return… | 250 |

## Endpoint reference

### Detect public ATS feed & extract structured job postings

`GET https://api.eu.apyhub.com/octopagis/extract-company-job-postings` · 100 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `target` | query | string | yes | Target Example: `linear.app`. |
| `keywordFilter` | query | string | no | Keywordfilter Default: ``. |
| `locationFilter` | query | string | no | Locationfilter Default: ``. |
| `departmentFilter` | query | string | no | Departmentfilter Default: ``. |
| `remoteOnly` | query | boolean | no | Remoteonly Default: `false`. |
| `postedWithinDays` | query | integer | no | Postedwithindays Default: `0`. |
| `maxJobs` | query | integer | no | Maxjobs Default: `25`. |
| `includeFullDescription` | query | boolean | no | Opt-in: set true to include full job description text (descriptionText). Default: `false`. |

#### Quickstart

Fetch public ATS job postings for a target site like `linear.app`.

```bash
curl -X GET "https://api.eu.apyhub.com/octopagis/extract-company-job-postings?target=linear.app" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `count` as an integer, `resolvedBoards` as an array of resolution summaries, `items` as an array of normalized job posting records, and `failedInputs` as an array of per-target errors.

```json
{
  "count": 0,
  "resolvedBoards": [],
  "items": [],
  "failedInputs": []
}
```

### Read public ATS job feeds for 1 to 5 company targets

`POST https://api.eu.apyhub.com/octopagis/extract-company-job-postings/batch` · 250 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `targets` | body | array of string | no | List of 1 to 5 company domains or ATS URLs. Example: `["linear.app","cloudflare.com"]`. |
| `remoteOnly` | body | boolean | no | Remoteonly Default: `false`. |
| `keywordFilter` | body | string | no | Comma-separated keywords matched against title, description, and tech stack. Default: ``. |
| `locationFilter` | body | string | no | Comma-separated location substrings. Default: ``. |
| `departmentFilter` | body | string | no | Comma-separated department substrings. Default: ``. |
| `maxJobsPerTarget` | body | integer | no | Maxjobspertarget Default: `25`. |
| `postedWithinDays` | body | integer | no | 0 disables recency filtering. Default: `0`. |
| `includeFullDescription` | body | boolean | no | Opt-in: set true to include the full job description text (descriptionText). Disabled by default. Default: `false`. |

#### Quickstart

Search public ATS job feeds for one company by domain or ATS URL.

```bash
curl -X POST "https://api.eu.apyhub.com/octopagis/extract-company-job-postings/batch" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"linear.app"}'
```

#### What you'll get back

Returns a JSON object with `count` as an integer total, `resolvedBoards` as an array of target resolution summaries, and `items` as an array of normalized job posting records. It may also include `failedInputs` as an array of per-target errors when some targets fail.

```json
{
  "count": 1,
  "resolvedBoards": [],
  "items": []
}
```

## About

## What it does

The ATS Feed Detector API returns public job postings from an ATS feed for one target or up to five targets. Send a company domain, career page URL, or ATS board URL in `target`, or a list in `targets`. Add filters like `keywordFilter`, `locationFilter`, `departmentFilter`, `remoteOnly`, `postedWithinDays`, and `maxJobs` or `maxJobsPerTarget` to narrow the jobs you get back.

The ATS Feed Detector API can also include the full job description when you set `includeFullDescription` to true. The response gives you the total count, the matched boards, and the normalized job items. If some targets fail, `failedInputs` shows the per-target error details.

Teams use it to build job boards from company career sites. They use it to track hiring by role, location, or department. They also use it to feed recruiter tools and internal dashboards with fresh job data.

You can pair it with the [Extract Links from Webpage API](https://apyhub.com/apyhub/service/extract-links-from-webpage) to find more site links first. You can also use the [AI Text Keyword Extraction API](https://apyhub.com/apyhub/service/extract-keywords-from-text) after this API to analyze job text.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/octopagis/service/extract-company-job-postings
