Company Jobs (Legacy)

curl -X POST 'https://api.sentrion.ai/api/v1/search/company-jobs' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "Apple",
    "company_domain": "apple.com",
    "jobs_locations": [
      {
        "country": "United States",
        "state": "California",
        "city": "Cupertino"
      }
    ],
    "department": ["Engineering"],
    "job_keywords": {
      "title": ["Engineer"],
      "mode": "or"
    },
    "seniority_level": ["Mid Level"],
    "limit": 50
  }'

{
  "success": true,
  "data": {
    "company_details": {
      "company_name": "Apple",
      "description": "We're a diverse collective of thinkers and doers...",
      "industry": "Computers and Electronics Manufacturing",
      "employee_data": {
        "headcount": 170873,
        "size_range": null
      },
      "website": "http://www.apple.com/careers",
      "linkedin_url": "https://www.linkedin.com/company/apple/",
      "locations": [
        {
          "address_line1": "1 Apple Park Way",
          "city": "Cupertino",
          "state": "California",
          "country": "US",
          "is_headquarters": true
        }
      ],
      "founded_date": {
        "year": 1976
      },
      "specialties": [
        "Innovative Product Development",
        "World-Class Operations"
      ]
    },
    "jobs": [
      {
        "Job Type": "Full Time",
        "Job Title": "Analog/Mixed-Signal IC Design Engineer",
        "Apply URL": null,
        "Post Date": "2025-04-01",
        "City": "San Diego",
        "Job Board": "Theladders",
        "Job Description": "Summary At Apple, we work every day...",
        "Country": "US",
        "Company Name": "Apple",
        "State": "CA",
        "Is Remote": false,
        "Job URL": "https://www.theladders.com/job/...",
        "Department Name": ["Engineering"],
        "Seniority Level": "Entry Level",
        "Skills": ["Signal Processing", "Design Reviews"]
      }
    ],
    "total": 1,
    "total_jobs_found": 1,
    "credits_used": 1,
    "credits_remaining": 999,
    "next_cursor": "some_opaque_cursor_string"
  },
  "error": null
}

POST

api

company-jobs

curl -X POST 'https://api.sentrion.ai/api/v1/search/company-jobs' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "Apple",
    "company_domain": "apple.com",
    "jobs_locations": [
      {
        "country": "United States",
        "state": "California",
        "city": "Cupertino"
      }
    ],
    "department": ["Engineering"],
    "job_keywords": {
      "title": ["Engineer"],
      "mode": "or"
    },
    "seniority_level": ["Mid Level"],
    "limit": 50
  }'

{
  "success": true,
  "data": {
    "company_details": {
      "company_name": "Apple",
      "description": "We're a diverse collective of thinkers and doers...",
      "industry": "Computers and Electronics Manufacturing",
      "employee_data": {
        "headcount": 170873,
        "size_range": null
      },
      "website": "http://www.apple.com/careers",
      "linkedin_url": "https://www.linkedin.com/company/apple/",
      "locations": [
        {
          "address_line1": "1 Apple Park Way",
          "city": "Cupertino",
          "state": "California",
          "country": "US",
          "is_headquarters": true
        }
      ],
      "founded_date": {
        "year": 1976
      },
      "specialties": [
        "Innovative Product Development",
        "World-Class Operations"
      ]
    },
    "jobs": [
      {
        "Job Type": "Full Time",
        "Job Title": "Analog/Mixed-Signal IC Design Engineer",
        "Apply URL": null,
        "Post Date": "2025-04-01",
        "City": "San Diego",
        "Job Board": "Theladders",
        "Job Description": "Summary At Apple, we work every day...",
        "Country": "US",
        "Company Name": "Apple",
        "State": "CA",
        "Is Remote": false,
        "Job URL": "https://www.theladders.com/job/...",
        "Department Name": ["Engineering"],
        "Seniority Level": "Entry Level",
        "Skills": ["Signal Processing", "Design Reviews"]
      }
    ],
    "total": 1,
    "total_jobs_found": 1,
    "credits_used": 1,
    "credits_remaining": 999,
    "next_cursor": "some_opaque_cursor_string"
  },
  "error": null
}

This endpoint is deprecated. Use the new Company Jobs endpoint (POST /api/v1/company-jobs/search) instead, which adds industry filters, location exclusions, salary filters, and enriched company details.

Search for job postings from specific companies. Filter results by location, department, seniority level, keywords, 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

You must provide at least one of company_name, company_domain, or company_linkedin_url to identify the target company.

Company Identification

company_name

string

The name of the company to search for.

company_domain

string

The company’s website domain (e.g., apple.com).

company_linkedin_url

string

The company’s LinkedIn profile URL.

company_broad_search

boolean

default:"false"

If true, performs a broader, less exact search for the company name.

Location Filters

jobs_locations

array

A list of location objects to filter jobs by.

Show Location Object Properties

country

string

The country (e.g., United States).

state

string

The state or province (e.g., California).

city

string

The city (e.g., Cupertino).

is_remote

boolean

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

Date Filters

published_after

string

Start date for the job search in YYYY-MM-DD format.

published_before

string

End date for the job search in YYYY-MM-DD format.

Job Filters

department

array

Filter by department. Example: ["Engineering", "Product Management"]

job_type

array

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

seniority_level

array

Filter by seniority level. Possible values: Entry Level, Mid Level, Executive Level.

Keyword Filters

job_keywords

object

Keywords to search for in job titles and descriptions.

Show Job Keywords Object Properties

title

array

Search terms for the job title.

description

array

Search terms for the job description.

mode

string

default:"and"

Logic mode: and (all terms must match) or or (any term can match).

exclude_job_keywords

object

Keywords to exclude from job titles and descriptions.

Show Exclude Keywords Object Properties

title

array

Keywords to exclude from job titles.

description

array

Keywords to exclude from job descriptions.

mode

string

default:"and"

Exclusion mode: and (exclude if all terms present) or or (exclude if any term present).

Job Board Filters

job_boards

boolean

Filter by job boards. true includes only job board results, false excludes them, null includes both.

include_job_boards

array

List of job board names to include in search results.

exclude_job_boards

array

List of job board names to exclude from search results.

Other Options

exclude_duplicates

boolean

default:"true"

If false, includes duplicate job postings.

is_agency

boolean

default:"true"

If false, excludes jobs from recruitment agencies.

limit

integer

default:"100"

The number of results to return. Min: 1, Max: 500.

next_cursor

string

The cursor for fetching the next page of results. See Pagination.

Response

success

boolean

required

true for successful requests, false for failed requests.

data

object

The response data wrapper. null if success is false.

Show Data Object Properties

company_details

object

Detailed information about the company.

Show Company Details Properties

company_name

string

The official name of the company.

description

string

Company description or about section.

industry

string

The industry the company operates in.

employee_data

object

Information about company size.

Show Employee Data Properties

headcount

integer

Exact number of employees.

size_range

string

Employee count range (e.g., “1001-5000”).

website

string

Company website URL.

linkedin_url

string

Company LinkedIn profile URL.

locations

array

List of company locations.

founded_date

object

When the company was founded.

specialties

array

List of company specialties.

jobs

array

required

List of job objects matching the criteria.

Show Job Object Properties

Job Title

string

The title of the job.

Job Type

string

The type of job (e.g., Full Time, Contract).

Job Description

string

The full description of the job.

Company Name

string

The name of the hiring company.

City

string

The city where the job is located.

State

string

The state or province.

Country

string

The country.

Is Remote

boolean

Whether the job is remote.

Post Date

string

The date the job was posted (YYYY-MM-DD).

Valid Through

string

The date the job posting expires.

Job URL

string

URL to the original job posting.

Apply URL

string

Direct URL to apply for the job.

Job Board

string

The source job board.

Department Name

array

Department(s) for the job.

Seniority Level

string

Seniority level of the position.

Salary Offered

string

Salary information as a raw string.

Salary From

float

Lower bound of the salary range.

Salary To

float

Upper bound of the salary range.

Salary Currency

string

Currency of the salary (e.g., USD).

Skills

array

List of skills inferred from the description.

Logo URL

string

URL to the company’s logo.

total

integer

required

Number of jobs returned in this response.

total_jobs_found

integer

required

Total number of jobs found for the entire query.

credits_used

integer

required

Number of credits used for this request.

credits_remaining

integer

required

Remaining credits for the API key.

next_cursor

string

Cursor for the next page. null if this is the last page.

error

object

Error details. null if success is true.

Show Error Object Properties

code

string

Error code identifying the type of error.

message

string

Human-readable error message.

details

array

Additional validation error details.

curl -X POST 'https://api.sentrion.ai/api/v1/search/company-jobs' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "Apple",
    "company_domain": "apple.com",
    "jobs_locations": [
      {
        "country": "United States",
        "state": "California",
        "city": "Cupertino"
      }
    ],
    "department": ["Engineering"],
    "job_keywords": {
      "title": ["Engineer"],
      "mode": "or"
    },
    "seniority_level": ["Mid Level"],
    "limit": 50
  }'

{
  "success": true,
  "data": {
    "company_details": {
      "company_name": "Apple",
      "description": "We're a diverse collective of thinkers and doers...",
      "industry": "Computers and Electronics Manufacturing",
      "employee_data": {
        "headcount": 170873,
        "size_range": null
      },
      "website": "http://www.apple.com/careers",
      "linkedin_url": "https://www.linkedin.com/company/apple/",
      "locations": [
        {
          "address_line1": "1 Apple Park Way",
          "city": "Cupertino",
          "state": "California",
          "country": "US",
          "is_headquarters": true
        }
      ],
      "founded_date": {
        "year": 1976
      },
      "specialties": [
        "Innovative Product Development",
        "World-Class Operations"
      ]
    },
    "jobs": [
      {
        "Job Type": "Full Time",
        "Job Title": "Analog/Mixed-Signal IC Design Engineer",
        "Apply URL": null,
        "Post Date": "2025-04-01",
        "City": "San Diego",
        "Job Board": "Theladders",
        "Job Description": "Summary At Apple, we work every day...",
        "Country": "US",
        "Company Name": "Apple",
        "State": "CA",
        "Is Remote": false,
        "Job URL": "https://www.theladders.com/job/...",
        "Department Name": ["Engineering"],
        "Seniority Level": "Entry Level",
        "Skills": ["Signal Processing", "Design Reviews"]
      }
    ],
    "total": 1,
    "total_jobs_found": 1,
    "credits_used": 1,
    "credits_remaining": 999,
    "next_cursor": "some_opaque_cursor_string"
  },
  "error": null
}

Pagination

This API uses cursor-based pagination to navigate through large result sets.

Make your first request

Make your initial request with next_cursor set to null or omitted.

Check for more results

If the response contains a non-null next_cursor string, more results are available.

Fetch the next page

Use the next_cursor value from the previous response in your next request to fetch the subsequent page.

Continue until complete

When next_cursor is null in the response, you have reached the end of the results.

import requests

def fetch_all_jobs(company_name, api_key):
    all_jobs = []
    cursor = None
    
    while True:
        response = requests.post(
            'https://api.sentrion.ai/api/v1/search/company-jobs',
            headers={'Authorization': f'Bearer {api_key}'},
            json={
                'company_name': company_name,
                'limit': 100,
                'next_cursor': cursor
            }
        )
        
        data = response.json()
        all_jobs.extend(data['data']['jobs'])
        
        cursor = data['data']['next_cursor']
        if cursor is None:
            break
    
    return all_jobs

Jobs Search (6 Years Historical)

Documentation Index

​Authentication

​Request Body

​Company Identification

​Location Filters

​Date Filters

​Job Filters

​Keyword Filters

​Job Board Filters

​Other Options

​Response

​Pagination

Authentication

Request Body

Company Identification

Location Filters

Date Filters

Job Filters

Keyword Filters

Job Board Filters

Other Options

Response

Pagination