API Docs — HashScanner

Authentication

All API requests require an API key passed in the request header. Keys are generated automatically when you create an account.

                HTTP Header
X-API-Key: hs_live_your_api_key_here
            

Base URL

                URL
https://api.hashscanner.com/v1
            

Endpoints

POST

/lookup

Look up one or more hashes. Accepts up to 100 hashes per request on Professional; 100,000+ on Enterprise.

GET

/lookup/{hash}

Look up a single hash by value. Faster for single-hash integrations.

GET

/status

Check API status, your remaining quota, and rate limit state.

Request example — bulk lookup

cURL Python PHP

                cURL
curl -X POST https://api.hashscanner.com/v1/lookup \
  -H "X-API-Key: hs_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "hashes": [
      "d41d8cd98f00b204e9800998ecf8427e",
      "da39a3ee5e6b4b0d3255bfef95601890afd80709",
      "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    ]
  }'
            

                Python
import requests

response = requests.post(
    "https://api.hashscanner.com/v1/lookup",
    headers={"X-API-Key": "hs_live_your_key"},
    json={"hashes": [
        "d41d8cd98f00b204e9800998ecf8427e",
        "da39a3ee5e6b4b0d3255bfef95601890afd80709"
    ]}
)
print(response.json())
            

                PHP
$ch = curl_init('https://api.hashscanner.com/v1/lookup');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: hs_live_your_key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['hashes' => [
        'd41d8cd98f00b204e9800998ecf8427e',
    ]]),
]);
$result = json_decode(curl_exec($ch), true);
            

Response example

                JSON
{
  "results": [
    {
      "hash":   "d41d8cd98f00b204e9800998ecf8427e",
      "type":   "md5",
      "status": "clean",
      "sources": [
        { "name": "nsrl",         "verdict": "clean" },
        { "name": "malwarebazaar", "verdict": "not_found" }
      ]
    }
  ],
  "meta": {
    "total":     1,
    "duration_ms": 48,
    "quota_remaining": 4750
  }
}
            

Rate limits

Plan	Requests / min	Searches / day	Bulk size (max)
Free	10	250	10
Professional	120	25,000	100
Enterprise	Dedicated	Custom	100,000+

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.