Retrieve Active and Historical Job Posts for a Company

The Job Posts endpoint retrieves historical and active job postings from a specific organization, giving you a detailed window into a company’s hiring activity. Job data is sourced from LinkedIn and other platforms, enriched with structured metadata including job function, seniority level, hiring areas (tech stack and domain expertise), and geographic location. Sales and revenue teams commonly use this data to identify buying intent signals — a company aggressively hiring in Engineering or DevOps roles signals investment and potential budget for new tools. You must provide either an organisationId or orgLinkedinUrl to identify the target company, as well as a date range using postedSince and postedUntil. The endpoint returns up to 200 jobs per request.

Credit cost: 2 credits per API request regardless of how many jobs are returned.Capacity: Maximum of 200 job postings per company per request. Use pagination (page) to retrieve additional results.

Endpoint

POST /api/v1/organisation/jobpost

Request

Headers

Header	Value
`X-API-KEY`	Your Clodura API key
`Content-Type`	`application/json`

Body Parameters

string

Clodura’s unique identifier for the company. Obtain this from the Search Organizations endpoint. Required if orgLinkedinUrl is not provided.

string

Full LinkedIn Company profile URL (e.g., https://www.linkedin.com/company/circuitry-ai/). Required if organisationId is not provided.

date

required

Start date for filtering job postings. Format: YYYY-MM-DD (e.g., 2024-01-01).

date

required

End date for filtering job postings. Format: YYYY-MM-DD (e.g., 2024-12-31).

string

Exact match filter for a specific job title. Use this to find postings for a precise role.

array

Filter by department or business function. Accepted values include: Admin, Analytics, Cloud, Customer Service, Cyber Security, Data Engineering, Devops, Engineering, Finance, HR, IT, Inside Sales, Legal, Marketing, Operations, Product Management, Sales, Security, Support, Testing, Training, Research, and more.

array

Filter job postings by one or more cities. Refer to the supported cities list.

array

Filter job postings by one or more states. Refer to the supported states list.

array

Filter job postings by one or more countries. Refer to the supported countries list.

array

Keywords to match within job description text (e.g., Kubernetes, GDPR, Agile).

array

Industry or technology focus areas derived from job descriptions. Accepted values include: Artificial Intelligence, Machine Learning, Data Science, Cloud Computing, SaaS, DevOps, Cyber Security, Blockchain, IoT, Mobile Applications, Web Development, CRM Implementation, ERP Implementation, Salesforce Development, and many more.

integer

Page number to retrieve. Maximum: 100.

You must provide at least one of organisationId or orgLinkedinUrl. Requests that include neither will be rejected.

Example Request

curl --request POST \
  --url https://api.clodura.ai/api/v1/organisation/jobpost \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "organisationId": "2389402640191586304",
    "postedSince": "2024-01-01",
    "postedUntil": "2024-12-31",
    "jobFunction": ["Engineering", "Sales"],
    "page": 1
  }'

import requests

url = "https://api.clodura.ai/api/v1/organisation/jobpost"

headers = {
    "X-API-KEY": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "organisationId": "2389402640191586304",
    "postedSince": "2024-01-01",
    "postedUntil": "2024-12-31",
    "jobFunction": ["Engineering", "Sales"],
    "page": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response

A successful 200 response returns a paginated list of job postings for the specified organization.

string

The Clodura ID of the queried organization.

string

The LinkedIn URL of the queried organization.

object

Show pagination fields

integer

The current page number.

integer

Number of job records returned per page.

integer

Total number of job postings matching your filters.

integer

Total number of pages available.

array

Show job object fields

string

Unique identifier for this job posting.

string

Platform where this job was posted (e.g., LinkedIn).

string

Title of the job posting.

string

Employment type (e.g., Full time, Part time, Contract).

string

Seniority level required for the role (e.g., Manager, Senior, Entry Level).

string

Department or business function this role belongs to.

string

Full or summarized job description text.

string

Human-readable location of the job posting.

string

City where the job is located.

string

State where the job is located.

string

Country where the job is located.

string

ISO 8601 timestamp of when the job was posted.

string

Direct URL to the original job posting.

array

Technology and domain focus areas identified in the job description (e.g., UX, AI, IT).

Example Response

{
  "organisationId": "2389402640191586304",
  "orgLinkedinUrl": "https://www.linkedin.com/company/clodura-ai/",
  "pagination": {
    "page": 1,
    "perPage": 10,
    "totalEntries": 45,
    "totalPages": 5
  },
  "jobs": [
    {
      "jobId": "job_7721",
      "source": "LinkedIn",
      "jobTitle": "Software Engineering Manager",
      "jobType": "Full time",
      "jobSeniority": "Manager",
      "jobFunction": "Engineering",
      "description": "We are looking for an experienced Software Engineering Manager...",
      "location": "San Francisco, California, USA",
      "city": "San Francisco",
      "state": "California",
      "country": "USA",
      "datePosted": "2024-06-15T10:46:08Z",
      "link": "https://www.linkedin.com/jobs/view/123456789",
      "hiringareas": ["Machine Learning", "Cloud Computing", "AI"]
    }
  ]
}

Error Codes

Status	Meaning
`400`	Bad request — malformed input or domain count exceeded
`401`	Unauthorized — your API key is missing or invalid
`402`	Payment required — credits exhausted; upgrade your plan or add credits
`403`	Forbidden — this endpoint requires a paid Clodura plan
`404`	Not found — no job postings found for this organization
`409`	Daily rate limit reached — maximum API calls for this endpoint exceeded
`422`	Unprocessable entity — invalid parameter combination or malformed JSON
`429`	Rate limit exceeded — reduce request frequency or upgrade your plan

Overview

People API

Company API

Retrieve Active and Historical Job Posts for a Company

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

Error Codes

​Endpoint

​Request

​Headers

​Body Parameters

​Example Request

​Response

​Example Response

​Error Codes

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

Error Codes