Skip to main content
GET
Job Posts

Overview

The Job Posts API returns live job listings for a company, sourced from LinkedIn and Indeed. Each listing includes the role title, source, location, posting date, an AI-condensed description, employment type, remote flag, salary range (when disclosed), experience level, and a list of extracted key skills. Hiring activity is one of the earliest signals of where a company is investing eg. a surge in sales roles, a build-out of an engineering function, or expansion into a new geography often shows up here before it’s publicly announced. Results are paginated and returned in the API response.

Endpoint Details

  • Method: GET
  • Endpoint: /api/v1/company/jobs

Authentication requirements

  • Include a valid API key in the x-api-key request header.

Request

Request Parameters

Header Parameters

string
required
Your API key.

URL Parameters

string
required
Company website (e.g. canva.com) or a company UUID (e.g. 00000l1). The UUID can be obtained from the Company Search API.
integer
Maximum number of job listings to return.Default = 10
integer
Number of listings to skip before returning records. Use with limit for pagination.Default = 0

Response

Successful Response Fields

Returns a JSON object with the following structure:
string
Request status. success on a successful response.
array
List of job listing objects. See Job Object Fields below.
integer
Total number of job listings available for the company based on the filters set.
integer
Limit applied to the request.
integer
Offset applied to the request.
float
Credits consumed by the request.

Job Object Fields

string
Unique identifier for the job listing.
string
Akta UUID of the company the listing belongs to.
string
Job title.
string
Source platform of the listing. Example values: linkedin, indeed.
string
Link to the original listing on the source platform.
string
Timestamp the listing was posted, in ISO 8601 format with timezone.
string
Location of the role. May be a city, region, or country.
string
A concise, AI-condensed summary of the role’s responsibilities.
string
Employment type. Example values: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP.
boolean
true if the role is offered as remote.
integer
Lower bound of the disclosed salary range, normalized to USD. null when not disclosed.
integer
Upper bound of the disclosed salary range, normalized to USD. null when not disclosed.
string
Required years of experience, expressed as a range. Example values: 2-5, 5-10.
array
List of skills extracted from the job description.

Authorizations

x-api-key
string
header
required

API key obtained from your Akta account.

Query Parameters

company
string
required

Company website (e.g. 'canva.com') or a company UUID. The UUID can be obtained from the Company Search API.

limit
integer
default:10

Maximum number of job listings to return.

offset
integer
default:0

Number of listings to skip before returning records.

Response

Job posts returned

status
string
data
object[]
count
integer
limit
integer
offset
integer
credits_consumed
number<float>