Skip to main content
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

HeaderValue
X-API-KEYYour Clodura API key
Content-Typeapplication/json

​
Body Parameters

​
organisationId
string
Clodura’s unique identifier for the company. Obtain this from the Search Organizations endpoint. Required if orgLinkedinUrl is not provided.
​
orgLinkedinUrl
string
Full LinkedIn Company profile URL (e.g., https://www.linkedin.com/company/circuitry-ai/). Required if organisationId is not provided.
​
postedSince
date
required
Start date for filtering job postings. Format: YYYY-MM-DD (e.g., 2024-01-01).
​
postedUntil
date
required
End date for filtering job postings. Format: YYYY-MM-DD (e.g., 2024-12-31).
​
jobTitle
string
Exact match filter for a specific job title. Use this to find postings for a precise role.
​
jobFunction
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.
​
city
array
Filter job postings by one or more cities. Refer to the supported cities list.
​
state
array
Filter job postings by one or more states. Refer to the supported states list.
​
country
array
Filter job postings by one or more countries. Refer to the supported countries list.
​
keywords
array
Keywords to match within job description text (e.g., Kubernetes, GDPR, Agile).
​
hiringAreas
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.
​
page
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
  }'

​
Response

A successful 200 response returns a paginated list of job postings for the specified organization.
​
organisationId
string
The Clodura ID of the queried organization.
​
orgLinkedinUrl
string
The LinkedIn URL of the queried organization.
​
pagination
object
​
jobs
array

​
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

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