Skip to main content
POST
/
v2
/
companies
/
job-changes
List job changes for companies
curl --request POST \
  --url https://api.tamtam.ai/api/v2/companies/job-changes \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_company_ids": [
    "<string>"
  ],
  "min_change_date": "<string>",
  "cursor": "<string>",
  "limit": 123
}
'
{
  "results": [
    {
      "change_type": "INCOMING",
      "job_change_id": "<string>",
      "job_title": "<string>",
      "linkedin_company_id": "<string>",
      "company_name": "<string>",
      "end_date": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "linkedin_url": "<string>",
      "related_experience": {
        "company_name": "<string>",
        "job_title": "<string>",
        "linkedin_company_id": "<string>"
      },
      "start_date": "<string>"
    }
  ],
  "total_count": 123,
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.api.tamtam.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Account API key passed in the Authorization header

Body

application/json
​
linkedin_company_ids
string[] | null
required

LinkedIn company IDs to look up job changes for. Up to 100.

Required array length: 1 - 100 elements
Example:
["104924588"]
​
min_change_date
string
required

Earliest job change date (inclusive). For INCOMING/PROMOTION this filters by the new job's start_date; for OUTGOING by the old job's end_date. LinkedIn provides month precision: dates always fall on the 1st of the month.

Example:

"2026-01-01"

​
cursor
string

Pagination cursor returned by a previous call. To paginate, save the next_cursor and pass it back unchanged on the next call. Use the same filters across calls — do not change filters mid-pagination. Cursors remain valid indefinitely unless this endpoint returns a 400.

​
limit
integer<int64>

Maximum number of results per page (1–500). Defaults to 100.

Example:

100

Response

OK

​
results
object[] | null
required

Job changes for this page

​
total_count
integer<int32>
required

Total number of job changes matching the filters at query time. May grow on subsequent polls as new changes are discovered.

Example:

487

​
next_cursor
string

Pass back unchanged to fetch the next page. Null when there are no more results.