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

...

Was this page helpful?