Skip to main content
POST
/
api
/
v3
/
jobs-search
/
search
curl -X POST 'https://api.sentrion.ai/api/v3/jobs-search/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "jobs_locations": [
      {
        "country": "United States",
        "state": "California",
        "city": "San Francisco"
      }
    ],
    "department": ["Engineering", "Software Engineering"],
    "industry": ["Computer Software", "Internet"],
    "job_keywords": {
      "title": ["software engineer", "backend developer"],
      "description": ["python", "kubernetes"],
      "mode": "or"
    },
    "exclude_job_keywords": {
      "title": ["intern", "junior"],
      "mode": "or"
    },
    "job_type": ["Full Time", "Contract"],
    "seniority_level": ["Mid Level"],
    "is_remote": true,
    "salary_data_available": true,
    "exclude_duplicates": true,
    "limit": 50
  }'

{
  "success": true,
  "data": {
    "jobs": [
      {
        "Job Type": "Full Time",
        "Job Title": "Senior Software Engineer",
        "Apply URL": "https://careers.techcorp.com/apply/98765",
        "Post Date": "2026-03-15",
        "Valid Through": "2026-04-15",
        "City": "San Francisco",
        "Job Board": "Linkedin",
        "Job Description": "We are looking for a Senior Software Engineer to join our platform team.",
        "Country": "United States",
        "Company Name": "TechCorp Inc.",
        "State": "California",
        "Salary Offered": "$150,000 - $200,000/year",
        "Logo URL": "https://media.licdn.com/dms/image/C4D0BAQH/company-logo.png",
        "Is Remote": false,
        "Job URL": "https://www.linkedin.com/jobs/view/3847562910",
        "Department Name": ["Engineering"],
        "Seniority Level": "Mid Level",
        "Salary Currency": "USD",
        "Salary To": 200000.0,
        "Salary From": 150000.0,
        "Skills": ["Python", "Kubernetes", "AWS"]
      }
    ],
    "total": 1,
    "total_jobs_found": 2847,
    "credits_used": 1,
    "credits_remaining": 9998,
    "search_after": [1710500000000, 67890]
  },
  "error": null
}

Documentation Index

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

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

This endpoint requires special access. Please contact us to enable historical data on your API key.
Search up to 6 years of historical jobs across all companies without providing company identity inputs. Filter by location, department, industry, keywords, job type, seniority level, job board, salary availability, and more.

​
Authentication

This endpoint requires a Bearer token. Enter your API key in the authorization field above — the Bearer prefix is added automatically.

​
Request Body

​
Location Filters

​
jobs_locations
array
Filter jobs by location. Each item supports country, state, and city.
​
exclude_jobs_locations
array
Exclude jobs from specific locations. Uses the same location object shape as jobs_locations.
​
is_remote
boolean
Filter by remote status. true returns only remote jobs, false returns only non-remote jobs, and null includes both.
​
country_exists
boolean
Filter for jobs that include country information.

​
Date Filters

​
published_after
string
Start date for the search in YYYY-MM-DD format. If omitted, the API defaults this to 2 months before the request date. This value cannot be older than 6 years before the request date.
​
published_before
string
End date for the search in YYYY-MM-DD format. If omitted, the API defaults this to the day after the request date.

​
Job Filters

​
department
array
Filter by department.
​
industry
array
Filter by industry. Values are case-insensitive.
​
job_type
array
Filter by job type.
​
seniority_level
array
Filter by seniority level.
​
salary_data_available
boolean
default:"true"
Filter for jobs that include salary data.
​
is_agency
boolean
default:"true"
Include agency-posted jobs. Set to false to exclude them.

​
Keyword Filters

​
job_keywords
object
Keywords to search for in job titles and descriptions.
​
exclude_job_keywords
object
Keywords to exclude from job titles and descriptions.

​
Job Board Filters

​
job_boards
boolean
Filter by job board sources. true includes only jobs sourced from job boards, false excludes them, and null includes both job boards and direct company career pages.
​
include_job_boards
array
Only include results from specific job boards. Values are case-insensitive.
​
exclude_job_boards
array
Exclude results from specific job boards. Uses the same accepted values shown in include_job_boards.

​
Other Options

​
exclude_duplicates
boolean
default:"true"
Remove duplicate job listings from results.
​
limit
integer
default:"100"
Maximum number of results to return. Min: 10, Max: 100.
​
search_after
array
Pagination cursor from a previous response. Pass the array exactly as returned, in the form [timestamp, cursor_id].

​
Response

​
success
boolean
required
true if the search completed successfully.
​
data
object
The response payload. null when the request fails.
​
error
string
Error message when applicable. null for successful responses with results.
All job object fields may be null if the source posting did not contain that information.
curl -X POST 'https://api.sentrion.ai/api/v3/jobs-search/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "jobs_locations": [
      {
        "country": "United States",
        "state": "California",
        "city": "San Francisco"
      }
    ],
    "department": ["Engineering", "Software Engineering"],
    "industry": ["Computer Software", "Internet"],
    "job_keywords": {
      "title": ["software engineer", "backend developer"],
      "description": ["python", "kubernetes"],
      "mode": "or"
    },
    "exclude_job_keywords": {
      "title": ["intern", "junior"],
      "mode": "or"
    },
    "job_type": ["Full Time", "Contract"],
    "seniority_level": ["Mid Level"],
    "is_remote": true,
    "salary_data_available": true,
    "exclude_duplicates": true,
    "limit": 50
  }'

{
  "success": true,
  "data": {
    "jobs": [
      {
        "Job Type": "Full Time",
        "Job Title": "Senior Software Engineer",
        "Apply URL": "https://careers.techcorp.com/apply/98765",
        "Post Date": "2026-03-15",
        "Valid Through": "2026-04-15",
        "City": "San Francisco",
        "Job Board": "Linkedin",
        "Job Description": "We are looking for a Senior Software Engineer to join our platform team.",
        "Country": "United States",
        "Company Name": "TechCorp Inc.",
        "State": "California",
        "Salary Offered": "$150,000 - $200,000/year",
        "Logo URL": "https://media.licdn.com/dms/image/C4D0BAQH/company-logo.png",
        "Is Remote": false,
        "Job URL": "https://www.linkedin.com/jobs/view/3847562910",
        "Department Name": ["Engineering"],
        "Seniority Level": "Mid Level",
        "Salary Currency": "USD",
        "Salary To": 200000.0,
        "Salary From": 150000.0,
        "Skills": ["Python", "Kubernetes", "AWS"]
      }
    ],
    "total": 1,
    "total_jobs_found": 2847,
    "credits_used": 1,
    "credits_remaining": 9998,
    "search_after": [1710500000000, 67890]
  },
  "error": null
}

​
Pagination

This API uses search_after pagination.
1

Make the first request

Omit search_after or set it to null.
2

Read the cursor

If the response includes a non-null search_after array, more results are available.
3

Fetch the next page

Pass the returned search_after array into the next request unchanged.
4

Stop when complete

When search_after is null, you have reached the end of the result set.
import requests

def fetch_all_jobs(api_key):
    all_jobs = []
    search_after = None

    while True:
        response = requests.post(
            'https://api.sentrion.ai/api/v3/jobs-search/search',
            headers={'Authorization': f'Bearer {api_key}'},
            json={
                'jobs_locations': [{'country': 'United States'}],
                'limit': 100,
                'search_after': search_after
            }
        )

        payload = response.json()
        all_jobs.extend(payload['data']['jobs'])
        search_after = payload['data']['search_after']

        if not search_after:
            break

    return all_jobs

​
Rate Limits

This endpoint is rate-limited to 100 requests per minute per API key.

​
Constraints

  • published_after defaults to 2 months before the request date when omitted.
  • published_after cannot be older than 6 years before the request date.
  • published_before defaults to the day after the request date when omitted.
  • published_after must be earlier than published_before.
  • Credits are charged only for new jobs within the current billing cycle.