Authentication
The MerkleMap API uses bearer token authentication to secure all API endpoints.
Prerequisites
To use the MerkleMap API, you need to:
- Subscribe to a paid plan
- Generate an API token from your user profile
Bearer Authentication
Include your API token in the Authorization header of all requests using the Bearer scheme:
Authorization: Bearer your_api_token_here
If authentication fails, the API will return a 401 Unauthorized response.
Token Security
- Keep your API tokens secure and never share them
- Rotate your tokens periodically
- Use different tokens for different applications or environments
- If a token is compromised, revoke it immediately from your user profile
Example Request
GET
/v1/searchcurl -N -G https://api.merklemap.com/v1/search \
-d query=example.com \
-H "Authorization: Bearer your_api_token_here"
401 Error Response
{
"status": "Unauthorized",
"message": "Invalid or missing API token"
}