apyhub
Back
▣ RETRIEVAL KIT

Extract Company Job Postings API

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 to find more site links first. You can also use the AI Text Keyword Extraction API after this API to analyze job text.

▣ ENDPOINT 01 / 02
GET
Detect public ATS feed & extract structured job postings
https://api.eu.apyhub.com/octopagis/extract-company-job-postings

QUICKSTART

GUIDE

Quickstart

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

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.

{
  "count": 0,
  "resolvedBoards": [],
  "items": [],
  "failedInputs": []
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Detects a public ATS feed for the given target and returns structured job postings plus resolution metadata. You can also narrow the returned postings with optional filters such as keyword, location, department, remote-only, age, and maximum result count.

Query Parameter(s)

AttributeTypeDescription
targetStringTarget ATS/site identifier. String with minimum length of 1. Example: linear.app.
keywordFilterStringFilter jobs by keyword. Default: empty string.
locationFilterStringFilter jobs by location. Default: empty string.
departmentFilterStringFilter jobs by department. Default: empty string.
remoteOnlyBooleanWhen true, return only remote jobs. Default: false.
postedWithinDaysIntegerReturn jobs posted within the last N days. Range: 0 to 365. Default: 0.
maxJobsIntegerMaximum number of jobs to return. Range: 1 to 100. Default: 25.
includeFullDescriptionBooleanOpt-in flag to include full job description text (descriptionText). Default: false.

Response

Returns a JSON object with count as an integer, resolvedBoards as an array, and items as an array. It also includes failedInputs as an array for per-target fetch errors; this field is present in the schema but not required.

ParameterTypeDescription
countIntegerTotal number of matching job postings returned in items.
failedInputsObject ArrayArray of per-target fetch errors. Each object may include input, errorType, httpStatus, and message. Empty when all targets succeed.
itemsObject ArrayArray of normalized ATS job posting records with optional salary and tech-stack signals.
resolvedBoardsObject ArrayResolution summary per target. Each object may include target, resolved, provider, slug, and matchBasis.
▣ ENDPOINT 02 / 02
POST
Read public ATS job feeds for 1 to 5 company targets
https://api.eu.apyhub.com/octopagis/extract-company-job-postings/batch

QUICKSTART

GUIDE

Quickstart

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

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.

{
  "count": 1,
  "resolvedBoards": [],
  "items": []
}
TRY ITLIVE · 250 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
JobSearchRequest*
Request payload for career-site ATS feed detection and structured job lookup.
Targets
List of 1 to 5 company domains or ATS URLs.
Comma-separated keywords matched against title, description, and tech stack.

About this endpoint

What it does

Reads public ATS job feeds for one target or a list of up to five targets, then returns normalized job posting records for the targets that could be resolved. The response also includes a count of returned postings and a per-target resolution summary.

Request Body

ParameterTypeDescription
targetStringSingle company domain, career page URL, or direct ATS board URL. Nullable.
targetsString ArrayList of 1 to 5 company domains or ATS URLs. Nullable. Max 5 items.
remoteOnlyBooleanDefault: false.
keywordFilterStringComma-separated keywords matched against title, description, and tech stack. Default: "".
locationFilterStringComma-separated location substrings. Default: "".
departmentFilterStringComma-separated department substrings. Default: "".
maxJobsPerTargetIntegerDefault: 25. Minimum: 1. Maximum: 100.
postedWithinDaysIntegerDefault: 0. Minimum: 0. Maximum: 365. 0 disables recency filtering.
includeFullDescriptionBooleanOpt-in flag. Set to true to include the full job description text (descriptionText). Default: false.

Response

Returns a JSON object with required count as an integer, resolvedBoards as an array of objects, and items as an array of objects. It may also include failedInputs as an array of objects when some targets cannot be fetched.

ParameterTypeDescription
countIntegerTotal number of matching job postings returned in items.
failedInputsObject ArrayArray of per-target fetch errors (input, errorType, httpStatus, message); empty when all targets succeed.
itemsObject ArrayArray of normalized ATS job posting records with optional salary and tech-stack signals.
resolvedBoardsObject ArrayResolution summary per target (target, resolved, provider, slug, matchBasis).
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.