Search

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

Endpoint

https://api.merklemap.com/v1/search

Query Parameters

Name
query
Type
string
Description
The search query (e.g., example.com).
Name
type
Type
string
Description
The search type to use. Can be either distance (Levenshtein distance-based search) or wildcard (wildcard pattern matching). Defaults to wildcard.
When using distance, the search will find results that are similar to your query based on the Levenshtein distance algorithm, which measures the minimum number of single-character edits required to change one string into another. This is useful for finding similar domain names or handling typos.
Name
page
Type
integer
Description
The page number for paginated results. Starts at 0.
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

The response is returned as a JSON object.

Request Examples

GET

/v1/search

curl -N -G https://api.merklemap.com/v1/search \
-d query=example.com \
-d page=0 \
-d type=distance \
-H "Authorization: Bearer your_api_token_here"

JSON Response

{
    "count": 9588,
    "results": [
        {
            "hostname": "3.example.com",
            "subject_common_name": "1.example.com",
            "not_before": 1726168444
        },
        {
            "hostname": "www.2.example.com",
            "subject_common_name": "www.2.example.com",
            "not_before": "2024-01-01T00:00:00Z"
        },
        ...
    ]
}

Error Response

{
    "error": "Bad Request",
    "message": "Invalid query parameter"
}