Skip to main content
GET
/
signals
/
hiring
Get Hiring Signals
curl --request GET \
  --url https://www.trysignalbase.com/api/v2/signals/hiring \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Senior Software Engineer",
      "jobUrl": "https://www.linkedin.com/jobs/view/123456789",
      "location": "San Francisco, CA",
      "city": "San Francisco",
      "region": "California",
      "country": "US",
      "datePosted": "2024-11-01T00:00:00Z",
      "employmentType": "Full-time",
      "seniorityLevel": "Mid-Senior level",
      "jobFunction": "Engineering",
      "numApplicants": "45",
      "companyName": "NextGen Software",
      "companyWebsite": "https://www.nextgensoftware.com",
      "companyIndustry": "Technology",
      "companyCountry": "US",
      "companyEmployeeCount": 250,
      "companyFoundedYear": 2018,
      "companyLogoUrl": "https://media.licdn.com/dms/image/example.png"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "title": "VP of Engineering",
      "jobUrl": "https://www.linkedin.com/jobs/view/987654321",
      "location": "New York, NY",
      "city": "New York",
      "region": "New York",
      "country": "US",
      "datePosted": "2024-10-28T00:00:00Z",
      "employmentType": "Full-time",
      "seniorityLevel": "Executive",
      "jobFunction": "Engineering",
      "numApplicants": "120",
      "companyName": "HealthTech Solutions",
      "companyWebsite": "https://www.healthtechsolutions.com",
      "companyIndustry": "Healthcare Technology",
      "companyCountry": "US",
      "companyEmployeeCount": 85,
      "companyFoundedYear": 2020,
      "companyLogoUrl": "https://media.licdn.com/dms/image/example2.png"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 50,
    "totalCount": 1000,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "signals.hiring",
    "creditsUsed": 1
  }
}

Authorizations

​
Authorization
string
header
required

API key for Hiring 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
​
dateFrom
string<date>

Filter signals from this date (ISO 8601 format: YYYY-MM-DD)

​
dateTo
string<date>

Filter signals up to this date (ISO 8601 format: YYYY-MM-DD)

​
date_preset
enum<string>

Relative date shorthand. Takes precedence over dateFrom/dateTo.

Available options:
today,
yesterday,
last_7d,
last_14d,
last_30d,
last_60d,
last_90d,
last_6m,
last_1y,
last_2y,
this_week,
this_month,
this_quarter,
this_year,
last_week,
last_month,
last_quarter,
last_year
​
search
string

Free-text search across company name, industry, job title, location, and city

​
countries
string

Comma-separated list of country codes to filter by

​
states
string

Comma-separated US state codes to filter by

​
city
string

Free-text search on hiring signal city, location, and region

​
categories
string

Pipe-separated list of company industry categories to filter by

​
subcategories
string

Comma-separated list of subcategory IDs to filter by. These filter companies based on keyword patterns matching their industry, keywords, and specialties.

​
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.

​
team_size
string

Comma-separated team size ranges to filter by. Format: min-max (e.g., 1-10, 11-50, 51-200, 201-1000, 1000-plus).

​
applicants
string

Comma-separated applicant count ranges to filter by. Format: min-max (e.g., 0-25, 26-50, 51-100, 101-200, 201-plus).

​
sort_by
enum<string>
default:created_at

Field to sort by

Available options:
date_posted,
created_at,
title,
company_name,
location
​
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
count
enum<string>

If set to true, returns only the total count without data rows and without deducting credits.

Available options:
true

Response

Successful response with hiring signals

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
object[]
required

Array of hiring signal records

​
pagination
object
required
​
meta
object
required