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
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"}
...