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

# Find companies by tech stack (preview)

> Count and preview companies using a given technology stack

Size a segment of companies by the technologies they use before spending any
credits. This is the free, first step of the two-step tech-stack search:

1. **Preview** (this endpoint) — returns the exact total match count plus a
   blurred company sample. No credits.
2. **[Extract](/api-reference/endpoints/signals/tech_stack)** — starts an async
   import and delivers the full company records to your webhook. Spends
   enrichment credits.

Technographics are powered by TheirStack.

## Credits and rate limits

* Credits: **free** — no credits are spent
* Authentication: standard v2 scheme (`X-API-KEY`)

## Resolving technology slugs

`stacks` and `excluded_stacks` take technology **slugs**, not display names.
Resolve names to slugs with the
[Technology slug lookup](/api-reference/endpoints/miscellaneous/technologies)
endpoint.

## Example request

```json theme={null}
{
  "stacks": ["shopify", "webflow"],
  "stack_match": "or",
  "countries": ["US", "FR"],
  "included_industries": ["2190"],
  "company_size": ["11-50", "51-200"]
}
```

## Example response

```json theme={null}
{
  "total_count": 428,
  "preview": [
    {
      "name": "Acme",
      "domain": "acme.com",
      "website": "https://acme.com",
      "industry": "Software Development",
      "location": "Paris France",
      "city": "Paris",
      "country": "France",
      "linkedin_url": "https://linkedin.com/company/acme",
      "technologies_found": [
        { "technology_name": "Shopify", "confidence": "high", "job_mentions": 3 }
      ]
    }
  ]
}
```

Company identifiers in the preview may be blurred; `total_count` is exact.

For the complete list of industry IDs used by `included_industries` /
`excluded_industries`, see the
[LinkedIn Industry List](https://docs.google.com/spreadsheets/d/1qTFPVfcSHnL5PU1AcQlzD8mCmfSICKJ4WuU-OBGhkdI/edit?gid=0#gid=0).


## OpenAPI

````yaml POST /intents/accounts/stack/preview
openapi: 3.0.1
info:
  title: Pipecorn Accounts API
  description: Pipecorn Accounts API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://app.pipecorn.com/api/v2/
security:
  - defaultApiKey: []
paths:
  /intents/accounts/stack/preview:
    post:
      summary: Preview companies by tech stack
      description: >-
        Return the total number of companies matching a technology-stack query
        plus a blurred sample. Free — spends no credits. Only documented fields
        are allowed; unknown keys return 422.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - stacks
              properties:
                stacks:
                  type: array
                  items:
                    type: string
                  description: >-
                    Technology slugs to match. Resolve names to slugs with GET
                    /accounts/technologies.
                  example:
                    - shopify
                    - webflow
                stack_match:
                  type: string
                  enum:
                    - or
                    - and
                  default: or
                  description: >-
                    How `stacks` combine. `or` matches companies using any
                    listed technology; `and` requires all of them.
                  example: or
                excluded_stacks:
                  type: array
                  items:
                    type: string
                  description: Technology slugs to exclude.
                  example:
                    - wordpress
                countries:
                  type: array
                  items:
                    type: string
                  description: ISO country codes, OR-matched against the company's country.
                  example:
                    - US
                    - FR
                included_industries:
                  type: array
                  items:
                    type: string
                  description: LinkedIn industry IDs to include, OR-matched.
                  example:
                    - '2190'
                    - '34'
                excluded_industries:
                  type: array
                  items:
                    type: string
                  description: LinkedIn industry IDs to exclude.
                  example:
                    - '27'
                company_size:
                  type: array
                  items:
                    type: string
                    enum:
                      - Self-employed
                      - 1-10
                      - 11-50
                      - 51-200
                      - 201-500
                      - 501-1000
                      - 1001-5000
                      - 5001-10000
                      - 10001+
                  description: Company size display buckets to include.
                  example:
                    - 11-50
                    - 51-200
      responses:
        '200':
          description: Preview count and blurred company sample
          content:
            application/json:
              schema:
                type: object
                required:
                  - total_count
                  - preview
                properties:
                  total_count:
                    type: integer
                    description: Exact number of matching companies.
                    example: 428
                  preview:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          example: Acme
                        domain:
                          type: string
                          example: acme.com
                        website:
                          type: string
                          example: https://acme.com
                        industry:
                          type: string
                          example: Software Development
                        location:
                          type: string
                          example: Paris France
                        city:
                          type: string
                          example: Paris
                        country:
                          type: string
                          example: France
                        linkedin_url:
                          type: string
                          example: https://linkedin.com/company/acme
                        technologies_found:
                          type: array
                          items:
                            type: object
                            properties:
                              technology_name:
                                type: string
                                example: Shopify
                              confidence:
                                type: string
                                example: high
                              job_mentions:
                                type: integer
                                example: 3
                    description: >-
                      Sample of matching companies (up to 25). Company
                      identifiers may be blurred; the count is exact.
        '400':
          description: Bad request (stacks missing or empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Unprocessable entity (invalid filters or unknown parameters)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    defaultApiKey:
      type: apiKey
      in: header
      name: X-API-KEY

````