Docs / Job Data API / Endpoints / Company jobs

Company jobs

The same shape and filters as /v1/jobs, scoped to one company. Accepts either the company slug or its display name, so a caller holding only the name from a previous response need not look the slug up first.

GET https://api.softon.dev/v1/companies/{id}/jobs Copy

Parameters

ParameterTypeDescription
id required string Company slug or name.
q string Full-text match within this company's postings.
limit integer Items per page, 1–100. Defaults to 25.
cursor string Opaque cursor from a previous response's meta.next. Do not construct one.
order string Sort field, prefixed with - to reverse.
source string Restrict to one scraper source.

Request

curl -G https://api.softon.dev/v1/companies/fincaazerbaijan/jobs \
  -H "Authorization: Bearer $SOFTON_KEY" \
  -d limit=50

Response

The envelope is identical on every softon.dev API: data, meta, error. Only the shape inside data changes per dataset — see the response envelope.

{
  "data": [
    {
      "id": "glorri:fincaazerbaijan-neftcala-filiallari-ucun-filial-kredit-satis-iscisi-33160475",
      "source": "glorri",
      "title": "Neftçala filialları üçün Filial Kredit Satış İşçisi",
      "company": { "name": "FINCA Azerbaijan", "slug": "fincaazerbaijan" },
      "location": "Salyan, Azərbaycan",
      "remote": false,
      "employment_type": "Full-time",
      "job_function": "Bank services",
      "career_level": "Professional",
      "posted_at": "2026-08-04T13:49:00.287Z",
      "ingested_at": "2026-08-04T23:55:43.722474Z"
    }
  ],
  "meta": { "count": 1, "next": "eyJvIjoyfQ", "request_id": "req_9Fv3" },
  "error": null
}

Fields of each item in data[]

FieldTypeDescription
id string Stable identifier, "<source>:<source id>". Pass it to /v1/jobs/{id}.
source string Which scraper produced this posting.
title string Posting title as published.
company object · nullable The hiring company: name and slug. null when the source omits it.
location string · nullable Free-text location as published.
remote boolean · nullable Whether the posting is remote-eligible.
employment_type string · nullable Full-time, Part-time, Contract, as the source labels it.
job_function string · nullable The source's own function taxonomy, not normalised across sources.
career_level string · nullable The source's own seniority label. Not normalised, so it is not called "seniority".
posted_at timestamp · nullable When the posting first appeared, RFC 3339.
url string · nullable Canonical page on the source site.
description string · nullable Full posting body. Present when the crawler has fetched the posting's own page, null otherwise — on collections and on /v1/jobs/{id} alike, since neither fetches on demand.
requirements string · nullable Requirements section when the source separates it, subject to the same condition as description.
facts object · nullable The source's own labelled metadata, e.g. "Apply Before". Label set differs per source.
ingested_at timestamp When this version was stored.

Try it

v1 · stable
Send the request to see a response.