> ## 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.

# Company Jobs

> Search for job postings at a specific company. Returns enriched company details alongside matching jobs.

## Company Jobs

Search for job postings 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 a Bearer token. Enter your API key in the authorization field above — the `Bearer` prefix is added automatically.

***

### Request Body

#### Company Identification

<ParamField body="company_linkedin_url" type="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/"
  ```
</ParamField>

<ParamField body="company_name" type="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"
  ```
</ParamField>

<ParamField body="company_domain" type="string">
  Company website domain. Currently used for enrichment context.

  ```
  "company_domain": "stripe.com"
  ```
</ParamField>

<ParamField body="company_broad_search" type="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.
</ParamField>

***

#### Location Filters

<ParamField body="jobs_locations" type="array">
  Filter jobs by location. Each item supports `country`, `state`, and `city`. Multiple locations use OR logic.

  ```json theme={null}
  "jobs_locations": [
    { "country": "United States", "state": "California", "city": "San Francisco" },
    { "country": "United Kingdom" }
  ]
  ```
</ParamField>

<ParamField body="exclude_jobs_locations" type="array">
  Exclude jobs from specific locations. Same structure as `jobs_locations`.

  ```json theme={null}
  "exclude_jobs_locations": [
    { "country": "India" }
  ]
  ```
</ParamField>

<ParamField body="is_remote" type="boolean" default="null">
  Filter by remote status. `true` returns only remote jobs, `false` returns only non-remote jobs, `null` includes both.
</ParamField>

<ParamField body="country_exists" type="boolean" default="null">
  When `true`, only returns jobs that have country information available.
</ParamField>

***

#### Date Filters

<ParamField body="published_after" type="string" default="6 months ago">
  Start date for the job search in `YYYY-MM-DD` format. Cannot be older than 6 months before the request date.

  ```
  "published_after": "2025-01-01"
  ```
</ParamField>

<ParamField body="published_before" type="string" default="today">
  End date for the job search in `YYYY-MM-DD` format. Must be later than `published_after`.

  ```
  "published_before": "2025-06-30"
  ```
</ParamField>

***

#### Job Filters

<ParamField body="department" type="array">
  Filter by department. Values are case-sensitive.

  <Expandable title="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               |
  </Expandable>

  ```json theme={null}
  "department": ["Engineering", "Product Management"]
  ```
</ParamField>

<ParamField body="job_type" type="array">
  Filter by employment type.

  **Possible values:** `Full Time`, `Part Time`, `Contract`, `Internship`, `Volunteer`

  ```json theme={null}
  "job_type": ["Full Time", "Contract"]
  ```
</ParamField>

<ParamField body="seniority_level" type="array">
  Filter by seniority level. ML-generated, available for English-language jobs.

  **Possible values:** `Entry Level`, `Mid Level`, `Executive Level`

  ```json theme={null}
  "seniority_level": ["Mid Level", "Executive Level"]
  ```
</ParamField>

<ParamField body="industry" type="array">
  Filter by industry. Values are case-insensitive.

  <Expandable title="All 149 industry values">
    | Value                                |
    | ------------------------------------ |
    | 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 |
    | Religious Institutions               |
    | 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                  |
  </Expandable>
</ParamField>

<ParamField body="salary_data_available" type="boolean" default="true">
  When `true`, only returns jobs that have salary information available.
</ParamField>

<ParamField body="is_agency" type="boolean" default="true">
  Include agency-posted jobs. Set to `false` to exclude recruitment agency listings.
</ParamField>

***

#### Keyword Filters

<ParamField body="job_keywords" type="object">
  Keywords to search for in job titles and descriptions.

  <Expandable title="Properties">
    <ParamField body="job_keywords.title" type="array">
      Keywords to match in job titles.
    </ParamField>

    <ParamField body="job_keywords.description" type="array">
      Keywords to match in job descriptions.
    </ParamField>

    <ParamField body="job_keywords.mode" type="string" default="and">
      Match behavior. `"and"` requires all keywords to match, `"or"` requires any one.
    </ParamField>
  </Expandable>

  ```json theme={null}
  "job_keywords": {
    "title": ["Backend", "Engineer"],
    "description": ["Python", "AWS"],
    "mode": "and"
  }
  ```
</ParamField>

<ParamField body="exclude_job_keywords" type="object">
  Keywords to exclude from results. Same structure as `job_keywords`.

  ```json theme={null}
  "exclude_job_keywords": {
    "title": ["Intern", "Junior"],
    "mode": "or"
  }
  ```
</ParamField>

***

#### Job Board Filters

<ParamField body="job_boards" type="boolean" default="null">
  `true` includes only jobs from job boards. `false` returns only company career page postings. `null` includes both.
</ParamField>

<ParamField body="include_job_boards" type="array">
  Only include results from specific job boards. Values are case-insensitive.

  ```json theme={null}
  "include_job_boards": ["Linkedin", "indeed"]
  ```
</ParamField>

<ParamField body="exclude_job_boards" type="array">
  Exclude results from specific job boards. Values are case-insensitive.

  ```json theme={null}
  "exclude_job_boards": ["glassdoor", "monster"]
  ```
</ParamField>

<Expandable title="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
</Expandable>

***

#### Pagination & Limits

<ParamField body="limit" type="integer" default="100">
  Maximum number of jobs to return. Min: `10`, Max: `500`.
</ParamField>

<ParamField body="search_after" type="array">
  Pagination cursor from a previous response. Pass the `search_after` value from the last response to fetch the next page.

  ```json theme={null}
  "search_after": [1711929600000, 12345]
  ```
</ParamField>

<ParamField body="exclude_duplicates" type="boolean" default="true">
  Remove duplicate job listings from results.
</ParamField>

***

### Response

<ResponseField name="success" type="boolean">
  `true` if the search completed successfully.
</ResponseField>

<ResponseField name="data" type="object">
  The response payload. `null` when the request fails.

  <Expandable title="Properties">
    <ResponseField name="company_details" type="object">
      Enriched company profile data.

      <Expandable title="Properties">
        <ResponseField name="company_name" type="string">
          Official company name.
        </ResponseField>

        <ResponseField name="description" type="string">
          Company description / about text.
        </ResponseField>

        <ResponseField name="industry" type="string">
          Industry classification.
        </ResponseField>

        <ResponseField name="employee_data" type="object">
          Employee headcount information.

          <Expandable title="Properties">
            <ResponseField name="headcount" type="integer">
              Estimated employee count.
            </ResponseField>

            <ResponseField name="size_range" type="string">
              Size bucket (e.g., `"1001-5000"`, `"10001+"`).
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="website" type="string">
          Company website URL.
        </ResponseField>

        <ResponseField name="linkedin_url" type="string">
          LinkedIn profile URL.
        </ResponseField>

        <ResponseField name="locations" type="array">
          Company office locations.

          <Expandable title="Properties">
            <ResponseField name="city" type="string">City</ResponseField>
            <ResponseField name="state" type="string">State or region</ResponseField>
            <ResponseField name="country" type="string">Country code</ResponseField>
            <ResponseField name="is_headquarters" type="boolean">Whether this is the HQ</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="founded_date" type="object">
          <Expandable title="Properties">
            <ResponseField name="year" type="integer">Year the company was founded.</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="tagline" type="string">Company tagline or slogan.</ResponseField>
        <ResponseField name="specialties" type="array">List of company specialties.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="jobs" type="array">
      List of matching job objects.

      <Expandable title="Job object properties">
        <ResponseField name="Job Title" type="string">Position title.</ResponseField>
        <ResponseField name="Job Type" type="string">Employment type (e.g., `Full Time`, `Contract`).</ResponseField>
        <ResponseField name="Job Description" type="string">Full job posting text.</ResponseField>
        <ResponseField name="Company Name" type="string">Hiring company name.</ResponseField>
        <ResponseField name="City" type="string">Job location city.</ResponseField>
        <ResponseField name="State" type="string">Job location state or region.</ResponseField>
        <ResponseField name="Country" type="string">Job location country.</ResponseField>
        <ResponseField name="Is Remote" type="boolean">Whether the job is remote.</ResponseField>
        <ResponseField name="Post Date" type="string">Publication date in `YYYY-MM-DD` format.</ResponseField>
        <ResponseField name="Valid Through" type="string">Posting expiration date.</ResponseField>
        <ResponseField name="Job URL" type="string">URL of the original job listing.</ResponseField>
        <ResponseField name="Apply URL" type="string">Direct link to the application page.</ResponseField>
        <ResponseField name="Job Board" type="string">Source job board.</ResponseField>
        <ResponseField name="Logo URL" type="string">Company logo image URL.</ResponseField>
        <ResponseField name="Department Name" type="array">Inferred department(s).</ResponseField>
        <ResponseField name="Seniority Level" type="string">Inferred seniority level.</ResponseField>
        <ResponseField name="Salary Offered" type="string">Raw salary text from the posting.</ResponseField>
        <ResponseField name="Salary From" type="number">Lower bound of salary range.</ResponseField>
        <ResponseField name="Salary To" type="number">Upper bound of salary range.</ResponseField>
        <ResponseField name="Salary Currency" type="string">Currency code (e.g., `USD`, `EUR`).</ResponseField>
        <ResponseField name="Skills" type="array">Skills extracted from the job description.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="integer">Number of jobs returned in this response.</ResponseField>
    <ResponseField name="total_jobs_found" type="integer">Total matching jobs across all pages.</ResponseField>
    <ResponseField name="credits_used" type="integer">Credits consumed by this request.</ResponseField>
    <ResponseField name="credits_remaining" type="integer">Credits remaining after this request.</ResponseField>
    <ResponseField name="search_after" type="array">Pagination cursor for the next page. `null` when there are no more results.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="error" type="string">
  Error message when applicable. `null` for successful responses.
</ResponseField>

***

### Pagination

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

```json theme={null}
{
  "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.

***

<RequestExample>
  ```bash Basic request theme={null}
  curl -X POST https://api.sentrion.ai/api/v1/company-jobs/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
    }'
  ```

  ```bash With filters theme={null}
  curl -X POST https://api.sentrion.ai/api/v1/company-jobs/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
    }'
  ```

  ```bash Exclude job boards theme={null}
  curl -X POST https://api.sentrion.ai/api/v1/company-jobs/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": 200
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "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": 1,
      "credits_remaining": 9999,
      "search_after": [1710460800000, 67890]
    },
    "error": null
  }
  ```

  ```json 400 — Missing LinkedIn URL theme={null}
  {
    "detail": "company_linkedin_url is required."
  }
  ```

  ```json 403 — Invalid API key theme={null}
  {
    "detail": "Invalid or inactive API key"
  }
  ```

  ```json 403 — No credits theme={null}
  {
    "detail": "API key has no credits remaining"
  }
  ```
</ResponseExample>

## Rate Limits

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