Search

The MerkleMap search endpoint allows you to search for subdomains and SSL / TLS certificates.

Endpoint

https://api.merklemap.com/search

Query Parameters

Name
query
Type
string
Description
The search query (e.g., example.com).
Name
page
Type
integer
Description
The page number for paginated results.
Name
stream_progress
Type
boolean
Description
Set to true to get the search progress in the response stream.
Name
stream
Type
boolean
Description
Set to true to get the search results in the response stream. Pagination is ignored in this mode.

Response Format

By default, the response is returned as a JSON object. However, when &stream=true and/or &stream_progress=true are used, the response is returned as a Server-Sent Events (SSE) stream instead of normal JSON.

SSE Stream Response

When &stream=true and/or &stream_progress=true are used, the response is an SSE stream with the following event data:

Progress events: data: {"progress_percentage": <percentage>}
Result events: data: {"domain": "<domain>", "not_before": <timestamp>, "subject_common_name": "<subject_common_name>"}

The progress events provide the percentage of the search progress, while the result events contain the actual search results.

If both &stream=true and &stream_progress=true are used, the SSE stream will include both progress events and result events interleaved.

Request

GET

/search

curl -N -G https://api.merklemap.com/search \
-d query=example.com \
-d page=1

JSON Response

{
    "count": 9588,
    "results": [
{
    "domain": "3.example.com",
    "subject_common_name": "1.example.com",
    "not_before": 1726168444
},
{
    "domain": "www.2.example.com",
    "subject_common_name": "www.2.example.com",
    "not_before": 1726130923
},
    ...
    ]
}

SSE Stream Response

data: {"progress_percentage":10.0}

data: {"progress_percentage":20.0}

data: {"domain":"example.com","not_before":1726168444,"subject_common_name":"example.com"}

data: {"progress_percentage":30.0}

data: {"domain":"www.example.com","not_before":1726130923,"subject_common_name":"www.example.com"}

...