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

# LeadMagic: Job Search

> Search job postings by title, company, location, salary, seniority and posting date. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Search job postings by title, company, location, salary, seniority and posting date.

> [!NOTE]
>
> Tool ID: `leadmagic_job_search`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'leadmagic_job_search',
  {
    "titles": {
      "include": [
        "example"
      ],
      "exclude": [
        "example"
      ],
      "vector": false
    },
    "occupationTaxonomy": {
      "level1": [
        "example"
      ],
      "level2": [
        "example"
      ],
      "level3": [
        "example"
      ]
    },
    "companies": {
      "include": [
        "example"
      ],
      "exclude": [
        "example"
      ],
      "ids": [
        123
      ]
    }
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline run leadmagic_job_search --input '{
  "titles": {
    "include": [
      "example"
    ],
    "exclude": [
      "example"
    ],
    "vector": false
  },
  "occupationTaxonomy": {
    "level1": [
      "example"
    ],
    "level2": [
      "example"
    ],
    "level3": [
      "example"
    ]
  },
  "companies": {
    "include": [
      "example"
    ],
    "exclude": [
      "example"
    ],
    "ids": [
      123
    ]
  }
}'
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "signals": [
      {}
    ],
    "total": 123,
    "totalMode": "example"
  }
}
```

Use `deepline describe leadmagic_job_search --json` for the latest machine-readable contract.

## Input reference

Search jobs with title, occupation taxonomy, company, location, tag, salary, seniority, and date filters. The endpoint resolves friendly values into normalized filter IDs before searching. Company objects do not include logo fields.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.titles` | `object` | No | — | — |
| `payload.occupationTaxonomy` | `object` | No | — | — |
| `payload.companies` | `object` | No | — | — |
| `payload.location` | `object` | No | — | — |
| `payload.tags` | `object` | No | — | — |
| `payload.salary` | `object` | No | — | — |
| `payload.seniority` | `array` | No | — | — |
| `payload.postedAfter` | `string` | No | — | Format: `date`. |
| `payload.postedBefore` | `string` | No | — | Format: `date`. |
| `payload.postedWithin` | `integer` | No | — | Include jobs posted within the last N days. |
| `payload.languages` | `array` | No | — | — |
| `payload.hasRemote` | `boolean` | No | — | — |
| `payload.jobTypeIds` | `array` | No | — | — |
| `payload.industryIds` | `array` | No | — | — |
| `payload.companyTypeIds` | `array` | No | — | — |
| `payload.companySizeCodes` | `array` | No | — | — |
| `payload.limit` | `integer` | No | `25` | Maximum: 50. |
| `payload.cursor` | `string` | No | — | Opaque cursor from pagination.next\_cursor. Send unchanged with the same filters and limit. |
| `payload.includeDescription` | `boolean` | No | `false` | Include job description text. Enabling descriptions may increase response time. |
| `payload.includeFacets` | `boolean` | No | `false` | Include facet metadata. Enabling facets may increase response time. |
| `payload.totalMode` | `"none" \| "capped" \| "exact"` | No | — | Allowed: `none`, `capped`, `exact`. |
| `payload.mode` | `"fast" \| "deep"` | No | — | fast returns paginated browsing results when descriptions and facets are omitted. deep enables broader text matching. Allowed: `fast`, `deep`. |
| `payload.autoResolve` | `boolean` | No | `true` | — |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search jobs with title, occupation taxonomy, company, location, tag, salary, seniority, and date filters. The endpoint resolves friendly values into normalized filter IDs before searching. Company objects do not include logo fields.",
    "properties": {
      "titles": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vector": {
            "type": "boolean",
            "default": false
          }
        },
        "additionalProperties": false
      },
      "occupationTaxonomy": {
        "type": "object",
        "properties": {
          "level1": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          },
          "level2": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          },
          "level3": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          }
        },
        "additionalProperties": false
      },
      "companies": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ids": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        },
        "additionalProperties": false
      },
      "location": {
        "type": "object",
        "properties": {
          "countries": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          },
          "regions": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          },
          "states": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          },
          "cities": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          }
        },
        "additionalProperties": false
      },
      "tags": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            }
          }
        },
        "additionalProperties": false
      },
      "salary": {
        "type": "object",
        "properties": {
          "min_usd": {
            "type": "integer"
          },
          "max_usd": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "seniority": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "postedAfter": {
        "type": "string",
        "format": "date"
      },
      "postedBefore": {
        "type": "string",
        "format": "date"
      },
      "postedWithin": {
        "type": "integer",
        "description": "Include jobs posted within the last N days."
      },
      "languages": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "hasRemote": {
        "type": "boolean"
      },
      "jobTypeIds": {
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "industryIds": {
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "companyTypeIds": {
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "companySizeCodes": {
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "limit": {
        "type": "integer",
        "default": 25,
        "maximum": 50
      },
      "cursor": {
        "type": "string",
        "description": "Opaque cursor from pagination.next_cursor. Send unchanged with the same filters and limit."
      },
      "includeDescription": {
        "type": "boolean",
        "description": "Include job description text. Enabling descriptions may increase response time.",
        "default": false
      },
      "includeFacets": {
        "type": "boolean",
        "description": "Include facet metadata. Enabling facets may increase response time.",
        "default": false
      },
      "totalMode": {
        "type": "string",
        "enum": [
          "none",
          "capped",
          "exact"
        ]
      },
      "mode": {
        "type": "string",
        "description": "fast returns paginated browsing results when descriptions and facets are omitted; deep enables broader text matching.",
        "enum": [
          "fast",
          "deep"
        ]
      },
      "autoResolve": {
        "type": "boolean",
        "default": true
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.signals` | `array` | No | — | — |
| `result.data.total` | `integer` | No | — | — |
| `result.data.totalMode` | `string` | No | — | — |
| `result.data.pagination` | `object` | No | — | — |
| `result.data.pagination.limit` | `integer` | No | — | — |
| `result.data.pagination.returned` | `integer` | No | — | — |
| `result.data.pagination.has_more` | `boolean` | No | — | — |
| `result.data.pagination.next_cursor` | `string \| null` | No | — | — |
| `result.data.has_more` | `boolean` | No | — | — |
| `result.data.next_cursor` | `string \| null` | No | — | — |
| `result.data.resolved` | `record` | No | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "signals": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "total": {
            "type": "integer"
          },
          "totalMode": {
            "type": "string"
          },
          "pagination": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "returned": {
                "type": "integer"
              },
              "has_more": {
                "type": "boolean"
              },
              "next_cursor": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "additionalProperties": false
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "resolved": {
            "type": "object"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.34` per pricing unit.

## Related documentation

* [Connect integrations](https://deepline.com/docs/integrations.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.