Get Job Change Signals

curl --request GET \
  --url https://www.trysignalbase.com/api/v2/signals/job-changes \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": [
    {
      "signalId": "550e8400-e29b-41d4-a716-446655440000",
      "personName": "Alex Johnson",
      "personLinkedinUrl": "https://www.linkedin.com/in/alexjohnson",
      "signalType": "job_change",
      "occurredAt": "2024-11-01T00:00:00Z",
      "discoveredAt": "2024-11-02T12:00:00Z",
      "companyName": "NextGen Software",
      "companyLinkedinUrl": "https://www.linkedin.com/company/nextgensoftware",
      "newRole": "Chief Technology Officer"
    },
    {
      "signalId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "personName": "Priya Singh",
      "personLinkedinUrl": "https://www.linkedin.com/in/priyasingh",
      "signalType": "job_change",
      "occurredAt": "2024-10-20T00:00:00Z",
      "discoveredAt": "2024-10-21T08:00:00Z",
      "companyName": "HealthTech Solutions",
      "companyLinkedinUrl": "https://www.linkedin.com/company/healthtechsolutions",
      "newRole": "Head of Product"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 12,
    "totalCount": 240,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "signals.job-changes",
    "creditsUsed": 1
  }
}

GET

signals

job-changes

Get Job Change Signals

curl --request GET \
  --url https://www.trysignalbase.com/api/v2/signals/job-changes \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": [
    {
      "signalId": "550e8400-e29b-41d4-a716-446655440000",
      "personName": "Alex Johnson",
      "personLinkedinUrl": "https://www.linkedin.com/in/alexjohnson",
      "signalType": "job_change",
      "occurredAt": "2024-11-01T00:00:00Z",
      "discoveredAt": "2024-11-02T12:00:00Z",
      "companyName": "NextGen Software",
      "companyLinkedinUrl": "https://www.linkedin.com/company/nextgensoftware",
      "newRole": "Chief Technology Officer"
    },
    {
      "signalId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "personName": "Priya Singh",
      "personLinkedinUrl": "https://www.linkedin.com/in/priyasingh",
      "signalType": "job_change",
      "occurredAt": "2024-10-20T00:00:00Z",
      "discoveredAt": "2024-10-21T08:00:00Z",
      "companyName": "HealthTech Solutions",
      "companyLinkedinUrl": "https://www.linkedin.com/company/healthtechsolutions",
      "newRole": "Head of Product"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 12,
    "totalCount": 240,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "signals.job-changes",
    "creditsUsed": 1
  }
}

Authorizations

Authorization

string

header

required

API key for V2 Job Change Signals API authentication. Include as Bearer token in Authorization header.

Query Parameters

page

integer

default:1

Page number for pagination

Required range: x >= 1

limit

integer

default:20

Number of results per page (maximum 100)

Required range: 1 <= x <= 100

string

Search by company or person keywords

personLinkedinUrl

string<uri>

Exact LinkedIn profile URL of the person

companyLinkedinUrl

string<uri>

Exact LinkedIn company page URL

positions

string

Comma-separated list of positions to filter by. Allowed values include ceo, cto, cfo, coo, vp of engineering, vp of sales, vp of marketing, head of product, head of growth, head of engineering, engineering manager, product manager, sales manager, marketing manager, founder, co-founder.

departments

string

Comma-separated list of departments to filter by. Allowed values include marketing, sales, engineering, product, design, operations, finance, people, data, customer_success, growth, legal.

seniorities

string

Comma-separated list of seniority levels to filter by. Allowed values include founder, c_level, vp, director, head, lead, manager.

Response

Successful response with job change signals

success

boolean

required

Indicates if the request was successful

Example:

true

data

object[]

required

Array of job change signal records

Show child attributes

data.signalId

string<uuid>

required

Unique identifier for the job change signal

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.signalType

string

required

Type of signal (job_change)

Example:

"job_change"

data.occurredAt

string<date-time>

required

When the job change occurred

Example:

"2024-11-01T00:00:00Z"

data.personName

string

required

Full name of the person

Example:

"Alex Johnson"

data.companyName

string

required

Name of the company

Example:

"NextGen Software"

data.newRole

string

required

New role/title for the person

Example:

"Chief Technology Officer"

data.discoveredAt

string<date-time> | null

When the signal was discovered

Example:

"2024-11-02T12:00:00Z"

data.personLinkedinUrl

string<uri> | null

LinkedIn profile URL of the person

Example:

"https://www.linkedin.com/in/alexjohnson"

data.companyLinkedinUrl

string<uri> | null

LinkedIn company page URL

Example:

"https://www.linkedin.com/company/nextgensoftware"

pagination

object

required

Show child attributes

pagination.currentPage

integer

required

Current page number

Required range: x >= 1

Example:

1

pagination.totalPages

integer

required

Total number of pages available

Required range: x >= 0

Example:

12

pagination.totalCount

integer

required

Total number of records matching the query

Required range: x >= 0

Example:

240

pagination.hasNextPage

boolean

required

Indicates if there is a next page

Example:

true

pagination.hasPreviousPage

boolean

required

Indicates if there is a previous page

Example:

false

V2 Job Change Signals API Introduction

Endpoint Examples

Get Job Change Signals

Authorizations

Query Parameters

Response