> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Sentrion Action Doc: Inputs, Cost & CLI Example
> Finding up to 6 years of historical job postings for a specific company when the API key has historical access. Includes inputs, outputs, and CLI examples.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=sentrion_company_jobs_search_historical:{"company_linkedin_url":"{{company_linkedin_url}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| -------------------------------- | --------- | -------- | ------- | ----------------------------- |
| `payload.jobs_locations` | `array` | No | | |
| `payload.exclude_jobs_locations` | `array` | No | | |
| `payload.is_remote` | `boolean` | No | | |
| `payload.country_exists` | `boolean` | No | | |
| `payload.published_after` | `string` | No | | |
| `payload.published_before` | `string` | No | | |
| `payload.department` | `array` | No | | |
| `payload.industry` | `array` | No | | |
| `payload.job_type` | `array` | No | | |
| `payload.seniority_level` | `array` | No | | |
| `payload.salary_data_available` | `boolean` | No | `true` | |
| `payload.is_agency` | `boolean` | No | `true` | |
| `payload.job_keywords` | `object` | No | | |
| `payload.exclude_job_keywords` | `object` | No | | |
| `payload.job_boards` | `boolean` | No | | |
| `payload.include_job_boards` | `array` | No | | |
| `payload.exclude_job_boards` | `array` | No | | |
| `payload.limit` | `integer` | No | `100` | |
| `payload.search_after` | `array` | No | | |
| `payload.exclude_duplicates` | `boolean` | No | `true` | |
| `payload.company_linkedin_url` | `string` | Yes | | LinkedIn company profile URL. |
| `payload.company_name` | `string` | No | | |
| `payload.company_domain` | `string` | No | | |
| `payload.company_broad_search` | `boolean` | No | `false` | |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Search up to 6 years of historical job postings for a specific company. Requires special access.",
"properties": {
"jobs_locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"state": {
"type": "string"
},
"city": {
"type": "string"
}
},
"additionalProperties": false
}
},
"exclude_jobs_locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"state": {
"type": "string"
},
"city": {
"type": "string"
}
},
"additionalProperties": false
}
},
"is_remote": {
"type": [
"boolean",
"null"
]
},
"country_exists": {
"type": [
"boolean",
"null"
]
},
"published_after": {
"type": "string",
"format": "date"
},
"published_before": {
"type": "string",
"format": "date"
},
"department": {
"type": "array",
"items": {
"type": "string",
"enum": [
"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"
]
}
},
"industry": {
"type": "array",
"items": {
"type": "string"
}
},
"job_type": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Full Time",
"Part Time",
"Contract",
"Internship",
"Volunteer"
]
}
},
"seniority_level": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Entry Level",
"Mid Level",
"Executive Level"
]
}
},
"salary_data_available": {
"type": "boolean",
"default": true
},
"is_agency": {
"type": "boolean",
"default": true
},
"job_keywords": {
"type": "object",
"properties": {
"title": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "array",
"items": {
"type": "string"
}
},
"mode": {
"type": "string",
"default": "and",
"enum": [
"and",
"or"
]
}
},
"additionalProperties": false
},
"exclude_job_keywords": {
"type": "object",
"properties": {
"title": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "array",
"items": {
"type": "string"
}
},
"mode": {
"type": "string",
"default": "and",
"enum": [
"and",
"or"
]
}
},
"additionalProperties": false
},
"job_boards": {
"type": [
"boolean",
"null"
]
},
"include_job_boards": {
"type": "array",
"items": {
"type": "string"
}
},
"exclude_job_boards": {
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"type": "integer",
"default": 100,
"minimum": 10,
"maximum": 100
},
"search_after": {
"type": [
"array",
"null"
],
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}
},
"exclude_duplicates": {
"type": "boolean",
"default": true
},
"company_linkedin_url": {
"type": "string",
"description": "LinkedIn company profile URL.",
"pattern": "^https://www\\.linkedin\\.com/company/.+"
},
"company_name": {
"type": "string"
},
"company_domain": {
"type": "string"
},
"company_broad_search": {
"type": "boolean",
"default": false
}
},
"required": [
"company_linkedin_url"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Normalized Sentrion job search payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Normalized Sentrion job search payload.",
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Job Type": {
"type": [
"string",
"null"
]
},
"Job Title": {
"type": [
"string",
"null"
]
},
"Apply URL": {
"type": [
"string",
"null"
]
},
"Post Date": {
"type": [
"string",
"null"
]
},
"Valid Through": {
"type": [
"string",
"null"
]
},
"City": {
"type": [
"string",
"null"
]
},
"Job Board": {
"type": [
"string",
"null"
]
},
"Job Description": {
"type": [
"string",
"null"
]
},
"Country": {
"type": [
"string",
"null"
]
},
"Company Name": {
"type": [
"string",
"null"
]
},
"State": {
"type": [
"string",
"null"
]
},
"Salary Offered": {
"type": [
"string",
"null"
]
},
"Logo URL": {
"type": [
"string",
"null"
]
},
"Is Remote": {
"type": [
"boolean",
"null"
]
},
"Job URL": {
"type": [
"string",
"null"
]
},
"Department Name": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"Seniority Level": {
"type": [
"string",
"null"
]
},
"Salary Currency": {
"type": [
"string",
"null"
]
},
"Salary To": {
"type": [
"number",
"null"
]
},
"Salary From": {
"type": [
"number",
"null"
]
},
"Skills": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": true
}
},
"total": {
"type": "integer"
},
"total_jobs_found": {
"type": "integer"
},
"search_after": {
"type": [
"array",
"null"
],
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}
},
"company_details": {
"type": "object",
"properties": {
"company_name": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"linkedin_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
},
"required": [
"jobs",
"total",
"total_jobs_found"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute sentrion_company_jobs_search_historical --payload '{
"company_linkedin_url": "string"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Provider API Context
Show provider reference (optional)
```md theme={null}
Sources reviewed 2026-07-14:
- https://docs.sentrion.ai/api-reference/introduction
- https://docs.sentrion.ai/api-reference/company-jobs.md
- https://docs.sentrion.ai/api-reference/direct-jobs.md
- https://docs.sentrion.ai/api-reference/company-jobs-historical.md
- https://docs.sentrion.ai/api-reference/direct-jobs-historical.md
- https://docs.sentrion.ai/resources/pricing.md
The Sentrion docs advertise https://docs.sentrion.ai/api-reference/openapi.json in llms.txt, but that URL returned Mintlify's sample Plant Store spec during implementation. The local `openapi.json` snapshot is authored from the official endpoint markdown pages above.
## Auth
All endpoints use `Authorization: Bearer <api key>`.
## Endpoints
- `POST https://api.sentrion.ai/api/v1/company-jobs/search`
- `POST https://api.sentrion.ai/api/v1/jobs-search/search`
- `POST https://api.sentrion.ai/api/v3/company-jobs/search` for 6-year historical data; requires special access.
- `POST https://api.sentrion.ai/api/v3/jobs-search/search` for 6-year historical data; requires special access.
## Pricing
Sentrion's public pricing page says "Job found (per job)" costs 1 credit. The API response examples include `data.credits_used` and `data.credits_remaining`.
The provider exchange rate is based on the confirmed core product price: $750 / 25,000 credits = $0.03 per Sentrion credit.
The core-product credit allotment was confirmed as 25,000 credits per $750 month.
## Response Evidence
Official response examples show:
- top-level `success`, `data`, and `error`
- `data.jobs` as an array of job objects
- `data.total`
- `data.total_jobs_found`
- `data.credits_used`
- `data.credits_remaining`
- `data.search_after`
- company endpoints additionally include `data.company_details`
Current endpoints allow `limit` values from 10 through 500. Historical endpoints allow 10 through 100.
The official success examples for all four endpoints are preserved under `raw-upstream-examples/`. Public samples under `sample-outputs/` contain the normalized Deepline response shape, after the provider wrapper is unwrapped and provider credit fields are removed.
```
## Cost
* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.42` per pricing unit.
* Billing mode: `post_deduct`.