Skip to main content

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

1

Create your account

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

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

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

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": true,
  "data": {
    // Response data here
  },
  "error": null
}

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 CodeError CodeDescription
400bad_requestThe request was malformed
401unauthorizedInvalid or missing API key
422validation_errorInvalid request parameters
429rate_limit_exceededRate limit exceeded
500server_errorInternal server error