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, filter by various criteria, and retrieve detailed company information.

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

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