API Reference

Introduction

The Sentrion API provides programmatic access to job market intelligence. Use our APIs to search for job postings from specific companies or run direct, cross-company job searches with detailed filters.

Getting Started

Create your account

Head to app.sentrion.ai and sign up. You’ll get access to your dashboard right away.

Get your API key

In your dashboard, go to Settings > API Keys and create a new key. This key is how Sentrion identifies your requests.

Your API key is like a password — keep it private and never share it publicly.

Make your first request

Use your API key to search for 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": "Google"}'

import requests

response = requests.post(
    "https://api.sentrion.ai/api/v1/search/company-jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"company_name": "Google"}
)
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: "Google" })
});
const data = await response.json();

Base URL

All API requests should be made to:

https://api.sentrion.ai/api/v1

Authentication

All endpoints require Bearer token authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API Versioning

This API is currently unversioned. We are committed to maintaining backward compatibility. Any breaking changes will be introduced under a new versioned endpoint (e.g., /v2/search/company-jobs).

Available Endpoints

POST /company-jobs/search

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

POST /jobs-search/search

Search across all companies using location, industry, department, keyword, job board, and salary filters.

Response Format

All API responses follow a consistent format:

Success Response
Error Response

{
  "success": true,
  "data": {
    // Response data here
  },
  "error": null
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message",
    "details": []
  }
}

Rate Limiting

The API implements rate limiting to ensure fair usage. If you exceed the rate limit, you’ll receive a 429 status code with the following response:

{
  "success": false,
  "data": null,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You have exceeded the number of allowed requests per minute."
  }
}

Error Codes

Status Code	Error Code	Description
400	`bad_request`	The request was malformed
401	`unauthorized`	Invalid or missing API key
422	`validation_error`	Invalid request parameters
429	`rate_limit_exceeded`	Rate limit exceeded
500	`server_error`	Internal server error

Overview

Endpoints

Historical (6 Years)

Legacy

Introduction

Getting Started

Base URL

Authentication

API Versioning

Available Endpoints

POST /company-jobs/search

POST /jobs-search/search

Response Format

Rate Limiting

Error Codes

​Introduction

​Getting Started

​Base URL

​Authentication

​API Versioning

​Available Endpoints

POST /company-jobs/search

POST /jobs-search/search

​Response Format

​Rate Limiting

​Error Codes

Introduction

Getting Started

Base URL

Authentication

API Versioning

Available Endpoints

Response Format

Rate Limiting

Error Codes