Welcome to the Hiring Signals API The Hiring Signals API provides timely insights on open job postings across the web. Track which companies are hiring, what roles they’re filling, and where — with precise filters for positions, departments, seniority levels, team size, applicant counts, and geographic targeting.
Hiring Signals Endpoint View the complete OpenAPI specification
Count Mode You can get the total number of results matching any filter combination without consuming credits by adding count=true to your request. This returns an empty data array with full pagination metadata, including totalCount.
curl -X GET "https://www.trysignalbase.com/api/v2/signals/hiring?count=true&positions=CTO&date_preset=last_30d" \ -H "Authorization: Bearer YOUR_API_KEY"
Response: { "success" : true , "data" : [], "pagination" : { "currentPage" : 1 , "totalPages" : 8 , "totalCount" : 156 , "hasNextPage" : true , "hasPreviousPage" : false }, "meta" : { "endpoint" : "signals.hiring" , "creditsUsed" : 0 } }
Use count mode to preview how many results match your filters before fetching actual data. This is useful for building filter UIs, showing result counts, or validating queries — all at zero credit cost.
Key Features
Real-time Signals : Hiring signals aggregated continuously from web sourcesRole-aware Filters : Filter by positions, departments, and seniority levelsLocation Targeting : Filter by country, US state, and cityCategory Filters : Filter by industry categories and keyword-based subcategoriesCompany Filters : Filter by team size and applicant count rangesFlexible Sorting : Sort by date posted, title, company name, location, or ingestion datePagination Support : Efficiently retrieve large datasets with up to 100 results per pageCredit-based Usage : Transparent credit consumption per API call
Service Level
Rate Limit : Based on your subscription tierUptime : 99% guaranteed uptimeData Freshness : Real-time aggregation ensures up-to-date signalsMaximum Results : Up to 100 results per page
Authentication All API endpoints require a Bearer token in the Authorization header.
curl -X GET "https://www.trysignalbase.com/api/v2/signals/hiring?page=1&limit=20" \ -H "Authorization: Bearer YOUR_API_KEY"
Query Parameters Parameter Type Default Description pageinteger 1 Page number limitinteger 20 Results per page (max: 100)
Date Filters Parameter Type Description dateFromstring Filter by date from (ISO-8601 string) dateTostring Filter by date to (ISO-8601 string) date_presetstring Relative date shorthand — takes precedence over dateFrom/dateTo. See Date Presets
Text Search & Location Parameter Type Description searchstring Free-text search across company name, industry, job title, location, and city citystring Free-text search on city, location, and region countriesstring Comma-separated country codes (e.g., US,GB,DE) statesstring Comma-separated US state codes (e.g., CA,NY,TX)
Category Filters Parameter Type Description categoriesstring Pipe-separated industry categories (e.g., Technology|Software) subcategoriesstring Comma-separated subcategory IDs (e.g., ai,fintech,saas)
Role Category Filters Parameter Type Description positionsstring Comma-separated position IDs (e.g., CEO,CTO,CFO). See Positions departmentsstring Comma-separated department IDs (e.g., marketing,engineering). See Departments senioritiesstring Comma-separated seniority IDs (e.g., c_level,vp,director). See Seniorities
Company Filters Parameter Type Description team_sizestring Comma-separated team size ranges (e.g., 1-10,11-50,51-200,201-1000,1000-plus) applicantsstring Comma-separated applicant ranges (e.g., 0-25,26-50,51-100,101-200,201-plus)
Sorting Parameter Type Default Description sort_bystring created_atSort field: date_posted, created_at, title, company_name, location sort_orderstring descSort direction: asc or desc
Response Structure All successful responses follow this structure:
{ "success" : true , "data" : [ { "id" : "uuid-here" , "title" : "Senior Software Engineer" , "jobUrl" : "https://www.linkedin.com/jobs/view/123456789" , "location" : "San Francisco, CA" , "city" : "San Francisco" , "country" : "US" , "datePosted" : "2024-11-01T00:00:00Z" , "employmentType" : "Full-time" , "seniorityLevel" : "Mid-Senior level" , "jobFunction" : "Engineering" , "numApplicants" : "45" , "companyName" : "NextGen Software" , "companyIndustry" : "Technology" , "companyEmployeeCount" : 250 } ], "pagination" : { "currentPage" : 1 , "totalPages" : 50 , "totalCount" : 1000 , "hasNextPage" : true , "hasPreviousPage" : false }, "meta" : { "endpoint" : "signals.hiring" , "creditsUsed" : 1 } }
Error Handling The API returns standard HTTP status codes:
200 : Success401 : Unauthorized - Invalid or missing API key429 : Rate limit exceeded500 : Internal server error
Error responses include:
{ "success" : false , "error" : "Error message description" }
Example Usage Filter by Position and Date Preset curl -X GET "https://www.trysignalbase.com/api/v2/signals/hiring?date_preset=last_30d&positions=CTO" \ -H "Authorization: Bearer YOUR_API_KEY"
Filter by Country and City curl -X GET "https://www.trysignalbase.com/api/v2/signals/hiring?countries=US&city=San%20Francisco" \ -H "Authorization: Bearer YOUR_API_KEY"
Filter by Department and Seniority with Sorting curl -X GET "https://www.trysignalbase.com/api/v2/signals/hiring?departments=engineering&seniorities=c_level&sort_by=date_posted&sort_order=desc" \ -H "Authorization: Bearer YOUR_API_KEY"
Filter by Team Size and Subcategory curl -X GET "https://www.trysignalbase.com/api/v2/signals/hiring?team_size=51-200&subcategories=ai,saas&date_preset=last_90d" \ -H "Authorization: Bearer YOUR_API_KEY"
