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

# Search companies API

> Search and filter companies with criteria like country, industry, employee count, founding year, and text search. Results sorted by LinkedIn member count. Data from 25.4M company records.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I search companies by name?">
    Yes. Use the `search` query parameter with at least 2 characters. It matches against company names and descriptions. Combine it with filters like `country` or `industry` to narrow your results further.
  </Accordion>

  <Accordion title="What filters are available?">
    You can filter by `country`, `city`, `state`, `industry`, `industry_code` (LinkedIn codes 1 to 201), `employees` (ranges like `11-50` or `1001-5000`), `company_type` (e.g., "Privately Held", "Public Company"), `founded_min`, and `founded_max`. All text filters are case-insensitive.
  </Accordion>

  <Accordion title="How are results sorted?">
    Results are sorted by associated LinkedIn members in descending order. Companies with more LinkedIn-associated employees appear first. Use `limit` (max 100, default 50) and `offset` for pagination through the full result set.
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml GET /v1/companies
openapi: 3.1.0
info:
  title: TechnologyChecker API
  description: >-
    Discover technology stacks, track market trends, and enrich data with
    company intelligence.
  version: 1.0.0
  contact:
    name: TechnologyChecker Support
    email: support@technologychecker.io
    url: https://technologychecker.io
servers:
  - url: https://api.technologychecker.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Domain technologies
    description: Look up technologies detected on any domain
  - name: Technology data
    description: Search, look up, and get details on tracked technologies
  - name: Market intelligence
    description: Technology stats, trends, and market share
  - name: Company data
    description: Firmographic and company intelligence
  - name: Live detection
    description: Real-time technology detection with browser rendering
paths:
  /v1/companies:
    get:
      tags:
        - Company data
      summary: Search companies API
      description: >-
        Search and filter companies with comprehensive criteria. Results are
        sorted by associated LinkedIn members (descending).
      operationId: searchCompanies
      parameters:
        - name: country
          in: query
          description: Filter by country (case-insensitive)
          schema:
            type: string
        - name: city
          in: query
          description: Filter by city (case-insensitive)
          schema:
            type: string
        - name: state
          in: query
          description: Filter by state (case-insensitive)
          schema:
            type: string
        - name: industry
          in: query
          description: Filter by industry (case-insensitive)
          schema:
            type: string
        - name: industry_code
          in: query
          description: LinkedIn industry code (1–201)
          schema:
            type: integer
            minimum: 1
            maximum: 201
        - name: employees
          in: query
          description: Employee range
          schema:
            type: string
            enum:
              - 1-1
              - 1-10
              - 2-10
              - 11-50
              - 51-200
              - 201-500
              - 501-1000
              - 1001-5000
              - 5001-10000
              - 10001+
        - name: company_type
          in: query
          description: Company type
          schema:
            type: string
            enum:
              - Privately Held
              - Self-Owned
              - Partnership
              - Self-Employed
              - Public Company
              - Nonprofit
              - Educational
              - Government Agency
        - name: founded_min
          in: query
          description: Minimum founding year (1800–2025)
          schema:
            type: integer
            minimum: 1800
            maximum: 2025
        - name: founded_max
          in: query
          description: Maximum founding year (1800–2025)
          schema:
            type: integer
            minimum: 1800
            maximum: 2025
        - name: search
          in: query
          description: Text search in company name and description (min 2 characters)
          schema:
            type: string
            minLength: 2
        - name: limit
          in: query
          description: Results per page (max 100)
          schema:
            type: integer
            default: 50
            maximum: 100
        - name: offset
          in: query
          description: Pagination offset
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Paginated company list
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      companies:
                        type: array
                        items:
                          $ref: '#/components/schemas/Company'
                      total:
                        type: integer
                        example: 592403
                      limit:
                        type: integer
                        example: 50
                      offset:
                        type: integer
                        example: 0
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Company:
      type: object
      properties:
        domain:
          type: string
          example: stripe.com
        subdomain:
          type: string
          nullable: true
        company_name:
          type: string
          example: Stripe, Inc.
        linkedin_url:
          type: string
          example: linkedin.com/company/stripe
        industry:
          type: string
          example: Technology, Information and Internet
        industry_code:
          type: integer
          example: 6
        country:
          type: string
          example: united states
        city:
          type: string
          example: south san francisco
        state:
          type: string
          example: california
        founded:
          type: integer
          example: 2010
        employees:
          type: string
          example: 1001-5000
        company_type:
          type: string
          example: Privately Held
        associated_members:
          type: integer
          example: 12741
    ApiError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: UNAUTHORIZED
            message:
              type: string
              example: Missing or invalid API key
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key in format `tapi_live_[32-char]` (live) or `tapi_test_[32-char]`
        (test)

````