# Crtsh Certificate Transparency Search API

> Search Certificate Transparency logs on crt.sh for TLS certificates of a domain or its subdomains

- Vendor: `crtshcertificatetransparencyse` · version 1.0 · category Cyber Security · tags certificate transparency api, ssl certificate search api, subdomain discovery api, crt sh api, tls certificates api, security recon api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/crtshcertificatetransparencyse
- This document: https://apiclay.com/docs/crtshcertificatetransparencyse.md
- OpenAPI 3.1: https://apiclay.com/api/crtshcertificatetransparencyse/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `crtshcertificatetransparencyse`
- Updated: 2026-11-18

## About

## Crtsh Certificate Transparency Search API

Certificate Transparency search from crt.sh (run by Sectigo): every logged TLS certificate whose names match a domain, with issuer, common name, all subject names, validity dates, serial number and crt.sh id. Use `%.example.com` to find subdomains.

Data comes from **crt.sh** (https://crt.sh). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/certificates?q=example.com`, or `/certificates?q=%.example.com` for subdomains.

### Routes

#### GET `/certificates` - Certificate search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Domain, `%.domain` wildcard, or a certificate fingerprint. |
| exclude | query | string | no | `expired` to hide expired certificates. |

Returns: array of `id`, `issuer_name`, `common_name`, `name_value` (newline-separated names), `not_before`, `not_after`, `serial_number`, `entry_timestamp`.

### Caveats

- crt.sh is a free community service and is often slow or busy; popular domains return large results.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by crt.sh.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /certificates — Certificate search
- Gateway: `GET https://api.apiclay.com/v1/api/crtshcertificatetransparencyse/certificates`
- Public query params: `q` (string, required), `exclude` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/crtshcertificatetransparencyse/certificates?q=<q>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
