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: /v1/company/jobs

Authentication requirements

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

Request

Request Parameters

Header Parameters

x-api-key
string
required
Your API key.

URL Parameters

company
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.
limit
integer
Maximum number of job listings to return.Default = 10
offset
integer
Number of listings to skip before returning records. Use with limit for pagination.Default = 0

Example Request

Response

Successful Response Fields

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

Job Object Fields

job_id
string
Unique identifier for the job listing.
company_uuid
string
Akta UUID of the company the listing belongs to.
title
string
Job title.
source
string
Source platform of the listing. Example values: linkedin, indeed.
job_url
string
Link to the original listing on the source platform.
date_posted
string
Timestamp the listing was posted, in ISO 8601 format with timezone.
location
string
Location of the role. May be a city, region, or country.
description
string
A concise, AI-condensed summary of the role’s responsibilities.
type
string
Employment type. Example values: FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP.
remote
boolean
true if the role is offered as remote.
salary_min_usd
integer
Lower bound of the disclosed salary range, normalized to USD. null when not disclosed.
salary_max_usd
integer
Upper bound of the disclosed salary range, normalized to USD. null when not disclosed.
experience_level
string
Required years of experience, expressed as a range. Example values: 2-5, 5-10.
key_skills
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
array
count
integer
limit
integer
offset
integer
credits_consumed
number<float>