> ## 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.
# Sumble Jobs: Inputs, Cost & CLI Example
> Unified jobs endpoint. Requires the workspace's own Sumble API key. Sumble Sumble Jobs docs include request fields, response shape, pricing notes, and Deepline
## 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=sumble_jobs:{"select":{}}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `payload.jobs` | `array` | No | | List of jobs to enrich by id. One result row per entry, in input order. Mutually exclusive with `filter`. |
| `payload.filter` | `object` | No | | Query selecting the jobs to return. Mutually exclusive with `jobs`. |
| `payload.select` | `object` | Yes | | |
| `payload.limit` | `integer` | No | `10` | Maximum number of jobs to return (filter mode only; ignored when `jobs` is provided). |
| `payload.offset` | `integer` | No | `0` | Number of results to skip (filter mode only; ignored when `jobs` is provided). |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Unified jobs endpoint",
"properties": {
"jobs": {
"type": [
"array",
"null"
],
"description": "List of jobs to enrich by id. One result row per entry, in input order. Mutually exclusive with `filter`.",
"minItems": 1,
"maxItems": 1000,
"items": {
"type": "object",
"properties": {
"job_id": {
"type": "integer",
"description": "Job id on Sumble.",
"minimum": 1
}
},
"required": [
"job_id"
],
"additionalProperties": false
}
},
"filter": {
"type": [
"object",
"null"
],
"description": "Query selecting the jobs to return. Mutually exclusive with `jobs`.",
"properties": {
"organization_ids": {
"type": [
"array",
"null"
],
"description": "Sumble organization ids to scope the search to. Unknown ids simply match no jobs.",
"minItems": 1,
"maxItems": 1000,
"items": {
"type": "integer"
}
},
"organization_list_id": {
"type": [
"integer",
"null"
],
"description": "Id of one of your saved organization lists (see /organization-lists) whose organizations to search within. Combined with `organization_ids` when both are provided.",
"minimum": 1
},
"query": {
"type": [
"object",
"null"
],
"description": "Advanced query narrowing the jobs returned (technologies, technology categories, job functions, countries, hiring period, ...).",
"properties": {
"query": {
"type": "string"
}
},
"required": [
"query"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"select": {
"type": "object",
"properties": {
"attributes": {
"description": "Job attributes to include, or 'all' for every available attribute (including the full `description`). Off by default. Note that 'all' grows — and its cost grows — as new attributes are added to the endpoint.",
"default": [],
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"enum": [
"title",
"description",
"location",
"posted_date",
"organization",
"technologies",
"teams",
"job_functions",
"job_levels",
"projects"
]
}
},
{
"type": "string",
"const": "all"
}
]
},
"related_people": {
"type": [
"object",
"null"
],
"description": "Also return the people likely involved in each job's hiring — scored hiring managers and team members at the posting organization, inferred from team, job function, location and technology similarity, not actual reporting lines. Available in both modes, for at most 200 jobs per request. Each related person returned costs 1 credit.",
"properties": {
"attributes": {
"description": "Person-level attributes to include for each related person, or 'all' for every attribute available here. Contact attributes (email, phone) and `person_score` are not available here; `confidence` (the inferred relationship's score breakdown) is only available here.",
"default": [],
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"enum": [
"name",
"email",
"phone",
"linkedin_url",
"job_title",
"job_function",
"job_level",
"location",
"country",
"current_employer",
"technologies",
"person_score",
"confidence"
]
}
},
{
"type": "string",
"const": "all"
}
]
},
"limit": {
"type": "integer",
"description": "Maximum related people returned per job.",
"default": 5,
"minimum": 1,
"maximum": 25
},
"job_levels": {
"type": "array",
"description": "Only return related people whose job level is one of these (by name, e.g. 'Director', 'VP'); matching is OR across the list. When provided, this replaces the default seniority filter. When empty (the default), only likely hiring managers are returned — people at Manager level or above, and more senior than the role.",
"default": [],
"items": {
"type": "string"
}
},
"job_functions": {
"type": "array",
"description": "Only return related people whose primary job function is one of these (by name, e.g. 'Engineering') or a descendant of one; matching is OR across the list and all descendants. Combined with `job_levels` as AND. Empty (the default) applies no job function filter.",
"default": [],
"items": {
"type": "string"
}
},
"sort_order": {
"type": "string",
"description": "How related people are ranked: 'score' (similarity score, the default; ties broken by seniority) or 'level' (seniority; ties broken by score).",
"default": "score",
"enum": [
"score",
"level"
]
},
"sort_direction": {
"type": "string",
"description": "Direction for `sort_order`. The default 'desc' puts the highest score / most senior people first.",
"default": "desc",
"enum": [
"desc",
"asc"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"limit": {
"type": "integer",
"description": "Maximum number of jobs to return (filter mode only; ignored when `jobs` is provided).",
"default": 10,
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"description": "Number of results to skip (filter mode only; ignored when `jobs` is provided).",
"default": 0,
"minimum": 0,
"maximum": 10000
}
},
"required": [
"select"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response 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": "Provider response payload.",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"input": {
"type": [
"object",
"null"
],
"description": "The input entry this row corresponds to (list mode only).",
"properties": {
"job_id": {
"type": "integer",
"description": "Job id on Sumble.",
"minimum": 1
}
},
"required": [
"job_id"
],
"additionalProperties": false
},
"job_id": {
"type": [
"integer",
"null"
],
"description": "Absent when the input entry didn't match a Sumble job."
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the job posting's Sumble page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"attributes": {
"type": [
"object",
"null"
],
"description": "The requested job attributes; absent when none are requested.",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"posted_date": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"organization": {
"type": [
"object",
"null"
],
"properties": {
"organization_id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the organization's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"organization_id"
],
"additionalProperties": false
},
"technologies": {
"type": [
"array",
"null"
],
"description": "All technologies extracted from the posting; empty list when requested but none were extracted.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"used": {
"type": "boolean",
"description": "True when the posting indicates the technology is used by the team, not merely mentioned."
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "The posting organization's jobs page filtered to this technology.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name",
"slug",
"used"
],
"additionalProperties": false
}
},
"teams": {
"type": [
"array",
"null"
],
"description": "Teams extracted from the posting; empty list when requested but none were extracted.",
"items": {
"type": "object",
"properties": {
"team_id": {
"type": "integer"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the team's Sumble page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"team_id",
"name",
"slug"
],
"additionalProperties": false
}
},
"job_functions": {
"type": [
"array",
"null"
],
"description": "Job functions classified from the posting; empty list when requested but none were classified.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "The posting organization's jobs page filtered to this job function.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"job_levels": {
"type": [
"array",
"null"
],
"description": "Seniority levels classified from the posting; empty list when requested but none were classified.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"projects": {
"type": [
"array",
"null"
],
"description": "Projects extracted from the posting; empty list when requested but none were extracted.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"goal": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "The posting organization's jobs page filtered to this project.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"related_people": {
"type": [
"array",
"null"
],
"description": "Scored hiring managers / team members for the job. Present (possibly empty) when `select.related_people` is requested and the job matched; absent otherwise.",
"items": {
"type": "object",
"properties": {
"person_id": {
"type": "integer"
},
"sumble_url": {
"type": "string",
"description": "Link to the person's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"confidence": {
"type": [
"object",
"null"
],
"description": "Why this person was returned: confidence score (0-1) with per-category and per-feature breakdowns. Present when the `confidence` attribute is requested. Not the ICP-based `person_score`.",
"properties": {
"score": {
"type": "number",
"description": "How strongly this person relates to the source person (people endpoint) or job posting (jobs endpoint), 0-1. Sum of the five contributions below. Measures similarity on shared features (technologies, job functions, teams, locations, job titles) — unrelated to the ICP-based `person_score` attribute."
},
"technology_contribution": {
"type": "number",
"description": "Share from technologies shared with the source."
},
"job_function_contribution": {
"type": "number",
"description": "Share from matching job functions."
},
"team_contribution": {
"type": "number",
"description": "Share from shared teams."
},
"location_contribution": {
"type": "number",
"description": "Share from matching locations."
},
"title_similarity_contribution": {
"type": "number",
"description": "Share from semantic similarity between job titles."
},
"matched_features": {
"type": "array",
"description": "The specific matched features behind the contributions, highest contribution first.",
"items": {
"type": "object",
"properties": {
"match_type": {
"type": "string",
"enum": [
"technology",
"job_function",
"team",
"location",
"title_similarity"
]
},
"name": {
"type": "string",
"description": "The matched feature's name; for title_similarity, the related person's own job title."
},
"slug": {
"type": [
"string",
"null"
],
"description": "Null for location and title_similarity matches."
},
"contribution": {
"type": "number",
"description": "Share of the confidence score attributable to this feature."
}
},
"required": [
"match_type",
"name",
"contribution"
],
"additionalProperties": false
}
}
},
"required": [
"score",
"technology_contribution",
"job_function_contribution",
"team_contribution",
"location_contribution",
"title_similarity_contribution",
"matched_features"
],
"additionalProperties": false
},
"attributes": {
"type": [
"object",
"null"
],
"description": "The requested person-level attributes; absent when none resolve.",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
],
"description": "Revealed work email (match mode only). The first successful reveal per person costs 10 credits; repeat reveals while active are free."
},
"phone": {
"type": [
"string",
"null"
],
"description": "Revealed phone number (match mode only). The first successful reveal per person costs 80 credits; repeat reveals while active are free."
},
"linkedin_url": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"job_title": {
"type": [
"string",
"null"
]
},
"job_function": {
"type": [
"string",
"null"
]
},
"job_level": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"current_employer": {
"type": [
"object",
"null"
],
"properties": {
"organization_id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
],
"description": "Start of the person's current role (YYYY-MM)."
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the organization's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"organization_id"
],
"additionalProperties": false
},
"technologies": {
"type": [
"array",
"null"
],
"description": "Technologies from the skills on the person's LinkedIn profile, normalized to Sumble's technology catalog. The slug can be used in `filter.query` (technology EQ ' '). Empty when none of the profile's skills map to a known technology.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"person_score": {
"type": [
"object",
"null"
],
"description": "How well the person matches your ideal customer profile (ICP), 0-100, with a per-feature breakdown. Priced like other paid attributes. Filter mode only; selecting it explicitly requires the filter to resolve to exactly one organization and an ICP configured for your account (`attributes: \"all\"` skips it instead when unavailable). Included automatically when sorting with `order_by_column=\"person_score\"`.",
"properties": {
"value": {
"type": "number",
"description": "How well the person matches your ideal customer profile (ICP), 0-100. Sum of the three contributions below."
},
"skill_contribution": {
"type": "number",
"description": "Points from technologies the person uses that match your ICP."
},
"job_function_contribution": {
"type": "number",
"description": "Points from the person's job function matching your ICP."
},
"seniority_contribution": {
"type": "number",
"description": "Points from the person's job level (seniority)."
},
"matched_features": {
"type": "array",
"description": "The matched technologies and job functions behind the skill and job-function contributions, highest contribution first.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"match_type": {
"type": "string",
"enum": [
"technology",
"job_function"
]
},
"contribution": {
"type": "number",
"description": "Points of the 0-100 score attributable to this feature."
}
},
"required": [
"name",
"slug",
"match_type",
"contribution"
],
"additionalProperties": false
}
}
},
"required": [
"value",
"skill_contribution",
"job_function_contribution",
"seniority_contribution",
"matched_features"
],
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"person_id",
"sumble_url"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"matched_count": {
"type": [
"integer",
"null"
],
"description": "List mode only: how many input entries matched a Sumble job."
},
"total": {
"type": "integer"
},
"source_data_url": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"id",
"jobs",
"total"
],
"additionalProperties": false
},
"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 sumble_jobs --payload '{
"select": {}
}' --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. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.