Company Jobs (Historical Since 2020)

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
    "company_name": "Stripe",
    "limit": 50
  }'

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
    "company_name": "Stripe",
    "jobs_locations": [
      { "country": "United States", "state": "California" }
    ],
    "department": ["Engineering", "Product Management"],
    "seniority_level": ["Mid Level", "Executive Level"],
    "job_keywords": {
      "title": ["Backend", "Infrastructure"],
      "mode": "or"
    },
    "job_type": ["Full Time"],
    "published_after": "2025-01-01",
    "limit": 100
  }'

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/google/",
    "include_job_boards": ["Linkedin"],
    "exclude_duplicates": true,
    "limit": 100
  }'

{
  "success": true,
  "data": {
    "company_details": {
      "company_name": "Stripe",
      "description": "Stripe is a financial infrastructure platform for businesses...",
      "industry": "Financial Services",
      "employee_data": {
        "headcount": 8232,
        "size_range": "5001-10000"
      },
      "website": "https://stripe.com",
      "linkedin_url": "https://www.linkedin.com/company/stripe",
      "locations": [
        {
          "city": "San Francisco",
          "state": "CA",
          "country": "us",
          "is_headquarters": true
        }
      ],
      "founded_date": { "year": 2010 },
      "tagline": "Help increase the GDP of the internet.",
      "specialties": ["Payments", "SaaS", "Fintech"]
    },
    "jobs": [
      {
        "Job Title": "Staff Backend Engineer",
        "Job Type": "Full Time",
        "Company Name": "Stripe",
        "City": "San Francisco",
        "State": "CA",
        "Country": "US",
        "Is Remote": false,
        "Post Date": "2025-03-15",
        "Valid Through": "2025-04-15",
        "Job URL": "https://www.linkedin.com/jobs/view/123456",
        "Apply URL": "https://stripe.com/jobs/listing/staff-backend-engineer",
        "Job Board": "Linkedin",
        "Logo URL": "https://media.licdn.com/.../stripe_logo.png",
        "Job Description": "We're looking for a Staff Backend Engineer...",
        "Department Name": ["Engineering"],
        "Seniority Level": "Executive Level",
        "Salary Offered": "$180,000 - $250,000",
        "Salary From": 180000,
        "Salary To": 250000,
        "Salary Currency": "USD",
        "Skills": ["Python", "Go", "Distributed Systems", "AWS"]
      }
    ],
    "total": 1,
    "total_jobs_found": 47,
    "credits_used": 2,
    "credits_remaining": 9998,
    "search_after": [1710460800000, 67890]
  },
  "error": null
}

{
  "detail": "company_linkedin_url is required."
}

{
  "detail": "The complete new-job result is unaffordable; no jobs were delivered or charged."
}

{
  "detail": "Invalid or inactive API key"
}

{
  "detail": "The operation key has changed request intent or its billing period has expired."
}

{
  "detail": "<error detail>"
}

{
  "detail": "Rate limit exceeded; retry after the indicated delay."
}

POST

api

company-jobs

historical

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
    "company_name": "Stripe",
    "limit": 50
  }'

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
    "company_name": "Stripe",
    "jobs_locations": [
      { "country": "United States", "state": "California" }
    ],
    "department": ["Engineering", "Product Management"],
    "seniority_level": ["Mid Level", "Executive Level"],
    "job_keywords": {
      "title": ["Backend", "Infrastructure"],
      "mode": "or"
    },
    "job_type": ["Full Time"],
    "published_after": "2025-01-01",
    "limit": 100
  }'

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/google/",
    "include_job_boards": ["Linkedin"],
    "exclude_duplicates": true,
    "limit": 100
  }'

{
  "success": true,
  "data": {
    "company_details": {
      "company_name": "Stripe",
      "description": "Stripe is a financial infrastructure platform for businesses...",
      "industry": "Financial Services",
      "employee_data": {
        "headcount": 8232,
        "size_range": "5001-10000"
      },
      "website": "https://stripe.com",
      "linkedin_url": "https://www.linkedin.com/company/stripe",
      "locations": [
        {
          "city": "San Francisco",
          "state": "CA",
          "country": "us",
          "is_headquarters": true
        }
      ],
      "founded_date": { "year": 2010 },
      "tagline": "Help increase the GDP of the internet.",
      "specialties": ["Payments", "SaaS", "Fintech"]
    },
    "jobs": [
      {
        "Job Title": "Staff Backend Engineer",
        "Job Type": "Full Time",
        "Company Name": "Stripe",
        "City": "San Francisco",
        "State": "CA",
        "Country": "US",
        "Is Remote": false,
        "Post Date": "2025-03-15",
        "Valid Through": "2025-04-15",
        "Job URL": "https://www.linkedin.com/jobs/view/123456",
        "Apply URL": "https://stripe.com/jobs/listing/staff-backend-engineer",
        "Job Board": "Linkedin",
        "Logo URL": "https://media.licdn.com/.../stripe_logo.png",
        "Job Description": "We're looking for a Staff Backend Engineer...",
        "Department Name": ["Engineering"],
        "Seniority Level": "Executive Level",
        "Salary Offered": "$180,000 - $250,000",
        "Salary From": 180000,
        "Salary To": 250000,
        "Salary Currency": "USD",
        "Skills": ["Python", "Go", "Distributed Systems", "AWS"]
      }
    ],
    "total": 1,
    "total_jobs_found": 47,
    "credits_used": 2,
    "credits_remaining": 9998,
    "search_after": [1710460800000, 67890]
  },
  "error": null
}

{
  "detail": "company_linkedin_url is required."
}

{
  "detail": "The complete new-job result is unaffordable; no jobs were delivered or charged."
}

{
  "detail": "Invalid or inactive API key"
}

{
  "detail": "The operation key has changed request intent or its billing period has expired."
}

{
  "detail": "<error detail>"
}

{
  "detail": "Rate limit exceeded; retry after the indicated delay."
}

Company Jobs (Historical)

Search historical job postings dating back to 2020 from a specific company by providing its LinkedIn URL. The API enriches the company profile from a 52M+ company database and returns matching jobs with full metadata.

Authentication

This endpoint requires an active API key. Historical access is included on every plan. Enter your API key in the authorization field above — the Bearer prefix is added automatically. New jobs cost two credits each; previously paid jobs and empty results are available at zero or negative balance.

Request Headers

string

Optional stable retry key for idempotent requests. Format: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.Reuse the same key and unchanged request body when retrying this endpoint. Generate a new key for a new search or page of results (search_after). Reusing a key with changed request intent or an expired billing period returns 409. See idempotency best practices.

"Idempotency-Key": "use_v1_0123456789abcdef0123456789abcdef"

Request Body

Company Identification

string

required

LinkedIn company profile URL. Must start with https://www.linkedin.com/company/ and include the company identifier.

"company_linkedin_url": "https://www.linkedin.com/company/stripe/"

string

Company name. Used alongside the LinkedIn URL for broader job matching. If enrichment returns additional name variants, they are combined automatically.

"company_name": "Stripe"

string

Company website domain. Currently used for enrichment context.

"company_domain": "stripe.com"

boolean

default:"false"

When true, uses fuzzy matching on the company name instead of exact match. Useful when the company name in job postings varies from the official name.

Location Filters

array

Filter jobs by location. Each item supports country, state, and city. Multiple locations use OR logic.

"jobs_locations": [
  { "country": "United States", "state": "California", "city": "San Francisco" },
  { "country": "United Kingdom" }
]

array

Exclude jobs from specific locations. Same structure as jobs_locations.

"exclude_jobs_locations": [
  { "country": "India" }
]

boolean

default:"null"

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

boolean

default:"null"

When true, only returns jobs that have country information available.

Date Filters

string

default:"rolling historical floor"

Start date for the job search in YYYY-MM-DD format. Use an explicit start date from 2020 onward to select your historical window. If omitted, the search starts at the earliest available historical date.

"published_after": "2025-01-01"

string

default:"current UTC time"

End date for the job search in YYYY-MM-DD format. Must be later than published_after.

"published_before": "2025-06-30"

Job Filters

array

Filter by department. Values are case-sensitive.

Show All 38 department values

Value
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

"department": ["Engineering", "Product Management"]

array

Filter by employment type.Possible values: Full Time, Part Time, Contract, Internship, Volunteer

"job_type": ["Full Time", "Contract"]

array

Filter by seniority level. ML-generated, available for English-language jobs.Possible values: Entry Level, Mid Level, Executive Level

"seniority_level": ["Mid Level", "Executive Level"]

Industry filtering is only supported by Jobs Search. Company Jobs ignores industry.

boolean

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

Keyword Filters

object

Keywords to search for in job titles and descriptions.

Show Properties

array

Keywords to match in job titles.

array

Keywords to match in job descriptions.

string

default:"and"

How the title block combines with the description block. "and" requires both, "or" requires either. Keywords within title or within description are always matched as “any of these” — use advanced_job_keywords below to require several words in the same field.

"job_keywords": {
  "title": ["Backend", "Engineer"],
  "description": ["Python", "AWS"],
  "mode": "and"
}

object

Keywords to exclude from results. Same structure as job_keywords.

"exclude_job_keywords": {
  "title": ["Intern", "Junior"],
  "mode": "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

default:"null"

true includes only jobs from job boards. false returns only company career page postings. null includes both.

array

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

"include_job_boards": ["Linkedin", "indeed"]

array

Exclude results from specific job boards. Values are case-insensitive.

"exclude_job_boards": ["glassdoor", "monster"]

Show All 222 job board sources

Linkedin, indeed, glassdoor, ziprecruiter, monster, dice, careerbuilder, careerjet, simplyhired, reed, totaljob, seek, USAjobs, Adzuna, Stackoverflow, remoteok, weworkremotely, dribbble, lever, wellfound, Jobstreet, careeronestop, eurojobs, Jobs, neuvoo, jobbank, EURES, Talent, poleemploi, practicelink, Theladders, Jobsintrucks, foundit, seamanjobsite, Jobsdb, Graduateland, nurse, linkup, careerone, itjobboard, workcenter, learn4good, computrabajo, kijiji, timesjobs, mycareersfuture, higheredjobs, Jobscentral, Jora, shine, Efinancialcareers, grabjobs, net-empregos, nationalevacaturebank, duunitori, Naukri, freshersworld, hosco, oilandgasjobsearch, retailjobsweb, ledigajobb, jobsinlisbon, arbeitsagentur, 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, Webbjobb, jobzilla, Bj, adzuna_com_au, Aspendentaljobs, Mudah, fastjobs, echinacities, Empregoxl, vic, secsinthecity, Iimjobs, naukri_com, hiredly, marocannonces, Educationweekjobs, Retailchoice, arbetsformedlingen, fashionjobs, Jobx, mommyjobsonlineaffiliates, Internshala, Workinnursingjobs, aussieemployment, Caterer, thefountaingroup, workatastartup, journalismjobs, Navalnuclearlab, transdevna, Jobthai, probonoaustralia, Workintheraphyjobs, ETSDental, Emprego, Fecareers, idealist_org, Goinhouse, grapevinejobs, lettucejobs, Chinahr, jobsdb_com, jobs_ca, Lkjordan, totalhire, hiredchina, pnet_co_za, appstack, remotive, jobx_com_au, foundationlist, daijob, hays, aimbridgehospitality_com, 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, empregosonline, buscojobs

Pagination & Limits

integer

default:"100"

Maximum number of jobs to return. Maximum: 100. We recommend 10–100 per page. Use search_after to request the next page.

array

Pagination cursor from a previous response. Pass the search_after value from the last response to fetch the next page.

"search_after": [1711929600000, 12345]

boolean

default:"true"

Remove duplicate job listings from results.

Response

boolean

true if the search completed successfully.

object

The search response payload. A failed search can still include a data object with empty results. Check success and error before using the results.

Show Properties

object

Enriched company profile data.

Show Properties

string

Official company name.

string

Company description / about text.

string

Industry classification.

object

Employee headcount information.

Show Properties

integer

Estimated employee count.

string

Size bucket (e.g., "1001-5000", "10001+").

string

Company website URL.

string

LinkedIn profile URL.

array

Company office locations.

Show Properties

string

City

string

State or region

string

Country code

boolean

Whether this is the HQ

object

Show Properties

integer

Year the company was founded.

string

Company tagline or slogan.

array

List of company specialties.

array

List of matching job objects.

Show Job object properties

string

Position title.

string

Employment type (e.g., Full Time, Contract).

string

Full job posting text.

string

Hiring company name.

string

Job location city.

string

Job location state or region.

string

Job location country.

boolean

Whether the job is remote.

string

Publication date in YYYY-MM-DD format.

string

Posting expiration date.

string

URL of the original job listing.

string

Direct link to the application page.

string

Source job board.

string

Company logo image URL.

array

Inferred department(s).

string

Inferred seniority level.

string

Raw salary text from the posting.

number

Lower bound of salary range.

number

Upper bound of salary range.

string

Currency code (e.g., USD, EUR).

array

Skills extracted from the job description.

integer

Number of jobs returned in this response.

integer

Total matching jobs across all pages.

integer

Credits consumed by this request.

integer

Credits remaining after this request.

array

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

string

A string message or null. An empty successful search may include an explanatory message; use success to determine whether the search failed.

Pagination

If the response contains a non-null search_after array, pass it in your next request to fetch more results:

{
  "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
  "limit": 100,
  "search_after": [1711929600000, 12345]
}

When search_after is null in the response, you have reached the last page.

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
    "company_name": "Stripe",
    "limit": 50
  }'

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
    "company_name": "Stripe",
    "jobs_locations": [
      { "country": "United States", "state": "California" }
    ],
    "department": ["Engineering", "Product Management"],
    "seniority_level": ["Mid Level", "Executive Level"],
    "job_keywords": {
      "title": ["Backend", "Infrastructure"],
      "mode": "or"
    },
    "job_type": ["Full Time"],
    "published_after": "2025-01-01",
    "limit": 100
  }'

curl -X POST https://api.sentrion.ai/api/v1/company-jobs/historical/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/google/",
    "include_job_boards": ["Linkedin"],
    "exclude_duplicates": true,
    "limit": 100
  }'

{
  "success": true,
  "data": {
    "company_details": {
      "company_name": "Stripe",
      "description": "Stripe is a financial infrastructure platform for businesses...",
      "industry": "Financial Services",
      "employee_data": {
        "headcount": 8232,
        "size_range": "5001-10000"
      },
      "website": "https://stripe.com",
      "linkedin_url": "https://www.linkedin.com/company/stripe",
      "locations": [
        {
          "city": "San Francisco",
          "state": "CA",
          "country": "us",
          "is_headquarters": true
        }
      ],
      "founded_date": { "year": 2010 },
      "tagline": "Help increase the GDP of the internet.",
      "specialties": ["Payments", "SaaS", "Fintech"]
    },
    "jobs": [
      {
        "Job Title": "Staff Backend Engineer",
        "Job Type": "Full Time",
        "Company Name": "Stripe",
        "City": "San Francisco",
        "State": "CA",
        "Country": "US",
        "Is Remote": false,
        "Post Date": "2025-03-15",
        "Valid Through": "2025-04-15",
        "Job URL": "https://www.linkedin.com/jobs/view/123456",
        "Apply URL": "https://stripe.com/jobs/listing/staff-backend-engineer",
        "Job Board": "Linkedin",
        "Logo URL": "https://media.licdn.com/.../stripe_logo.png",
        "Job Description": "We're looking for a Staff Backend Engineer...",
        "Department Name": ["Engineering"],
        "Seniority Level": "Executive Level",
        "Salary Offered": "$180,000 - $250,000",
        "Salary From": 180000,
        "Salary To": 250000,
        "Salary Currency": "USD",
        "Skills": ["Python", "Go", "Distributed Systems", "AWS"]
      }
    ],
    "total": 1,
    "total_jobs_found": 47,
    "credits_used": 2,
    "credits_remaining": 9998,
    "search_after": [1710460800000, 67890]
  },
  "error": null
}

{
  "detail": "company_linkedin_url is required."
}

{
  "detail": "The complete new-job result is unaffordable; no jobs were delivered or charged."
}

{
  "detail": "Invalid or inactive API key"
}

{
  "detail": "The operation key has changed request intent or its billing period has expired."
}

{
  "detail": "<error detail>"
}

{
  "detail": "Rate limit exceeded; retry after the indicated delay."
}

For the service_unavailable case, the search or service is temporarily unavailable and nothing was charged. Retry with the same Idempotency-Key. A 429 response means no jobs were delivered or charged. It includes Retry-After (seconds to wait), Idempotency-Key (the effective operation key), and X-Request-ID (a UUID for this HTTP attempt). Retry after the indicated delay with the same request body and idempotency key. Reuse a caller-supplied key to recover a lost response within the billing period.

Rate Limits

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

Overview

Endpoints

Historical (Since 2020)

Billing

Company Jobs (Historical Since 2020)

Company Jobs (Historical)

Authentication

Request Headers

Request Body

Company Identification

Location Filters

Date Filters

Job Filters

Keyword Filters

Job Board Filters

Response

Rate Limits

​Company Jobs (Historical)

​Authentication

​Request Headers

​Request Body

​Company Identification

​Location Filters

​Date Filters

​Job Filters

​Keyword Filters

​Job Board Filters

​Pagination & Limits

​Response

​Pagination

​Rate Limits

Company Jobs (Historical)

Authentication

Request Headers

Request Body

Company Identification

Location Filters

Date Filters

Job Filters

Keyword Filters

Job Board Filters

Pagination & Limits

Response

Pagination

Rate Limits