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

# Find technologies

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

Read documented public company\_lookup data. Returned fields follow the documented dataset; unavailable fields remain absent.

## Usage

* Normalized search records retain reviewed fields outside their common schema in additional\_fields.\<provider>. Source-native data tools already expose their documented business fields directly in data.

## 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/company_technologies/execute" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: REPLACE_WITH_UNIQUE_REQUEST_ID' \
  --data '{
  "url": "https://www.linkedin.com/company/example"
}'
```

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/company_technologies/plan" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "url": "https://www.linkedin.com/company/example"
}'
```

## 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",
    "url": "https://www.linkedin.com/company/example"
  },
  "name": "company_technologies"
}
```

## 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`. Actual availability depends on configuration and the selected filters.

## Credits and continuation

1 credits per usable page. Empty and failed responses are not charged. Idempotent replays do not charge again.

Returns a bounded source page. Continue using the returned pagination.provider and cursor, or next\_page where provided. Preserve every filter and page size. Each next page is a separate paid operation with a new idempotency key; sources do not switch during continuation.

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/company_technologies`.

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/company_technologies/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/company_technologies/execute:
    post:
      tags:
        - Tools
      summary: Find technologies
      description: >-
        Read documented public company_lookup data. Returned fields follow the
        documented dataset; unavailable fields remain absent.


        Normalized search records retain reviewed fields outside their common
        schema in additional_fields.<provider>. Source-native data tools already
        expose their documented business fields directly in data.


        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 credits per usable page. Empty and failed responses are not charged.
        Idempotent replays do not charge again.


        Returns a bounded source page. Continue using the returned
        pagination.provider and cursor, or next_page where provided. Preserve
        every filter and page size. Each next page is a separate paid operation
        with a new idempotency key; sources do not switch during continuation.


        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: company_technologiesExecute
      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:
              url: https://www.linkedin.com/company/example
            schema:
              $ref: '#/components/schemas/company_technologiesInput'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/company_technologiesOutput'
          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:
    company_technologiesInput:
      additionalProperties: false
      oneOf:
        - required:
            - url
        - required:
            - domain
      properties:
        cursor:
          description: Continue the same source and target using the returned cursor.
          maxLength: 16384
          type: string
        domain:
          description: Company website domain as alternative to LinkedIn company URL.
          type: string
        provider_options:
          additionalProperties: false
          description: Reviewed provider fields. Nonempty options pin their source.
          maxProperties: 1
          properties:
            theirstack:
              additionalProperties: false
              description: >-
                Filter technologies and buying intent topics detected for a
                company.
              properties:
                confidence_or:
                  default: []
                  description: >-
                    Only return keywords (technologies or buying intent topics)
                    detected with any of these confidence levels. Available
                    values: "high", "medium", "low"
                  items:
                    enum:
                      - low
                      - medium
                      - high
                    type: string
                  title: Confidence Or
                  type: array
                first_date_found_gte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                  description: >-
                    Only return keywords (technologies or buying intent topics)
                    where the first time they were found was after or on this
                    date. Format: "YYYY-MM-DD"
                  title: First Date Found Gte
                first_date_found_lte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                  description: >-
                    Only return keywords (technologies or buying intent topics)
                    where the first time they were found was before or on this
                    date. Format: "YYYY-MM-DD"
                  title: First Date Found Lte
                include_total_results:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                  default: false
                  description: >-
                    When enabled, calculates and returns `total_results` and
                    `total_companies` fields in the response. WARNING: This
                    significantly slows down responses as it requires reading
                    the entire dataset. Recommended usage: enable only for the
                    initial request to get totals, then disable for subsequent
                    pagination requests.
                  title: Include Total Results
                keyword_category_slug_or:
                  default: []
                  description: >-
                    Only return keywords from any of these categories. Case
                    sensitive. Pass slugs. Check out all keyword categories at
                    [GET
                    /v1/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/list_keyword_categories_v1)
                  items:
                    type: string
                  title: Keyword Category Slug Or
                  type: array
                keyword_parent_category_slug_or:
                  default: []
                  description: >-
                    Only return keywords from any of these parent categories.
                    Case sensitive. Pass slugs. Check out all keyword categories
                    at [GET
                    /v1/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/list_keyword_categories_v1)
                  items:
                    type: string
                  title: Keyword Parent Category Slug Or
                  type: array
                keyword_slug_or:
                  default: []
                  description: >-
                    Only return these keywords (technologies or buying intent
                    topics). Case sensitive. Pass slugs. Check out all keywords
                    at [GET
                    /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)
                  items:
                    type: string
                  title: Keyword Slug Or
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
                last_date_found_gte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                  description: >-
                    Only return keywords (technologies or buying intent topics)
                    where the last time they were found was after or on this
                    date. Format: "YYYY-MM-DD"
                  title: Last Date Found Gte
                last_date_found_lte:
                  anyOf:
                    - format: date
                      type: string
                    - type: 'null'
                  description: >-
                    Only return keywords (technologies or buying intent topics)
                    where the last time they were found was before or on this
                    date. Format: "YYYY-MM-DD"
                  title: Last Date Found Lte
                max_jobs:
                  anyOf:
                    - type: integer
                    - type: 'null'
                  description: >-
                    Maximum number of jobs in which each company mentions the
                    keyword (technology or buying intent topic)
                  title: Max Jobs
                max_rank:
                  anyOf:
                    - type: integer
                    - type: 'null'
                  description: >-
                    The rank measures how common a keyword (technology or buying
                    intent topic) is within its category for a company. The
                    keyword most mentioned among similar ones by a company has a
                    rank of 1, the second 2, etc. Useful to keep only the
                    primary technology or topic of each category.
                  title: Max Rank
                min_jobs:
                  anyOf:
                    - type: integer
                    - type: 'null'
                  description: >-
                    Minimum number of jobs in which each company mentions the
                    keyword (technology or buying intent topic)
                  title: Min Jobs
                min_relative_occurrence:
                  anyOf:
                    - type: number
                    - type: 'null'
                  description: >-
                    Minimum value of relative_occurrence_within_category for
                    each keyword (technology or buying intent topic). Higher
                    values increase the probability that the company actually
                    uses the technology or cares about the topic, because a
                    higher share of the mentions within that category are of
                    this keyword.
                  title: Min Relative Occurrence
                order_by:
                  default:
                    - desc: true
                      field: confidence
                    - desc: true
                      field: jobs
                  description: >-
                    List of column objects. You can pass several columns to
                    order by, in order of priority. Only `field` is required,
                    `desc` is True by default.
                  items:
                    additionalProperties: false
                    properties:
                      desc:
                        default: true
                        description: Whether to order by descending or ascending values
                        title: Desc
                        type: boolean
                      field:
                        description: Order the results by some of these fields
                        enum:
                          - null
                          - jobs
                          - jobs_last_7_days
                          - jobs_last_30_days
                          - jobs_last_180_days
                          - last_date_found
                          - first_date_found
                          - relative_occurrence_within_category
                          - theirstack_score
                          - confidence
                        title: Field
                    title: ColumnSortCompanyTechDetails
                    type: object
                  title: Order By
                  type: array
                technology_category_slug_or:
                  default: []
                  deprecated: true
                  description: >-
                    Deprecated: use `keyword_category_slug_or` instead. Only
                    return keywords from any of these categories. Case
                    sensitive. Pass slugs.
                  items:
                    type: string
                  title: Technology Category Slug Or
                  type: array
                technology_parent_category_slug_or:
                  default: []
                  deprecated: true
                  description: >-
                    Deprecated: use `keyword_parent_category_slug_or` instead.
                    Only return keywords from any of these parent categories.
                    Case sensitive. Pass slugs.
                  items:
                    type: string
                  title: Technology Parent Category Slug Or
                  type: array
                technology_slug_or:
                  default: []
                  deprecated: true
                  description: >-
                    Deprecated: use `keyword_slug_or` instead. Only return these
                    technologies. Case sensitive. Pass slugs.
                  items:
                    type: string
                  title: Technology Slug Or
                  type: array
                  x-plyne-catalog:
                    helper: search_catalog
                    id: theirstack.keywords
              title: TechnographicsFilters
              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
                type: string
              maxItems: 1
              minItems: 1
              type: array
              uniqueItems: true
          type: object
        url:
          description: Target LinkedIn company_lookup URL.
          maxLength: 2048
          minLength: 1
          type: string
      type: object
    company_technologiesOutput:
      additionalProperties: false
      properties:
        data:
          items:
            additionalProperties: false
            description: Response schema for /companies/keywords (no deprecated fields).
            properties:
              confidence:
                description: How confident we are that the company uses this technology
                enum:
                  - low
                  - medium
                  - high
                title: Confidence
                type: string
              first_date_found:
                description: >-
                  Date when the keyword was first mentioned by the company in a
                  job post
                format: date
                title: First Date Found
                type: string
              jobs:
                description: Number of jobs found mentioning this technology
                title: Jobs
                type: integer
              jobs_last_180_days:
                description: >-
                  Number of jobs from the given company mentioning this
                  technology in the last 180 days
                title: Jobs Last 180 Days
                type: integer
              jobs_last_30_days:
                description: >-
                  Number of jobs from the given company mentioning this
                  technology in the last 30 days
                title: Jobs Last 30 Days
                type: integer
              jobs_last_7_days:
                description: >-
                  Number of jobs from the given company mentioning this
                  technology in the last 7 days
                title: Jobs Last 7 Days
                type: integer
              last_date_found:
                description: >-
                  Date when the keyword was last mentioned by the company in a
                  job post
                format: date
                title: Last Date Found
                type: string
              rank_within_category:
                description: >-
                  Measures how common this technology is among the company's
                  jobs, compared to other technologies in the same category. The
                  most mentioned technology in its category will have a rank of
                  1. This helps you infer which is the technology the company is
                  most likely to be using, when they mention several
                  technologies that belong to the same category.
                title: Rank Within Category
                type: integer
              relative_occurrence_within_category:
                description: >-
                  Measures the relative occurance of this technology among other
                  technologies in the same category, in jobs by this company. If
                  there are 10 jobs where a company mentions 3 categories, and
                  they appear in 8, 3 and 2 jobs respectively, its relative
                  occurrences will be 0.8, 0.3 and 0.2. This helps you infer how
                  likely it is that the company is using this technology, when
                  they mention several technologies that belong to the same
                  category.
                title: Relative Occurrence Within Category
                type: number
              technology:
                additionalProperties: false
                properties:
                  category:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Category of the keyword
                    title: Category
                  category_slug:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Slug of the category of the keyword
                    title: Category Slug
                  logo:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Logo of the keyword
                    title: Logo
                  logo_thumbnail:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Thumbnail of the keyword
                    title: Logo Thumbnail
                  name:
                    title: Name
                    type: string
                  parent_category:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Parent category of the keyword
                    title: Parent Category
                  parent_category_slug:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Slug of the parent category of the keyword
                    title: Parent Category Slug
                  slug:
                    description: Slug of the keyword
                    title: Slug
                    type: string
                  type:
                    anyOf:
                      - enum:
                          - technology
                          - software_product
                          - technology_concept
                          - operational_activity
                          - strategic_initiative
                          - metric_or_concept
                          - product_or_service_offered
                          - regulation
                          - threat_or_risk
                          - event
                          - commodity
                          - industry_vertical
                          - physical_equipment
                          - medical_research
                          - government_body
                        title: KeywordType
                        type: string
                      - type: 'null'
                    description: >-
                      Type of the keyword (e.g. technology,
                      operational_activity)
                required:
                  - name
                  - slug
                title: KeywordExtended
                type: object
            required:
              - technology
              - confidence
              - jobs
              - jobs_last_7_days
              - jobs_last_30_days
              - jobs_last_180_days
              - first_date_found
              - last_date_found
              - rank_within_category
              - relative_occurrence_within_category
            title: KeywordFoundV1
            type: object
          title: Data
          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:
          properties:
            cursor:
              type: string
            has_more:
              type:
                - boolean
                - 'null'
            limit:
              type: integer
            provider:
              enum:
                - theirstack
            returned:
              type: integer
          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: company_technologies
          type: string
        usage:
          additionalProperties: false
          properties:
            credit_units:
              minimum: 0
              type: integer
            credits:
              type: string
            unit:
              const: page
          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.