# searchcode.ai

> Search source code across the public web for technologies, implementation patterns, and domains. REST API and MCP server. Free account with 200 search credits, no card required.

See what the web is made of. searchcode.ai searches the HTML, JavaScript and CSS of the public web for technologies, implementation patterns, and the domains behind them.

## Services

- **Search raw source code** (Free+; MCP, CLI, REST): Find snippets, script URLs, API hosts, and identifiers across HTML, JS, and CSS. Example: _Find every site loading js.stripe.com/v3_
- **Find technology adoption** (Free+; MCP, CLI, REST): List the ranked domains detected using a framework, service, or platform. Example: _Which sites use React or Google Tag Manager?_
- **Count a web signal** (Free+; MCP, CLI, REST): Measure how many sites use a technology, request host, or public identifier. Example: _How many sites request google-analytics.com?_
- **Inspect a domain** (Pro+; MCP, CLI, REST): Read its detected stack, page footprint, rank, country, and infrastructure. Example: _What technology stack does example.com use?_
- **Connect related domains** (Pro+; REST): Find domains sharing the same analytics, advertising, or tracker identifier. Example: _Which domains share this Google Analytics property?_
- **Browse the web index** (Free+; REST): Explore ranked domains and narrow the corpus with technology and TLD metadata. Example: _Browse top .gov domains detected with analytics tooling_
- **Query shop catalogs** (Enterprise+; REST): Browse captured storefronts and product records from the licensed catalog. Example: _Find captured Shopify stores and their products_

## Use cases

- **Technology research**: Measure adoption of a framework, script, or vendor across ranked domains.
- **Discovery & prospecting**: Build lists of sites that run a specific stack, payment provider, or analytics tool.
- **Due diligence**: Verify what a domain actually ships: stack, trackers, infrastructure, and rank.
- **Competitive analysis**: Track which technologies competitors adopt and which domains they connect to.
- **Security reconnaissance**: Find script hosts, API endpoints, and identifiers exposed in public source.

## Authentication — how to create an API key

1. Create a free account at https://searchcode.ai/ (200 search credits, no card required).
2. Open the dashboard and choose "API access" in the navigation.
3. Enter a label that says where the key will live (for example "mcp-laptop") and click "Create key".
4. Copy the key immediately: its full value is shown exactly once.
5. Send it as the `X-API-Key` header on every /api/v1 request, or set `SEARCHCODE_API_KEY` for the MCP server and CLI.
6. Revoke a key from the same page when it is no longer needed. Keys authorize only the customer API and carry no operator privileges.

All endpoints live under `https://searchcode.ai/api/v1` and require the `X-API-Key` header. Usage is metered per key by tier and credits.

## Endpoints

### Source search

Find pages by the source code they contain — synchronous reads and durable jobs.

- `GET /api/v1/search` — Synchronous source search: find pages by a substring or bounded literal in their HTML, JS, or CSS. (Free+, MCP tool `search_source`)
- `POST /api/v1/searches` — Start a durable source search job for large or slow match sets. (Free+)
- `GET /api/v1/searches/{id}` — Read the status and progress of a source search job. (Free+)
- `DELETE /api/v1/searches/{id}` — Cancel a running source search job. (Free+)
- `GET /api/v1/searches/{id}/events` — Stream job progress and partial results as server-sent events. (Free+)
- `GET /api/v1/searches/{id}/results` — Page through the results of a finished source search job. (Free+)
- `GET /api/v1/techlist` — List every technology the index can detect. (Free+)
- `GET /api/v1/techlist/grouped` — The technology catalog grouped by category. (Free+)
- `GET /api/v1/techmeta` — Metadata for one technology: category, website, icon, pricing hints. (Free+)
- `GET /api/v1/tlds` — List the TLDs present in the index with domain counts. (Free+)
- `GET /api/v1/filters` — Discovery manifest of every filter the search endpoints accept. (Free+)

### Technology intelligence

Who uses a technology, the catalog, facets, and discovery manifests.

- `GET /api/v1/facet` — Count how many domains carry a technology, request host, or public identifier. (Free+, MCP tool `facet_count`)
- `GET /api/v1/tech` — List the ranked domains detected using a technology. (Free+, MCP tool `tech_query`)
- `GET /api/v1/domains` — Browse the ranked domain index, filtered by technology and TLD metadata. (Free+)

### Domain profile

Per-domain stack, spend floor, rank, country, and infrastructure.

- `GET /api/v1/site` — Read one domain's detected stack, page footprint, rank, country, and infrastructure. (Pro+, MCP tool `tech_lookup`)

### Owner graph

Every domain sharing a tracker or ad account identifier.

- `GET /api/v1/owner-graph` — Find every domain sharing an analytics, advertising, or tracker identifier. (Pro+)

### Shop catalog

Scraped e-commerce shops and products — separately licensed, Enterprise only.

- `GET /api/v1/shops` — Browse captured e-commerce storefronts from the licensed shop catalog. (Enterprise+)
- `GET /api/v1/shops/stats` — Aggregate statistics over the licensed shop catalog. (Enterprise+)
- `GET /api/v1/shop/products` — Read captured product records for one storefront. (Enterprise+)

## MCP server

`searchcode-mcp` (npm package `searchcode-client`) is a stdio MCP server for AI assistants. Tools:

- `search_source` — Synchronous source search: find pages by a substring or bounded literal in their HTML, JS, or CSS.
- `facet_count` — Count how many domains carry a technology, request host, or public identifier.
- `tech_query` — List the ranked domains detected using a technology.
- `tech_lookup` — Read one domain's detected stack, page footprint, rank, country, and infrastructure.

Client configuration:

```json
{
  "mcpServers": {
    "searchcode": {
      "command": "npx",
      "args": ["-y", "--package=searchcode-client", "searchcode-mcp"],
      "env": {
        "SEARCHCODE_API_KEY": "YOUR_API_KEY",
        "SEARCHCODE_API_URL": "https://searchcode.ai"
      }
    }
  }
}
```

## CLI and REST

- CLI: Coming soon. Use the REST API or the MCP server today.

REST example:

```bash
curl --get "https://searchcode.ai/api/v1/search" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "q=stripe.com/v3" \
  --data "limit=20"
```

## Plans

- **Free**: 200 included search credits, REST + MCP, no card. Unlocks: Search raw source code, Find technology adoption, Count a web signal, Browse the web index.
- **Solo**: Regex source search and higher monthly credits.
- **Pro**: Adds domain profiles and the owner graph. Unlocks: Inspect a domain, Connect related domains.
- **Scale**: Higher throughput and bulk limits for teams.
- **Enterprise**: Shop catalog, bulk export, and custom terms. Unlocks: Query shop catalogs.

## Links

- [Home](https://searchcode.ai/): Search source code across the public web for technologies, implementation patterns, and domains. REST API and MCP server. Free account with 200 search credits, no card required.
- [Full reference](https://searchcode.ai/llms-full.txt): every endpoint with parameters and curl examples
- [Imprint](https://searchcode.ai/imprint/)
- Contact: hello@searchcode.ai