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

import requests

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

data = response.json()

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

const data = await response.json();

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

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "Input validation failed",
    "details": [
      {
        "loc": ["body", "limit"],
        "msg": "Input should be less than or equal to 500",
        "type": "less_than_equal"
      }
    ]
  }
}

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

import requests

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

data = response.json()

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

const data = await response.json();

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

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "Input validation failed",
    "details": [
      {
        "loc": ["body", "limit"],
        "msg": "Input should be less than or equal to 500",
        "type": "less_than_equal"
      }
    ]
  }
}

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.

advanced_job_keywords and advanced_exclude_job_keywords are not supported here and now return 400.They were previously accepted on this endpoint and discarded before the search ran, which returned a wider result set than requested and billed for it. Use them on Company Jobs or Jobs Search.

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

string

The name of the company to search for.

string

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

string

The company’s LinkedIn profile URL.

boolean

default:"false"

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

Location Filters

array

A list of location objects to filter jobs by.

Show Location Object Properties

string

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

string

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

string

The city (e.g., Cupertino).

boolean

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

Date Filters

string

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

string

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

Job Filters

array

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

array

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

array

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

Keyword Filters

object

Keywords to search for in job titles and descriptions.

Show Job Keywords Object Properties

array

Search terms for the job title.

array

Search terms for the job description.

string

default:"and"

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

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 mode: and (exclude if all terms present) or or (exclude if any term present).

Job Board Filters

boolean

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

array

List of job board names to include in search results.

array

List of job board names to exclude from search results.

Other Options

boolean

default:"true"

If false, includes duplicate job postings.

integer

default:"100"

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

string

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

Response

boolean

required

true for successful requests, false for failed requests.

object

The response data wrapper. null if success is false.

Show Data Object Properties

object

Detailed information about the company.

Show Company Details Properties

string

The official name of the company.

string

Company description or about section.

string

The industry the company operates in.

object

Information about company size.

Show Employee Data Properties

integer

Exact number of employees.

string

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

string

Company website URL.

string

Company LinkedIn profile URL.

array

List of company locations.

object

When the company was founded.

array

List of company specialties.

array

required

List of job objects matching the criteria.

Show Job Object Properties

string

The title of the job.

string

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

string

The full description of the job.

string

The name of the hiring company.

string

The city where the job is located.

string

The state or province.

string

The country.

boolean

Whether the job is remote.

string

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

string

The date the job posting expires.

string

URL to the original job posting.

string

Direct URL to apply for the job.

string

The source job board.

array

Department(s) for the job.

string

Seniority level of the position.

string

Salary information as a raw string.

float

Lower bound of the salary range.

float

Upper bound of the salary range.

string

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

array

List of skills inferred from the description.

string

URL to the company’s logo.

integer

required

Number of jobs returned in this response.

integer

required

Total number of jobs found for the entire query.

integer

required

Number of credits used for this request.

integer

required

Remaining credits for the API key.

string

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

object

Error details. null if success is true.

Show Error Object Properties

string

Error code identifying the type of error.

string

Human-readable error message.

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

import requests

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

data = response.json()

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

const data = await response.json();

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

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "Input validation failed",
    "details": [
      {
        "loc": ["body", "limit"],
        "msg": "Input should be less than or equal to 500",
        "type": "less_than_equal"
      }
    ]
  }
}

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

async function fetchAllJobs(companyName, apiKey) {
  const allJobs = [];
  let cursor = null;
  
  while (true) {
    const response = await fetch('https://api.sentrion.ai/api/v1/search/company-jobs', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        company_name: companyName,
        limit: 100,
        next_cursor: cursor
      })
    });
    
    const data = await response.json();
    allJobs.push(...data.data.jobs);
    
    cursor = data.data.next_cursor;
    if (!cursor) break;
  }
  
  return allJobs;
}

Overview

Endpoints

Historical (6 Years)

Legacy

Company Jobs (Legacy)

Authentication

Request Body

Company Identification

Location Filters

Date Filters

Job Filters

Keyword Filters

Job Board Filters

Other Options

Response

​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