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

# API reference

> Complete REST API reference for TechnologyChecker. Detect technologies, look up domains, search companies, track market trends, and enrich data across 50M+ domains.

## Base URL

All API requests use the following base URL:

```
https://api.technologychecker.io
```

## Prerequisites

* A TechnologyChecker account ([sign up free](https://app.technologychecker.io/auth/sign-up))
* Some familiarity with REST APIs and HTTP requests

## Quick start

<Steps>
  <Step title="Get your API key">
    Sign in to [app.technologychecker.io](https://app.technologychecker.io) and go to **Settings** > **Developers** to create an API key. Each organization gets a single API key with encrypted storage.
  </Step>

  <Step title="Make your first request">
    Look up any domain's technology stack:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -H "Authorization: Bearer YOUR_API_KEY" \
        https://api.technologychecker.io/v1/domain/shopify.com
      ```

      ```python Python theme={null}
      import requests

      headers = {"Authorization": "Bearer YOUR_API_KEY"}
      response = requests.get(
          "https://api.technologychecker.io/v1/domain/shopify.com",
          headers=headers,
      )
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const response = await fetch(
        "https://api.technologychecker.io/v1/domain/shopify.com",
        {
          headers: { Authorization: "Bearer YOUR_API_KEY" },
        }
      );
      const data = await response.json();
      ```
    </CodeGroup>
  </Step>

  <Step title="Explore the response">
    ```json theme={null}
    {
      "success": true,
      "data": {
        "domain": "shopify.com",
        "active_technologies": [
          {
            "id": 2,
            "name": "Cloudflare",
            "category": "CDN",
            "first_seen": "2020-05-08 00:00:00",
            "last_seen": "2026-01-08 00:00:00",
            "subdomain": "SHOPIFY.COM"
          },
          {
            "id": 4,
            "name": "SSL by Default",
            "category": "SSL/TLS Certificates",
            "first_seen": "2015-09-08 00:00:00",
            "last_seen": "2026-01-08 00:00:00",
            "subdomain": "SHOPIFY.COM"
          }
        ],
        "historical_technologies": [...]
      }
    }
    ```
  </Step>
</Steps>

## Available APIs

### Domain technologies

Look up active and historical technologies for any domain. Find websites using a specific technology, track tech stack changes, and build prospecting lists.

| Method | Path                                 | Description                                            | Credits |
| ------ | ------------------------------------ | ------------------------------------------------------ | ------- |
| GET    | `/v1/domain/{domain}`                | Get active and historical technologies for a domain    | 1       |
| GET    | `/v1/domain/{domain}/history`        | Get full technology history with active/removed status | 1       |
| GET    | `/v1/technology/name/{name}/domains` | Find top domains using a specific technology           | 1       |

### Technology data

Search and look up 40,000+ tracked technologies by name or ID. Get extended metadata and batch-resolve technology names for enrichment pipelines.

| Method | Path                         | Description                                       | Credits |
| ------ | ---------------------------- | ------------------------------------------------- | ------- |
| GET    | `/v1/technology/{id}/info`   | Get extended details (description, website, icon) | 1       |
| GET    | `/v1/technology/name/{name}` | Quick lookup by exact name (case-insensitive)     | 1       |
| GET    | `/v1/technologies`           | Search technologies by name or category           | 1       |
| POST   | `/v1/technologies/lookup`    | Batch lookup multiple names in one request        | 1       |

### Market intelligence

Technology adoption statistics, monthly usage trends spanning 20 years, and category market share. Build competitive analysis reports with data from 50M+ domains.

| Method | Path                             | Description                                 | Credits |
| ------ | -------------------------------- | ------------------------------------------- | ------- |
| GET    | `/v1/technology/{id}/stats`      | Active and total domain counts              | 1       |
| GET    | `/v1/technology/{id}/history`    | Monthly usage trends (up to 20 years)       | 1       |
| GET    | `/v1/category/{id}/market-share` | Market share distribution within a category | 1       |

### Company data

Firmographic data from 25.4M LinkedIn company records. Search, filter, and batch-enrich companies by technology, geography, industry, and size.

| Method | Path                            | Description                                     | Credits      |
| ------ | ------------------------------- | ----------------------------------------------- | ------------ |
| GET    | `/v1/technology/{id}/companies` | Get companies using a technology (with filters) | 1            |
| GET    | `/v1/company/{domain}`          | Get company data for a specific domain          | 1            |
| GET    | `/v1/companies`                 | Search and filter companies                     | 1            |
| POST   | `/v1/companies/batch`           | Batch lookup multiple domains                   | 1 per domain |

### Live detection

Real-time technology detection with browser rendering (Puppeteer, REST, HTTP modes). Scan any URL not in the pre-crawled database.

| Method | Path                         | Description                                             | Credits |
| ------ | ---------------------------- | ------------------------------------------------------- | ------- |
| POST   | `/v1/technology-lookup-live` | Live technology detection (3 modes: full, light, fetch) | 5       |

### Account

Monitor API usage and credit consumption. These endpoints are free and don't consume credits.

| Method | Path          | Description                   | Credits |
| ------ | ------------- | ----------------------------- | ------- |
| GET    | `/v1/usage`   | Aggregated usage statistics   | 0       |
| GET    | `/v1/credits` | Credit balance and reset date | 0       |

## Essentials

<CardGroup cols={3}>
  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    Bearer token setup and key management.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/api-reference/rate-limits">
    Request limits by plan and retry handling.
  </Card>

  <Card title="Credits" icon="coins" href="/api-reference/credits">
    Credit costs per endpoint and plan details.
  </Card>
</CardGroup>

## Interactive testing

You can test all endpoints directly from the API playground in your [dashboard](https://app.technologychecker.io). Your API key is pre-filled automatically.

<img src="https://mintcdn.com/technologychecker/EoFefZgIvEggxecX/images/api-playground.jpg?fit=max&auto=format&n=EoFefZgIvEggxecX&q=85&s=43a3ed321629b154f666b5dae171983c" alt="API Playground showing Technology APIs and Company Data APIs with interactive Try in API Console buttons for each endpoint" width="1600" height="936" data-path="images/api-playground.jpg" />

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Which endpoint should I use to look up a website's technologies?">
    Use `GET /v1/domain/{domain}` for an instant lookup from the pre-crawled database of 50M+ domains (1 credit). If the domain isn't found, use `POST /v1/technology-lookup-live` for real-time detection (5 credits).
  </Accordion>

  <Accordion title="How do I find companies using a specific technology?">
    First, look up the technology name with `GET /v1/technology/name/{name}` to get its ID. Then call `GET /v1/technology/{id}/companies` with optional filters for country, industry, and employee count.
  </Accordion>

  <Accordion title="Can I look up multiple domains or technologies in one request?">
    Yes. Use `POST /v1/companies/batch` to enrich multiple domains with company data in a single call (1 credit per domain). Use `POST /v1/technologies/lookup` to resolve multiple technology names to IDs in one request (1 credit).
  </Accordion>

  <Accordion title="How do I get market share data for a technology category?">
    Use `GET /v1/category/{id}/market-share` to get the market share distribution for all technologies in a category. Combine with `GET /v1/technology/{id}/history` for monthly adoption trends over time.
  </Accordion>

  <Accordion title="Is the TechnologyChecker API free to use?">
    Yes. The Free plan gives you 100 credits per month with full API access — no credit card required. Most endpoints cost 1 credit per request. If you need more volume, the Pro plan ($89/month) includes 10,000 credits and the Scale plan ($249/month) includes 50,000. See [credits and pricing](/api-reference/credits) for the full breakdown.
  </Accordion>

  <Accordion title="What programming languages work with the TechnologyChecker API?">
    Any language that can make HTTP requests works with the API. It's a standard REST API that returns JSON responses. The docs include code examples in cURL, Python, and JavaScript, but you can use Ruby, Go, Java, PHP, C#, or any other language with an HTTP client. No SDK installation is required.
  </Accordion>

  <Accordion title="How many technologies does TechnologyChecker track?">
    TechnologyChecker tracks over 40,000 technologies across categories like CDNs, analytics, CMS platforms, e-commerce frameworks, payment processors, and more. The database covers 50M+ actively monitored domains with historical data going back up to 20 years. Use `GET /v1/technologies` to search the full catalog.
  </Accordion>
</AccordionGroup>
