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

# Technology usage trends API

> Get monthly domain counts for a technology over time — up to 20 years of historical data for trend analysis. Track adoption growth, decline, and seasonal patterns.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How far back does the technology usage history go?">
    Up to 20 years, depending on the technology. Use the `years` parameter (1 to 20) to control how much history to retrieve. The default is 12 years. Each data point represents one month, so requesting 20 years returns up to 240 monthly data points.
  </Accordion>

  <Accordion title="What does each data point represent?">
    Each entry includes a `date` (year-month format like `2025-12`), `active_domains` (domains currently using the technology that month), and `total_domains` (all-time domains detected up to that month). Plot these values over time to visualize adoption trends.
  </Accordion>

  <Accordion title="Can I filter the history by a specific date range?">
    Not directly. The `years` parameter controls how far back to go from today. To focus on a specific period, request enough history to cover it and then filter the response array client-side by the `date` field. Each request costs 1 credit.
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml GET /v1/technology/{id}/history
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/technology/{id}/history:
    get:
      tags:
        - Market intelligence
      summary: Technology usage trends API
      description: >-
        Get monthly domain counts for a technology over time — up to 20 years of
        historical data for trend analysis.
      operationId: getTechnologyTrends
      parameters:
        - name: id
          in: path
          required: true
          description: Technology ID
          schema:
            type: integer
            example: 268
        - name: years
          in: query
          description: Number of years of history to return (1–20)
          schema:
            type: integer
            default: 12
            minimum: 1
            maximum: 20
      responses:
        '200':
          description: Monthly usage data
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      technology:
                        $ref: '#/components/schemas/TechnologyBasic'
                      history:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              example: 2025-12
                            active_domains:
                              type: integer
                              example: 1039
                            total_domains:
                              type: integer
                              example: 1039
                      data_points:
                        type: integer
                        example: 300
                      years_requested:
                        type: integer
                        example: 2
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    TechnologyBasic:
      type: object
      properties:
        id:
          type: integer
          example: 268
        name:
          type: string
          example: React
        category:
          type: string
          example: JavaScript Frameworks
    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'
    NotFound:
      description: Resource not found
      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)

````