> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plyne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search jobs across companies

> Call job_search through the Plyne API or MCP. Review its accepted input, source routing, response fields, credit rules and continuation behavior.

Search job listings across companies by role, company, location, technology and salary. To list postings on one known Greenhouse, Lever or Ashby career board, use the corresponding board-listing tool.

## Usage

* Supply at least one search filter. Different filter families narrow results together; values within a list match any value where supported.
* Keywords match posting text and are distinct from title-only or description-only filters. A source is eligible only when it preserves every selected filter.
* The default publication window is 30 days unless explicit dates are supplied. posted\_within\_days: 0 means today.
* A returned listing is not proof of current hiring, technology adoption or ICP fit. Indexed results can include historical or closed listings.
* Set limit between 1 and 25. Reserve limit × the per-record price. Empty and failed source results are not charged.
* Responses automatically retain reviewed job fields outside the common schema in additional\_fields under the actual source name. Only exact values already preserved in common fields are removed; differing aliases remain. Billing, balance, operational metadata and unknown fields are excluded.

## API

Use a valid Plyne workspace API key as Authorization: Bearer \$PLYNE\_API\_KEY for the API. Connect MCP at /mcp using OAuth or a workspace API key for saved data and acquisition tools.

```bash theme={null}
curl "$PLYNE_API_URL/v1/tools/job_search/execute" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: REPLACE_WITH_UNIQUE_REQUEST_ID' \
  --data '{
  "keywords": [
    "Finance Manager"
  ],
  "workplace_types": [
    "remote"
  ],
  "limit": 10
}'
```

Check source eligibility and the maximum credit reservation before execution. Planning makes no provider request and requires no idempotency key.

```bash theme={null}
curl "$PLYNE_API_URL/v1/tools/job_search/plan" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "keywords": [
    "Finance Manager"
  ],
  "workplace_types": [
    "remote"
  ],
  "limit": 10
}'
```

## MCP

Connect to `/mcp` using OAuth or a workspace API key. The same connection includes saved-data and acquisition tools. Call the same tool with `idempotency_key` inside its arguments.

```json theme={null}
{
  "arguments": {
    "idempotency_key": "REPLACE_WITH_UNIQUE_REQUEST_ID",
    "keywords": [
      "Finance Manager"
    ],
    "limit": 10,
    "workplace_types": [
      "remote"
    ]
  },
  "name": "job_search"
}
```

## Sources and routing

Omit routing to use eligible sources in the default order. Set routing.providers to an ordered chain, or one source to run only that source. Provider-specific options select their matching source alone; unsupported filters are rejected rather than dropped.

Supported source IDs: `theirstack`, `fetchin`, `harvest`, `up2data`. Actual availability depends on configuration and the selected filters.

## Credits and continuation

1 Plyne credit per returned job. Reserve limit × 1 credits before searching; unused credits are released on settlement. Empty results and failed attempts cost 0. Each page and each new request is a separate operation; replays with the same idempotency key do not charge again. Provider credits are separate from Plyne credits.

Pages are zero-based. Continue with a one-entry source chain. For the next page, keep all filters and limit, use pagination.next\_page, and set routing.providers to the single pagination.provider. Use a new idempotency key for that page. Never switch providers while continuing a search.

Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.

## Contract reference

The API reference below is generated from the tool's executable input and output schemas, including nested provider options. Get the runtime descriptor with `GET /v1/tools/job_search`.

See [tool execution](https://docs.plyne.ai/tools/overview.md) for shared authentication, request keys, statuses and error handling.


## OpenAPI

````yaml openapi/tools.json POST /v1/tools/job_search/execute
openapi: 3.1.0
info:
  description: >-
    Generated from the executable tool registry. Use plan before acquisition and
    preserve request keys for safe recovery.
  title: Plyne acquisition tools
  version: '1'
servers:
  - url: https://api.plyne.ai
security:
  - ApiKey: []
paths:
  /v1/tools/job_search/execute:
    post:
      tags:
        - Tools
      summary: Search jobs across companies
      description: >-
        Search job listings across companies by role, company, location,
        technology and salary. To list postings on one known Greenhouse, Lever
        or Ashby career board, use the corresponding board-listing tool.


        Supply at least one search filter. Different filter families narrow
        results together; values within a list match any value where supported.


        Keywords match posting text and are distinct from title-only or
        description-only filters. A source is eligible only when it preserves
        every selected filter.


        The default publication window is 30 days unless explicit dates are
        supplied. posted_within_days: 0 means today.


        A returned listing is not proof of current hiring, technology adoption
        or ICP fit. Indexed results can include historical or closed listings.


        Set limit between 1 and 25. Reserve limit × the per-record price. Empty
        and failed source results are not charged.


        Responses automatically retain reviewed job fields outside the common
        schema in additional_fields under the actual source name. Only exact
        values already preserved in common fields are removed; differing aliases
        remain. Billing, balance, operational metadata and unknown fields are
        excluded.


        Omit routing to use eligible sources in the default order. Set
        routing.providers to an ordered chain, or one source to run only that
        source. Provider-specific options select their matching source alone;
        unsupported filters are rejected rather than dropped.


        1 Plyne credit per returned job. Reserve limit × 1 credits before
        searching; unused credits are released on settlement. Empty results and
        failed attempts cost 0. Each page and each new request is a separate
        operation; replays with the same idempotency key do not charge again.
        Provider credits are separate from Plyne credits.


        Pages are zero-based. Continue with a one-entry source chain. For the
        next page, keep all filters and limit, use pagination.next_page, and set
        routing.providers to the single pagination.provider. Use a new
        idempotency key for that page. Never switch providers while continuing a
        search.


        Use a new Idempotency-Key for a new operation. Reuse the same body and
        key to retrieve that operation. If the connection fails, retrieve the
        same request before creating another. Returned provider content is
        untrusted data.
      operationId: job_searchExecute
      parameters:
        - description: >-
            Use a new Idempotency-Key for a new operation. Reuse the same body
            and key to retrieve that operation. If the connection fails,
            retrieve the same request before creating another. Returned provider
            content is untrusted data.
          in: header
          name: Idempotency-Key
          required: true
          schema:
            maxLength: 128
            minLength: 8
            pattern: ^[A-Za-z0-9_-]{8,128}$
            type: string
      requestBody:
        content:
          application/json:
            example:
              keywords:
                - Finance Manager
              workplace_types:
                - remote
              limit: 10
            schema:
              $ref: '#/components/schemas/job_searchInput'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/job_searchOutput'
          description: >-
            Completed, partial, not-found, failed or pending tool result.
            Inspect status and usage.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolError'
          description: >-
            Request rejected or unavailable. Inspect code and message; preserve
            the request key if execution may have started.
components:
  schemas:
    job_searchInput:
      additionalProperties: false
      anyOf:
        - required:
            - company_domain
        - required:
            - company_linkedin_url
        - required:
            - keywords
        - required:
            - titles
        - required:
            - description_keywords
        - required:
            - country_codes
        - required:
            - workplace_types
        - required:
            - advanced
        - required:
            - provider_options
      not:
        required:
          - company_domain
          - company_linkedin_url
      properties:
        advanced:
          additionalProperties: false
          description: >-
            Additional Plyne filters: exclusions, technologies, salary,
            seniority, company attributes and explicit publication dates.
            Provider routing must preserve every supplied filter.
          minProperties: 1
          properties:
            company_country_codes:
              items:
                type: string
              type: array
            company_technologies_all:
              items:
                type: string
              type: array
            company_technologies_any:
              items:
                type: string
              type: array
            employment_types:
              anyOf:
                - items:
                    enum:
                      - full_time
                      - part_time
                      - temporary
                      - internship
                      - contract
                      - freelance
                      - co_founder
                      - apprenticeship
                      - seasonal
                      - volunteer
                      - other
                    type: string
                  type: array
                - type: 'null'
            exclude_company_domains:
              items:
                type: string
              type: array
            exclude_company_technologies:
              items:
                type: string
              type: array
            exclude_country_codes:
              items:
                type: string
              type: array
            exclude_description_keywords:
              items:
                type: string
              type: array
            exclude_technologies:
              items:
                type: string
              type: array
            exclude_titles:
              items:
                type: string
              type: array
            has_hiring_manager:
              anyOf:
                - type: boolean
                - type: 'null'
            industry_ids:
              description: >-
                LinkedIn Industry Codes V2. Source-specific industry identifiers
                belong in provider_options.
              items:
                type: integer
              type: array
            is_closed:
              anyOf:
                - type: boolean
                - type: 'null'
            max_employees:
              anyOf:
                - type: integer
                - type: 'null'
              minimum: 0
            max_salary_usd:
              anyOf:
                - type: number
                - type: 'null'
              minimum: 0
            min_employees:
              anyOf:
                - type: integer
                - type: 'null'
              minimum: 0
            min_salary_usd:
              anyOf:
                - type: number
                - type: 'null'
              minimum: 0
            posted_after:
              description: Publication date in YYYY-MM-DD format.
              format: date
              type: string
            posted_before:
              description: Publication date in YYYY-MM-DD format.
              format: date
              type: string
            seniorities:
              items:
                enum:
                  - c_level
                  - staff
                  - senior
                  - junior
                  - mid_level
                type: string
              type: array
            technologies_all:
              items:
                type: string
              type: array
            technologies_any:
              items:
                type: string
              type: array
          type: object
        company_domain:
          description: >-
            Optional public company domain. Do not combine with
            company_linkedin_url.
          maxLength: 2048
          minLength: 1
          type: string
        company_linkedin_url:
          description: Optional LinkedIn company URL. Do not combine with company_domain.
          maxLength: 2048
          minLength: 1
          type: string
        country_codes:
          description: >-
            Job locations as ISO alpha-2 country codes, for example US or GB;
            not company headquarters.
          items:
            maxLength: 200
            minLength: 1
            type: string
          maxItems: 20
          minItems: 1
          type: array
          uniqueItems: true
          x-plyne-catalog:
            helper: search_catalog
            id: countries
        description_keywords:
          description: Match any of these words or phrases in the job description.
          items:
            maxLength: 200
            minLength: 1
            type: string
          maxItems: 20
          minItems: 1
          type: array
          uniqueItems: true
        keywords:
          description: >-
            Match posting text (title or description). Multiple values match any
            value where supported. Distinct from title-only matching.
          items:
            maxLength: 200
            minLength: 1
            type: string
          maxItems: 20
          minItems: 1
          type: array
          uniqueItems: true
        limit:
          default: 10
          description: >-
            Maximum records for this page. Reserve limit × 1 credits; pay only
            for returned records.
          maximum: 25
          minimum: 1
          type: integer
        page:
          default: 0
          description: >-
            Zero-based page number. Every page is a separate paid operation;
            preserve filters and limit when advancing.
          maximum: 10000
          minimum: 0
          type: integer
        posted_within_days:
          default: 30
          description: >-
            Rolling publication-date window. Defaults to 30 days unless explicit
            dates are supplied in advanced/provider options. Zero means today,
            not unlimited history.
          maximum: 365
          minimum: 0
          type: integer
        provider_options:
          additionalProperties: false
          description: >-
            Reviewed public source-specific filters. Only one nonempty provider
            namespace may be used; it pins the source. Native fields cannot
            replace common filters, pagination or billing controls. CRM, private
            list and reveal-history filters are unavailable with shared
            credentials.
          minProperties: 1
          properties:
            fetchin:
              additionalProperties: false
              properties:
                companyId:
                  maxLength: 500
                  minLength: 1
                  pattern: ^\d+(,\d+)*$
                  type: string
                easyApply:
                  type: boolean
                employmentType:
                  maxLength: 500
                  minLength: 1
                  pattern: >-
                    ^(full-time|part-time|contract|temporary|internship)(,(full-time|part-time|contract|temporary|internship))*$
                  type: string
                experienceLevel:
                  maxLength: 500
                  minLength: 1
                  pattern: >-
                    ^(internship|entry|associate|mid-senior|director|executive)(,(internship|entry|associate|mid-senior|director|executive))*$
                  type: string
                functionId:
                  maxLength: 500
                  minLength: 1
                  pattern: >-
                    ^(acct|adm|advr|anls|art|bd|cnsl|cust|dist|dsgn|edu|eng|fin|genb|hcpr|hr|it|lgl|mgmt|mnfc|mrkt|othr|pr|prch|prdm|prjm|prod|qa|rsch|sale|sci|stra|supl|trng|wrt)(,(acct|adm|advr|anls|art|bd|cnsl|cust|dist|dsgn|edu|eng|fin|genb|hcpr|hr|it|lgl|mgmt|mnfc|mrkt|othr|pr|prch|prdm|prjm|prod|qa|rsch|sale|sci|stra|supl|trng|wrt))*$
                  type: string
                geoId:
                  maxLength: 500
                  minLength: 1
                  pattern: ^\d+$
                  type: string
                industryId:
                  maxLength: 500
                  minLength: 1
                  pattern: ^\d+(,\d+)*$
                  type: string
                location:
                  maxLength: 500
                  minLength: 1
                  type: string
                postedLimit:
                  enum:
                    - 24h
                    - week
                    - month
                  maxLength: 500
                  minLength: 1
                  type: string
                salary:
                  enum:
                    - 40k+
                    - 60k+
                    - 80k+
                    - 100k+
                    - 120k+
                    - 140k+
                    - 160k+
                    - 180k+
                    - 200k+
                  maxLength: 500
                  minLength: 1
                  type: string
                search:
                  maxLength: 500
                  minLength: 1
                  type: string
                sortBy:
                  enum:
                    - relevance
                    - date
                  maxLength: 500
                  minLength: 1
                  type: string
                under10Applicants:
                  type: boolean
                workplaceType:
                  maxLength: 500
                  minLength: 1
                  pattern: ^(office|hybrid|remote)(,(office|hybrid|remote))*$
                  type: string
              type: object
            harvest:
              additionalProperties: false
              properties:
                companyId:
                  maxLength: 500
                  minLength: 1
                  pattern: ^\d+(,\d+)*$
                  type: string
                easyApply:
                  enum:
                    - 'true'
                    - 'false'
                  maxLength: 500
                  minLength: 1
                  type: string
                employmentType:
                  maxLength: 500
                  minLength: 1
                  pattern: >-
                    ^(full-time|part-time|contract|temporary|internship)(,(full-time|part-time|contract|temporary|internship))*$
                  type: string
                experienceLevel:
                  maxLength: 500
                  minLength: 1
                  pattern: >-
                    ^(internship|entry|associate|mid-senior|director|executive)(,(internship|entry|associate|mid-senior|director|executive))*$
                  type: string
                functionId:
                  maxLength: 500
                  minLength: 1
                  pattern: >-
                    ^(acct|adm|advr|anls|art|bd|cnsl|cust|dist|dsgn|edu|eng|fin|genb|hcpr|hr|it|lgl|mgmt|mnfc|mrkt|othr|pr|prch|prdm|prjm|prod|qa|rsch|sale|sci|stra|supl|trng|wrt)(,(acct|adm|advr|anls|art|bd|cnsl|cust|dist|dsgn|edu|eng|fin|genb|hcpr|hr|it|lgl|mgmt|mnfc|mrkt|othr|pr|prch|prdm|prjm|prod|qa|rsch|sale|sci|stra|supl|trng|wrt))*$
                  type: string
                geoId:
                  maxLength: 500
                  minLength: 1
                  pattern: ^\d+$
                  type: string
                industryId:
                  maxLength: 500
                  minLength: 1
                  pattern: ^\d+(,\d+)*$
                  type: string
                location:
                  maxLength: 500
                  minLength: 1
                  type: string
                postedLimit:
                  enum:
                    - 24h
                    - week
                    - month
                  maxLength: 500
                  minLength: 1
                  type: string
                salary:
                  enum:
                    - 40k+
                    - 60k+
                    - 80k+
                    - 100k+
                    - 120k+
                    - 140k+
                    - 160k+
                    - 180k+
                    - 200k+
                  maxLength: 500
                  minLength: 1
                  type: string
                search:
                  maxLength: 500
                  minLength: 1
                  type: string
                sortBy:
                  enum:
                    - relevance
                    - date
                  maxLength: 500
                  minLength: 1
                  type: string
                under10Applicants:
                  enum:
                    - 'true'
                  maxLength: 500
                  minLength: 1
                  type: string
                workplaceType:
                  maxLength: 500
                  minLength: 1
                  pattern: ^(office|hybrid|remote)(,(office|hybrid|remote))*$
                  type: string
              type: object
            theirstack:
              additionalProperties: false
              properties:
                closed_at_gte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                closed_at_lte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                company_country_code_not:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: countries
                company_country_code_not_or_null:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: countries
                company_country_code_or:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: countries
                company_description_pattern_accent_insensitive:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                company_description_pattern_not:
                  items:
                    type: string
                  type: array
                company_description_pattern_or:
                  items:
                    type: string
                  type: array
                company_domain_not:
                  items:
                    type: string
                  type: array
                company_domain_or:
                  items:
                    type: string
                  type: array
                company_id_not:
                  items:
                    type: string
                  type: array
                company_id_or:
                  items:
                    type: string
                  type: array
                company_investors_or:
                  items:
                    type: string
                  type: array
                company_investors_partial_match_or:
                  items:
                    type: string
                  type: array
                company_keyword_slug_and:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                company_keyword_slug_not:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                company_keyword_slug_or:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                company_linkedin_url_exists:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                company_linkedin_url_or:
                  items:
                    type: string
                  type: array
                company_location_pattern_or:
                  items:
                    type: string
                  type: array
                company_name_case_insensitive_or:
                  items:
                    type: string
                  type: array
                company_name_not:
                  items:
                    type: string
                  type: array
                company_name_or:
                  items:
                    type: string
                  type: array
                company_name_partial_match_not:
                  items:
                    type: string
                  type: array
                company_name_partial_match_or:
                  items:
                    type: string
                  type: array
                company_tags_or:
                  items:
                    type: string
                  type: array
                company_technology_slug_and:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                company_technology_slug_not:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                company_technology_slug_or:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                company_type:
                  anyOf:
                    - enum:
                        - recruiting_agency
                        - direct_employer
                        - all
                      type: string
                    - type: 'null'
                discovered_at_gte:
                  anyOf:
                    - format: date-time
                      type: string
                    - format: date
                      type: string
                    - type: 'null'
                discovered_at_lte:
                  anyOf:
                    - format: date-time
                      type: string
                    - format: date
                      type: string
                    - type: 'null'
                discovered_at_max_age_days:
                  anyOf:
                    - type: integer
                    - type: 'null'
                discovered_at_min_age_days:
                  anyOf:
                    - type: integer
                    - type: 'null'
                easy_apply:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                easy_apply_or_null:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                employment_statuses_or:
                  anyOf:
                    - items:
                        enum:
                          - full_time
                          - part_time
                          - temporary
                          - internship
                          - contract
                          - freelance
                          - co_founder
                          - apprenticeship
                          - seasonal
                          - volunteer
                          - other
                        type: string
                      type: array
                    - type: 'null'
                final_url_exists:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                funding_stage_or:
                  items:
                    type: string
                  type: array
                hiring_managers_exists:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                industry_id_not:
                  items:
                    type: integer
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.industries
                industry_id_not_or_null:
                  items:
                    type: integer
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.industries
                industry_id_or:
                  items:
                    type: integer
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.industries
                industry_not:
                  items:
                    type: string
                  type: array
                industry_or:
                  items:
                    type: string
                  type: array
                is_closed:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                job_country_code_not:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: countries
                job_country_code_or:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: countries
                job_description_contains_not:
                  items:
                    type: string
                  type: array
                job_description_contains_or:
                  items:
                    type: string
                  type: array
                job_description_pattern_and:
                  items:
                    type: string
                  type: array
                job_description_pattern_case_sensitive_or:
                  items:
                    type: string
                  type: array
                job_description_pattern_is_case_insensitive:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                job_description_pattern_not:
                  items:
                    type: string
                  type: array
                job_description_pattern_or:
                  items:
                    type: string
                  type: array
                job_id_not:
                  items:
                    type: integer
                  type: array
                job_id_or:
                  items:
                    type: integer
                  type: array
                job_ids:
                  items:
                    type: integer
                  type: array
                job_keyword_slug_and:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                job_keyword_slug_not:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                job_keyword_slug_or:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                job_location_not:
                  items:
                    additionalProperties: false
                    properties:
                      id:
                        anyOf:
                          - type: integer
                          - type: 'null'
                    type: object
                  type: array
                job_location_or:
                  items:
                    additionalProperties: false
                    properties:
                      id:
                        anyOf:
                          - type: integer
                          - type: 'null'
                    type: object
                  type: array
                job_location_pattern_not:
                  items:
                    type: string
                  type: array
                job_location_pattern_or:
                  items:
                    type: string
                  type: array
                job_seniority_or:
                  items:
                    enum:
                      - c_level
                      - staff
                      - senior
                      - junior
                      - mid_level
                    type: string
                  type: array
                job_technology_slug_and:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                job_technology_slug_not:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                job_technology_slug_or:
                  items:
                    type: string
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                job_title_not:
                  items:
                    type: string
                  type: array
                job_title_or:
                  items:
                    type: string
                  type: array
                job_title_pattern_and:
                  items:
                    type: string
                  type: array
                job_title_pattern_not:
                  items:
                    type: string
                  type: array
                job_title_pattern_or:
                  items:
                    type: string
                  type: array
                last_funding_round_date_gte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                last_funding_round_date_lte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                max_employee_count:
                  anyOf:
                    - type: integer
                    - type: 'null'
                max_employee_count_or_null:
                  anyOf:
                    - type: integer
                    - type: 'null'
                max_funding_usd:
                  anyOf:
                    - type: integer
                    - type: 'null'
                max_revenue_usd:
                  anyOf:
                    - type: integer
                    - type: 'null'
                max_revenue_usd_or_null:
                  anyOf:
                    - type: integer
                    - type: 'null'
                max_salary_usd:
                  anyOf:
                    - type: number
                    - type: 'null'
                min_employee_count:
                  anyOf:
                    - type: integer
                    - type: 'null'
                min_employee_count_or_null:
                  anyOf:
                    - type: integer
                    - type: 'null'
                min_funding_usd:
                  anyOf:
                    - type: integer
                    - type: 'null'
                min_revenue_usd:
                  anyOf:
                    - type: integer
                    - type: 'null'
                min_revenue_usd_or_null:
                  anyOf:
                    - type: integer
                    - type: 'null'
                min_salary_usd:
                  anyOf:
                    - type: number
                    - type: 'null'
                only_jobs_with_hiring_managers:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                only_jobs_with_reports_to:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                only_yc_companies:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                order_by:
                  items:
                    additionalProperties: false
                    properties:
                      desc:
                        type: boolean
                      field:
                        enum:
                          - date_posted
                          - discovered_at
                          - salary
                          - job_title
                          - company
                          - num_jobs
                        type: string
                    type: object
                  type: array
                posted_at_gte:
                  anyOf:
                    - format: date
                      type: string
                    - format: date-time
                      type: string
                    - type: 'null'
                posted_at_lte:
                  anyOf:
                    - format: date
                      type: string
                    - format: date-time
                      type: string
                    - type: 'null'
                posted_at_max_age_days:
                  anyOf:
                    - type: integer
                    - type: 'null'
                posted_at_min_age_days:
                  anyOf:
                    - type: integer
                    - type: 'null'
                property_exists_and:
                  items:
                    enum:
                      - company_object.domain
                      - company_object.linkedin_url
                      - final_url
                      - hiring_team
                      - employment_statuses
                    type: string
                  type: array
                property_exists_or:
                  items:
                    enum:
                      - company_object.domain
                      - company_object.linkedin_url
                      - final_url
                      - hiring_team
                      - employment_statuses
                    type: string
                  type: array
                remote:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                reports_to_exists:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                scraper_name_pattern_or:
                  items:
                    type: string
                  type: array
                url_domain_not:
                  items:
                    type: string
                  type: array
                url_domain_or:
                  items:
                    type: string
                  type: array
                workplace_types_or:
                  anyOf:
                    - items:
                        enum:
                          - on_site
                          - hybrid
                          - remote
                        type: string
                      type: array
                    - type: 'null'
              type: object
            up2data:
              additionalProperties: false
              properties:
                company_url:
                  type: string
                filters:
                  additionalProperties: false
                  minProperties: 1
                  properties:
                    function:
                      items:
                        type: string
                      maxItems: 20
                      minItems: 1
                      type: array
                    job_type:
                      items:
                        enum:
                          - full_time
                          - part_time
                          - contract
                          - temporary
                          - internship
                          - volunteer
                          - other
                        type: string
                      maxItems: 20
                      minItems: 1
                      type: array
                    locations:
                      items:
                        type: string
                      maxItems: 20
                      minItems: 1
                      type: array
                    posted_within_days:
                      maximum: 365
                      minimum: 0
                      type: integer
                    seniority:
                      items:
                        enum:
                          - entry
                          - senior
                          - manager
                          - director
                          - executive
                        type: string
                      maxItems: 20
                      minItems: 1
                      type: array
                    workplace_type:
                      items:
                        enum:
                          - remote
                          - hybrid
                          - onsite
                        type: string
                      maxItems: 20
                      minItems: 1
                      type: array
                  type: object
                keywords:
                  items:
                    type: string
                  maxItems: 20
                  minItems: 1
                  type: array
                with_hiring_team:
                  type: boolean
              type: object
          type: object
        routing:
          additionalProperties: false
          dependentRequired:
            fallback_on:
              - providers
          description: >-
            Optional source chain. One source runs alone; multiple sources are
            tried in order. All selected sources must support the request.
            Provider options require a matching one-source chain.
          properties:
            fallback_on:
              description: >-
                When to try the next source. Defaults to error and empty; has no
                effect for one source.
              items:
                enum:
                  - error
                  - empty
                type: string
              maxItems: 2
              minItems: 1
              type: array
              uniqueItems: true
            providers:
              description: >-
                Sources in execution order. One entry uses only that source.
                Omit to use the default chain.
              items:
                enum:
                  - theirstack
                  - fetchin
                  - harvest
                  - up2data
                type: string
              maxItems: 4
              minItems: 1
              type: array
              uniqueItems: true
          type: object
        titles:
          description: Match any of these job titles.
          items:
            maxLength: 200
            minLength: 1
            type: string
          maxItems: 20
          minItems: 1
          type: array
          uniqueItems: true
        workplace_types:
          description: Match any of these workplace types.
          items:
            enum:
              - remote
              - hybrid
              - on_site
            type: string
          maxItems: 3
          minItems: 1
          type: array
          uniqueItems: true
      type: object
    job_searchOutput:
      additionalProperties: false
      properties:
        data:
          items:
            additionalProperties: false
            properties:
              additional_fields:
                additionalProperties: false
                properties:
                  fetchin:
                    additionalProperties: false
                    properties:
                      company:
                        additionalProperties: false
                        description: >-
                          The hiring company. `universalName`, `companyId`,
                          `url` and `logoUrl` are present when the employer has
                          a company page.
                        properties:
                          companyId:
                            type: string
                          logoUrl:
                            type: string
                          name:
                            type: string
                          universalName:
                            type: string
                          url:
                            type: string
                        type: object
                      easyApply:
                        description: >-
                          Whether the job takes applications without leaving the
                          platform.
                        type: boolean
                      id:
                        description: The job posting's ID.
                        type: string
                      location:
                        additionalProperties: false
                        properties:
                          text:
                            description: >-
                              The location line, with the workplace type in
                              parentheses.
                            type: string
                        type: object
                      postedDate:
                        description: When the job was posted (or reposted).
                        format: date-time
                        type: string
                      promoted:
                        description: Whether the posting is a paid promotion.
                        type: boolean
                      reposted:
                        description: Whether the employer reposted the job.
                        type: boolean
                      salary:
                        description: >-
                          The pay range the posting displays, as written. Absent
                          when it shows none.
                        type: string
                      title:
                        type: string
                      url:
                        type: string
                      workplaceType:
                        description: When the posting states it.
                        enum:
                          - office
                          - hybrid
                          - remote
                        type: string
                    type: object
                  harvest:
                    additionalProperties: false
                    properties:
                      company:
                        additionalProperties: false
                        properties:
                          linkedinUrl:
                            type: string
                          name:
                            type: string
                          universalName:
                            type: string
                        type: object
                      easyApply:
                        type: boolean
                      id:
                        type: string
                      location:
                        additionalProperties: false
                        properties:
                          linkedinText:
                            type: string
                        type: object
                      postedDate:
                        format: date-time
                        type: string
                      title:
                        type: string
                      url:
                        type: string
                    type: object
                  theirstack:
                    additionalProperties: false
                    properties:
                      avg_annual_salary_usd:
                        anyOf:
                          - type: number
                          - type: 'null'
                      cities:
                        anyOf:
                          - items:
                              type: string
                            type: array
                          - type: 'null'
                      closed_at:
                        anyOf:
                          - format: date-time
                            type: string
                          - type: 'null'
                      company:
                        type: string
                      company_domain:
                        anyOf:
                          - type: string
                          - type: 'null'
                      company_object:
                        additionalProperties: false
                        properties:
                          alexa_ranking:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          annual_revenue_usd:
                            anyOf:
                              - type: number
                              - type: 'null'
                          annual_revenue_usd_readable:
                            anyOf:
                              - type: string
                              - type: 'null'
                          apollo_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          city:
                            anyOf:
                              - type: string
                              - type: 'null'
                          company_keywords:
                            anyOf:
                              - items:
                                  type: string
                                type: array
                              - type: 'null'
                          company_tags:
                            items:
                              type: string
                            type: array
                          country:
                            anyOf:
                              - type: string
                              - type: 'null'
                          country_code:
                            anyOf:
                              - type: string
                              - type: 'null'
                          domain:
                            anyOf:
                              - type: string
                              - type: 'null'
                          employee_count:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          employee_count_range:
                            anyOf:
                              - type: string
                              - type: 'null'
                          founded_year:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          funding_stage:
                            anyOf:
                              - enum:
                                  - angel
                                  - convertible_note
                                  - debt_financing
                                  - equity_crowdfunding
                                  - other
                                  - private_equity
                                  - seed
                                  - series_a
                                  - series_b
                                  - series_c
                                  - series_d
                                  - series_e
                                  - series_f
                                  - series_g
                                  - series_h
                                  - venture_round_not_specified
                                  - series_i
                                  - series_j
                                  - undisclosed
                                  - series_unknown
                                  - pre_seed
                                  - post_ipo_secondary
                                  - post_ipo_equity
                                  - post_ipo_debt
                                  - non_equity_assistance
                                  - late_vc
                                  - initial_coin_offering
                                  - growth_equity_vc
                                  - grant
                                  - early_vc
                                  - corporate_round
                                  - secondary_market
                                  - product_crowdfunding
                                type: string
                              - type: 'null'
                          has_blurred_data:
                            type: boolean
                          id:
                            type: string
                          industry:
                            anyOf:
                              - type: string
                              - type: 'null'
                          industry_id:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          investors:
                            anyOf:
                              - items:
                                  type: string
                                type: array
                              - type: 'null'
                          is_recruiting_agency:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          keyword_slugs:
                            items:
                              type: string
                            type: array
                          last_funding_round_amount_readable:
                            anyOf:
                              - type: string
                              - type: 'null'
                          last_funding_round_date:
                            anyOf:
                              - format: date
                                type: string
                              - type: 'null'
                          linkedin_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          linkedin_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          logo:
                            anyOf:
                              - type: string
                              - type: 'null'
                          long_description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          name:
                            type: string
                          num_buying_intent_topics:
                            type: integer
                          num_jobs:
                            type: integer
                          num_jobs_found:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          num_jobs_last_30_days:
                            type: integer
                          num_keywords:
                            type: integer
                          num_technologies:
                            type: integer
                          possible_domains:
                            items:
                              type: string
                            type: array
                          postal_code:
                            anyOf:
                              - type: string
                              - type: 'null'
                          publicly_traded_exchange:
                            anyOf:
                              - type: string
                              - type: 'null'
                          publicly_traded_symbol:
                            anyOf:
                              - type: string
                              - type: 'null'
                          seo_description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          technology_names:
                            anyOf:
                              - items:
                                  type: string
                                type: array
                              - type: 'null'
                          technology_slugs:
                            anyOf:
                              - items:
                                  type: string
                                type: array
                              - type: 'null'
                          total_funding_usd:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url_source:
                            anyOf:
                              - type: string
                              - type: 'null'
                          yc_batch:
                            anyOf:
                              - type: string
                              - type: 'null'
                        type: object
                      continents:
                        anyOf:
                          - items:
                              type: string
                            type: array
                          - type: 'null'
                      countries:
                        anyOf:
                          - items:
                              type: string
                            type: array
                          - type: 'null'
                      country:
                        anyOf:
                          - type: string
                          - type: 'null'
                      country_code:
                        anyOf:
                          - type: string
                          - type: 'null'
                      country_codes:
                        anyOf:
                          - items:
                              anyOf:
                                - type: string
                                - type: 'null'
                            type: array
                          - type: 'null'
                      date_posted:
                        format: date
                        type: string
                      date_reposted:
                        anyOf:
                          - format: date
                            type: string
                          - type: 'null'
                      description:
                        anyOf:
                          - type: string
                          - type: 'null'
                      discovered_at:
                        format: date-time
                        type: string
                      easy_apply:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      employment_statuses:
                        items:
                          enum:
                            - full_time
                            - part_time
                            - temporary
                            - internship
                            - contract
                            - freelance
                            - co_founder
                            - apprenticeship
                            - seasonal
                            - volunteer
                            - other
                          type: string
                        type: array
                      final_url:
                        anyOf:
                          - type: string
                          - type: 'null'
                      has_blurred_data:
                        type: boolean
                      hiring_team:
                        anyOf:
                          - items:
                              additionalProperties: false
                              properties:
                                first_name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                full_name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                image_url:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                linkedin_url:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                role:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                thumbnail_url:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                              type: object
                            type: array
                          - type: 'null'
                      hybrid:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      id:
                        type: integer
                      job_title:
                        type: string
                      keyword_slugs:
                        items:
                          type: string
                        type: array
                      latitude:
                        anyOf:
                          - type: number
                          - type: 'null'
                      location:
                        anyOf:
                          - type: string
                          - type: 'null'
                      locations:
                        items:
                          additionalProperties: false
                          properties:
                            address:
                              type: 'null'
                            admin1_code:
                              anyOf:
                                - type: string
                                - type: 'null'
                            admin1_name:
                              anyOf:
                                - type: string
                                - type: 'null'
                            admin2_code:
                              anyOf:
                                - type: string
                                - type: 'null'
                            admin2_name:
                              anyOf:
                                - type: string
                                - type: 'null'
                            city:
                              anyOf:
                                - type: string
                                - type: 'null'
                            continent:
                              anyOf:
                                - type: string
                                - type: 'null'
                            country_code:
                              anyOf:
                                - type: string
                                - type: 'null'
                            country_name:
                              anyOf:
                                - type: string
                                - type: 'null'
                              readOnly: true
                            display_name:
                              readOnly: true
                              type: string
                            feature_code:
                              anyOf:
                                - type: string
                                - type: 'null'
                            id:
                              anyOf:
                                - type: integer
                                - type: 'null'
                            latitude:
                              anyOf:
                                - type: number
                                - type: 'null'
                            longitude:
                              anyOf:
                                - type: number
                                - type: 'null'
                            name:
                              anyOf:
                                - type: string
                                - type: 'null'
                            postal_code:
                              anyOf:
                                - type: string
                                - type: 'null'
                            state:
                              anyOf:
                                - type: string
                                - type: 'null'
                            state_code:
                              anyOf:
                                - type: string
                                - type: 'null'
                            type:
                              anyOf:
                                - enum:
                                    - city
                                    - region
                                    - country
                                    - continent
                                  type: string
                                - type: 'null'
                          type: object
                        type: array
                      long_location:
                        anyOf:
                          - type: string
                          - type: 'null'
                      longitude:
                        anyOf:
                          - type: number
                          - type: 'null'
                      manager_roles:
                        anyOf:
                          - items:
                              type: string
                            type: array
                          - type: 'null'
                      matching_phrase_segments:
                        anyOf:
                          - additionalProperties:
                              items:
                                additionalProperties: false
                                properties:
                                  is_match:
                                    type: boolean
                                  text:
                                    type: string
                                required:
                                  - text
                                  - is_match
                                type: object
                              type: array
                            type: object
                          - type: 'null'
                      matching_phrases:
                        anyOf:
                          - items:
                              anyOf:
                                - type: string
                                - type: 'null'
                            type: array
                          - type: 'null'
                      matching_words:
                        anyOf:
                          - items:
                              anyOf:
                                - type: string
                                - type: 'null'
                            type: array
                          - type: 'null'
                      max_annual_salary:
                        anyOf:
                          - type: integer
                          - type: 'null'
                      max_annual_salary_usd:
                        anyOf:
                          - type: number
                          - type: 'null'
                      max_salary:
                        anyOf:
                          - type: number
                          - type: 'null'
                      min_annual_salary:
                        anyOf:
                          - type: integer
                          - type: 'null'
                      min_annual_salary_usd:
                        anyOf:
                          - type: number
                          - type: 'null'
                      min_salary:
                        anyOf:
                          - type: number
                          - type: 'null'
                      normalized_title:
                        anyOf:
                          - type: string
                          - type: 'null'
                      postal_code:
                        anyOf:
                          - type: string
                          - type: 'null'
                      remote:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      reposted:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      salary_currency:
                        anyOf:
                          - type: string
                          - type: 'null'
                      salary_period:
                        anyOf:
                          - enum:
                              - hour
                              - day
                              - week
                              - biweek
                              - month
                              - quarter
                              - year
                            type: string
                          - type: 'null'
                      salary_string:
                        anyOf:
                          - type: string
                          - type: 'null'
                      seniority:
                        anyOf:
                          - enum:
                              - c_level
                              - staff
                              - senior
                              - junior
                              - mid_level
                            type: string
                          - type: 'null'
                      short_location:
                        anyOf:
                          - type: string
                          - type: 'null'
                      source_url:
                        type: string
                      state_code:
                        anyOf:
                          - type: string
                          - type: 'null'
                      technology_slugs:
                        items:
                          type: string
                        type: array
                      url:
                        type: string
                    type: object
                  up2data:
                    additionalProperties: false
                    description: One job search result.
                    properties:
                      company:
                        additionalProperties: false
                        properties:
                          linkedin_id:
                            type: string
                          logo_url:
                            type: string
                          name:
                            type: string
                          url:
                            type: string
                        type: object
                      description_snippet:
                        type: string
                      employment_type:
                        type: string
                      hiring_team:
                        items:
                          additionalProperties: false
                          properties:
                            full_name:
                              type: string
                            headline:
                              type: string
                            is_job_poster:
                              type: boolean
                            linkedin_id:
                              type: string
                            profile_picture_url:
                              type: string
                            public_identifier:
                              type: string
                            url:
                              type: string
                            urn:
                              type: string
                          type: object
                        type: array
                      job_id:
                        type: string
                      location:
                        type: string
                      posted_at:
                        type: string
                      title:
                        type: string
                      url:
                        type: string
                      workplace_type:
                        type: string
                    type: object
                type: object
              closed_at:
                type:
                  - string
                  - 'null'
              company:
                additionalProperties: false
                properties:
                  domain:
                    type: string
                  linkedin_url:
                    type: string
                  name:
                    type: string
                type: object
              country_code:
                type: string
              description:
                type: string
              description_snippet:
                type: string
              discovered_at:
                type: string
              employment_types:
                items:
                  type: string
                type: array
              final_url:
                type: string
              hiring_team:
                items:
                  additionalProperties: false
                  properties:
                    linkedin_url:
                      type: string
                    name:
                      type: string
                    role:
                      type: string
                  type: object
                type: array
              hybrid:
                type:
                  - boolean
                  - 'null'
              id:
                type: string
              location:
                type: string
              posted_at:
                type: string
              provider_id:
                type: string
              remote:
                type:
                  - boolean
                  - 'null'
              salary:
                additionalProperties: false
                properties:
                  currency:
                    type: string
                  display:
                    type: string
                  max:
                    type:
                      - number
                      - 'null'
                  max_annual_usd:
                    type:
                      - number
                      - 'null'
                  min:
                    type:
                      - number
                      - 'null'
                  min_annual_usd:
                    type:
                      - number
                      - 'null'
                  period:
                    type:
                      - string
                      - 'null'
                type: object
              seniority:
                type: string
              source_url:
                type: string
              technologies:
                items:
                  type: string
                type: array
              title:
                type: string
              url:
                type: string
            required:
              - id
              - provider_id
            type: object
          maxItems: 25
          type:
            - array
            - 'null'
        error:
          additionalProperties: false
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
            - code
            - message
            - retryable
          type:
            - object
            - 'null'
        fulfillment:
          properties:
            field_sources:
              additionalProperties:
                items:
                  properties:
                    observation_id:
                      type: string
                    observed_at:
                      properties: {}
                      type: object
                    provider:
                      type: string
                    url:
                      type: string
                  type: object
                type: array
              type: object
            missing_fields:
              items:
                type: string
              type: array
            satisfied:
              type: boolean
          type: object
        id:
          type: string
        pagination:
          additionalProperties: false
          properties:
            has_more:
              type:
                - boolean
                - 'null'
            limit:
              maximum: 25
              minimum: 1
              type: integer
            next_page:
              minimum: 0
              type:
                - integer
                - 'null'
            page:
              minimum: 0
              type: integer
            provider:
              enum:
                - theirstack
                - fetchin
                - harvest
                - up2data
              type: string
            returned:
              maximum: 25
              minimum: 0
              type: integer
            total:
              minimum: 0
              type:
                - integer
                - 'null'
          required:
            - page
            - limit
            - returned
            - total
            - has_more
            - next_page
          type: object
        routing:
          additionalProperties: false
          properties:
            attempts:
              items:
                additionalProperties: false
                properties:
                  outcome:
                    enum:
                      - success
                      - partial
                      - pending
                      - error
                      - empty
                    type: string
                  provider:
                    type: string
                  requests:
                    minimum: 0
                    type: integer
                required:
                  - provider
                  - outcome
                  - requests
                type: object
              type: array
            mode:
              enum:
                - auto
                - single
                - fallback
              type: string
            selected_provider:
              type: string
          required:
            - mode
          type: object
        sources:
          items:
            additionalProperties: false
            properties:
              observation_id:
                type: string
              observed_at:
                format: date-time
                type: string
              provider:
                type: string
              url:
                type: string
            required:
              - provider
            type: object
          type: array
        status:
          enum:
            - completed
            - partial
            - not_found
            - failed
            - pending
          type: string
        tool:
          const: job_search
          type: string
        usage:
          additionalProperties: false
          properties:
            credit_units:
              minimum: 0
              type: integer
            credits:
              type: string
            unit:
              const: record
              type: string
          required:
            - credit_units
            - credits
            - unit
          type:
            - object
            - 'null'
        version:
          const: '1'
          type: string
        warnings:
          items:
            additionalProperties: false
            properties:
              code:
                type: string
              message:
                type: string
            required:
              - code
              - message
            type: object
          type: array
      required:
        - id
        - tool
        - version
        - status
        - data
        - sources
        - usage
        - error
      type: object
    ToolError:
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object
  securitySchemes:
    ApiKey:
      scheme: bearer
      type: http

````

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