Jobs Search (6 Years Historical)

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
  }'

import requests

response = requests.post(
    'https://api.sentrion.ai/api/v3/jobs-search/search',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        '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
    }
)

data = response.json()

const response = await fetch('https://api.sentrion.ai/api/v3/jobs-search/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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
  })
});

const data = await response.json();

{
  "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
}

{
  "success": true,
  "data": {
    "jobs": [],
    "total": 0,
    "total_jobs_found": 0,
    "credits_used": 0,
    "credits_remaining": 10000,
    "search_after": null
  },
  "error": "No jobs found matching criteria."
}

{
  "detail": [
    {
      "msg": "published_after cannot be older than 6 months",
      "type": "value_error"
    }
  ]
}

POST

api

jobs-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
  }'

import requests

response = requests.post(
    'https://api.sentrion.ai/api/v3/jobs-search/search',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        '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
    }
)

data = response.json()

const response = await fetch('https://api.sentrion.ai/api/v3/jobs-search/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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
  })
});

const data = await response.json();

{
  "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
}

{
  "success": true,
  "data": {
    "jobs": [],
    "total": 0,
    "total_jobs_found": 0,
    "credits_used": 0,
    "credits_remaining": 10000,
    "search_after": null
  },
  "error": "No jobs found matching criteria."
}

{
  "detail": [
    {
      "msg": "published_after cannot be older than 6 months",
      "type": "value_error"
    }
  ]
}

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

array

Filter jobs by location. Each item supports country, state, and city.

Show Location object properties

string

Country name, such as United States or Germany.

string

State, province, or region, such as California or Bavaria.

string

City name, such as San Francisco or London.

array

Exclude jobs from specific locations. Uses the same location object shape as jobs_locations.

Show Location object properties

string

Country name, such as United States or Germany.

string

State, province, or region, such as Texas or Ontario.

string

City name, such as Austin or Toronto.

boolean

Filter by remote status. true returns only remote jobs, false returns only non-remote jobs, and null includes both.

boolean

Filter for jobs that include country information.

Date Filters

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.

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

array

Filter by department.

Show Accepted values

Accounting
Administration
Arts and Design
Business Development
Communications
Community and Social Services
Compliance
Corporate Affairs
Corporate Strategy
Customer Experience
Customer Success
Customer Support
Data Analytics
Design
Education
Engineering
Facilities Management
Finance
Government Relations
Healthcare Services
Human Resources
Information Technology
Legal
Marketing
Operations
Product Management
Project Management
Public Relations
Purchasing
Quality Assurance
Real Estate
Research
Sales
Security
Software Engineering
Supply Chain
Support
Web Development

array

Filter by industry. Values are case-insensitive.

Show Accepted values

Accounting
Airlines/Aviation
Alternative Dispute Resolution
Alternative Medicine
Animation
Apparel & Fashion
Architecture & Planning
Arts and Crafts
Automotive
Aviation & Aerospace
Banking
Biotechnology
Broadcast Media
Building Materials
Business Supplies and Equipment
Capital Markets
Chemicals
Civic & Social Organization
Civil Engineering
Commercial Real Estate
Computer & Network Security
Computer Games
Computer Hardware
Computer Networking
Computer Software
Construction
Consumer Electronics
Consumer Goods
Consumer Services
Cosmetics
Dairy
Defense & Space
Design
E-Learning
Education Management
Electrical/Electronic Manufacturing
Entertainment
Environmental Services
Events Services
Executive Office
Facilities Services
Farming
Financial Services
Fine Art
Fishery
Food & Beverages
Food Production
Fund-Raising
Furniture
Gambling & Casinos
Glass, Ceramics & Concrete
Government Administration
Government Relations
Graphic Design
Health, Wellness and Fitness
Higher Education
Hospital & Health Care
Hospitality
Human Resources
Import and Export
Individual & Family Services
Industrial Automation
Information Services
Information Technology and Services
Insurance
International Affairs
International Trade and Development
Internet
Investment Banking
Investment Management
Judiciary
Law Enforcement
Law Practice
Legal Services
Legislative Office
Leisure, Travel & Tourism
Libraries
Logistics and Supply Chain
Luxury Goods & Jewelry
Machinery
Management Consulting
Maritime
Market Research
Marketing and Advertising
Mechanical or Industrial Engineering
Media Production
Medical Devices
Medical Practice
Mental Health Care
Military
Mining & Metals
Mobile Games
Motion Pictures and Film
Museums and Institutions
Music
Nanotechnology
Newspapers
Nonprofit Organization Management
Oil & Energy
Online Media
Outsourcing/Offshoring
Package/Freight Delivery
Packaging and Containers
Paper & Forest Products
Performing Arts
Pharmaceuticals
Philanthropy
Photography
Plastics
Political Organization
Primary/Secondary Education
Printing
Professional Training & Coaching
Program Development
Public Policy
Public Relations and Communications
Public Safety
Publishing
Railroad Manufacture
Ranching
Real Estate
Recreational Facilities and Services
Renewables & Environment
Research
Restaurants
Retail
Security and Investigations
Semiconductors
Shipbuilding
Software Development
Sporting Goods
Sports
Staffing and Recruiting
Supermarkets
Telecommunications
Textiles
Think Tanks
Tobacco
Translation and Localization
Transportation/Trucking/Railroad
Utilities
Venture Capital & Private Equity
Veterinary
Warehousing
Wholesale
Wine and Spirits
Wireless
Writing and Editing
Religious Institutions

array

Filter by job type.

Show Accepted values

Full Time
Part Time
Contract
Internship
Volunteer

array

Filter by seniority level.

Show Accepted values

Entry Level
Mid Level
Executive Level

boolean

Set true to return only jobs that include salary data. false, omitted or null: no salary filter — all jobs are returned.

boolean

Recruiting-agency filter. false: exclude jobs posted by known recruiting agencies — jobs from unclassified employers are kept. true: return only agency-posted jobs. Omitted or null: no filter.

Keyword Filters

object

Keywords to search for in job titles and descriptions.

Show Job keywords object properties

array

Keywords to match in job titles.

array

Keywords to match in job descriptions.

string

default:"and"

Match behavior for the keyword arrays.

Show Accepted values

and
or

object

Keywords to exclude from job titles and descriptions.

Show Exclude keywords object properties

array

Keywords to exclude from job titles.

array

Keywords to exclude from job descriptions.

string

default:"and"

Exclusion behavior for the keyword arrays.

Show Accepted values

and
or

array

Bracketed keyword logic, for queries job_keywords cannot express: requiring two separate words in the same job title, or matching several role profiles in one call.Each item is a group. A group combines its title block, its description block and any nested groups using its own mode. Every group in the top-level array must match, so the array itself behaves as an AND.

Show Group properties

string

default:"and"

How to combine this group’s title block, description block and nested groups.

object

{ "mode": "and" | "or", "terms": [...] }, applied to job titles.

object

{ "mode": "and" | "or", "terms": [...] }, applied to job descriptions.

array

Nested groups, for deeper bracketing.

Require both words in the title, and either technology in the description:

"advanced_job_keywords": [
  {
    "mode": "and",
    "title": { "mode": "and", "terms": ["Senior", "Engineer"] },
    "description": { "mode": "or", "terms": ["Python", "Go"] }
  }
]

Match either of two role profiles in a single call:

"advanced_job_keywords": [
  {
    "mode": "or",
    "groups": [
      {
        "mode": "and",
        "title": { "mode": "and", "terms": ["Senior", "Backend"] },
        "description": { "mode": "or", "terms": ["Python", "Go", "Java"] }
      },
      {
        "mode": "and",
        "title": { "mode": "and", "terms": ["Frontend", "Architect"] },
        "description": { "mode": "or", "terms": ["React", "Vue", "Angular"] }
      }
    ]
  }
]

array

The same structure, applied as an exclusion. Jobs matching a group are removed from the results.

"advanced_exclude_job_keywords": [
  {
    "mode": "or",
    "title": { "mode": "or", "terms": ["Intern", "Junior", "Entry Level"] }
  }
]

A group describes a set of jobs to remove, so its mode applies before the removal. With "mode": "and" the group removes only jobs matching every condition in it: {"mode": "and", "title": {"mode": "and", "terms": ["Intern", "Junior"]}} removes titles containing both words and keeps “Junior Engineer”. To drop jobs matching any of the terms, use "mode": "or" as in the example above.

Job Board Filters

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.

array

Only include results from specific job boards. Values are case-insensitive.

Show Accepted values

Jobstreet
careeronestop
Linkedin
indeed
careerbuilder
careerjet
eurojobs
glassdoor
simplyhired
Jobs
monster
neuvoo
jobbank
EURES
Talent
poleemploi
practicelink
Theladders
Jobsintrucks
dice
foundit
seamanjobsite
Jobsdb
Graduateland
nurse
Adzuna
linkup
careerone
itjobboard
workcenter
seek
learn4good
computrabajo
kijiji
timesjobs
mycareersfuture
higheredjobs
Jobscentral
Jora
shine
Efinancialcareers
grabjobs
ziprecruiter
USAjobs
net-empregos
nationalevacaturebank
duunitori
Naukri
freshersworld
hosco
oilandgasjobsearch
retailjobsweb
ledigajobb
jobsinlisbon
arbeitsagentur
reed
totaljob
Hospitalityonline
catho
hirist
jobbsafari
clearancejobs
Trademe
Wayup
jobsearch
Governmentjobs
bayt
Pnet
careercross
clearedjobs
XING
naukrigulf
technojobs
hotelcareer
gumtree
alertaemprego
internships
Hospitalrecruiting
liepin
zhaopin
Careerrookie
Miracleworkers
careervault
Jobbkk
tecoloco
Moneyjobs
jobaline
Aimbridgehospitality
wuzzuf
gulftalent
brightermonday
Sologig
Idealist
cwjobs
Lavoraconnoi
jobberman
Jobtopgun
Fejobs
seasonaljobs
workinstartups
NRF
Cvmarket
monstergulf
ssmhealthcareers
behance
bumeran
jooble
workinretail
remoteok
Webbjobb
jobzilla
Bj
adzuna_com_au
Aspendentaljobs
Mudah
fastjobs
echinacities
Empregoxl
vic
secsinthecity
Iimjobs
naukri_com
hiredly
marocannonces
Stackoverflow
Educationweekjobs
Retailchoice
arbetsformedlingen
fashionjobs
Jobx
mommyjobsonlineaffiliates
Internshala
Workinnursingjobs
aussieemployment
Caterer
thefountaingroup
workatastartup
journalismjobs
Navalnuclearlab
transdevna
Jobthai
probonoaustralia
Workintheraphyjobs
ETSDental
Emprego
Fecareers
dribbble
idealist_org
Goinhouse
grapevinejobs
lettucejobs
Chinahr
weworkremotely
jobsdb_com
jobs_ca
Lkjordan
totalhire
hiredchina
pnet_co_za
appstack
remotive
jobx_com_au
foundationlist
daijob
hays
aimbridgehospitality_com
carga de trabalhos
bonsempregos
specialcounsel
turnerindustriesapplicantpro
Sportspeople
euremotejobs
Headhunter
appvault
localwise
Thorindustries
boards.greenhouse.io
Eecentre
skillinvest
retailchoice_com
Wdhs
Landing
Awarding
Care
sarkariresult
whcg
moneyjobs_com
JOBITT
apaservices
homefromcollege
headagent
vrs
expatjobschina
jobs_de
Ercjobs
ngshire
wsetglobal
miracleworkers_com
digitalenta
hrcc
sologig_com
sthgrampians
amesystems
careerrookie_com
eghs
care_com
lkjordan_com
beyondretail
ararat
awarding_org
ercjobs_com
workinnursingjobs_com
beekeeper
headhunter_com
workintheraphyjobs_com
Boards
navalnuclearlab_energy_gov
lever
empregosonline
buscojobs

array

Exclude results from specific job boards. Uses the same accepted values shown in include_job_boards.

Other Options

boolean

default:"true"

Remove duplicate job listings from results.

integer

default:"100"

Maximum number of results to return. Min: 10, Max: 100.

array

Pagination cursor from a previous response. Pass the array exactly as returned, in the form [timestamp, cursor_id].

Response

boolean

required

true if the search completed successfully.

object

The response payload. null when the request fails.

Show Data object properties

array

required

List of job objects that match the request.

Show Job object properties

string

Type of employment, such as Full Time or Contract.

string

Title of the job posting.

string

Direct link to the job application page.

string

Date the job was posted in YYYY-MM-DD format.

string

Expiration date of the posting, if available.

string

City where the job is located.

string

Source job board for the posting.

string

Full description of the job.

string

Country where the job is located.

string

Name of the hiring company.

string

State, province, or region where the job is located.

string

Salary information exactly as listed in the posting.

string

URL of the company logo image.

boolean

Whether the job is remote.

string

URL of the original job listing.

array

Inferred department values for the job.

string

Inferred seniority level for the job.

string

Salary currency code, such as USD or EUR.

number

Upper bound of the salary range.

number

Lower bound of the salary range.

array

Skills extracted from the job description.

integer

required

Number of jobs returned in this response.

integer

required

Total number of jobs matching the criteria.

integer

required

Credits consumed by this request.

integer

Remaining credits for the API key.

array

Pagination cursor for the next page. null when there are no more results.

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
  }'

import requests

response = requests.post(
    'https://api.sentrion.ai/api/v3/jobs-search/search',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        '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
    }
)

data = response.json()

const response = await fetch('https://api.sentrion.ai/api/v3/jobs-search/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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
  })
});

const data = await response.json();

{
  "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
}

{
  "success": true,
  "data": {
    "jobs": [],
    "total": 0,
    "total_jobs_found": 0,
    "credits_used": 0,
    "credits_remaining": 10000,
    "search_after": null
  },
  "error": "No jobs found matching criteria."
}

{
  "detail": [
    {
      "msg": "published_after cannot be older than 6 months",
      "type": "value_error"
    }
  ]
}

Pagination

This API uses search_after pagination.

Make the first request

Omit search_after or set it to null.

Read the cursor

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

Fetch the next page

Pass the returned search_after array into the next request unchanged.

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

async function fetchAllJobs(apiKey) {
  const allJobs = [];
  let searchAfter = null;

  while (true) {
    const response = await fetch('https://api.sentrion.ai/api/v3/jobs-search/search', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        jobs_locations: [{ country: 'United States' }],
        limit: 100,
        search_after: searchAfter
      })
    });

    const payload = await response.json();
    allJobs.push(...payload.data.jobs);
    searchAfter = payload.data.search_after;

    if (!searchAfter) {
      break;
    }
  }

  return allJobs;
}

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.

Overview

Endpoints

Historical (6 Years)

Legacy

Jobs Search (6 Years Historical)

Authentication

Request Body

Location Filters

Date Filters

Job Filters

Keyword Filters

Job Board Filters

Other Options

Response

Rate Limits

Constraints

​Authentication

​Request Body

​Location Filters

​Date Filters

​Job Filters

​Keyword Filters

​Job Board Filters

​Other Options

​Response

​Pagination

​Rate Limits

​Constraints

Authentication

Request Body

Location Filters

Date Filters

Job Filters

Keyword Filters

Job Board Filters

Other Options

Response

Pagination

Rate Limits

Constraints