Sherlockeye API
  1. Searches
  • Welcome to Sherlockeye API
  • Authentication
  • Balance
    • Get token balance for the authenticated user
      GET
  • Searches
    • Create a new OSINT search
      POST
    • Get search details and results
      GET
    • Delete a search
      DELETE
  • Blockchain
    • Register a search on the blockchain
      POST
  • Summary
    • Get (or generate) an AI summary for a search
      GET
  • Schemas
    • ErrorResponse
    • BalanceResponse
    • CreateSearchRequest
    • CreateSearchResponse
    • GetSearchResponse
    • DeleteSearchResponse
    • BlockchainResponse
    • SummaryResponse
    • SearchResult
    • BlockchainData
  1. Searches

Get search details and results

GET
https://api.sherlockeye.io/v1/searches/{searchId}
Searches
Last modified:2026-01-28 20:51:30
Returns metadata and results for a specific search job.
Depending on the processing state, the status field can be:
processing: the search is still running and results may be incomplete.
complete: the search finished successfully.
expired: the search did not complete within the allowed processing window.
The results array contains individual OSINT hits, and blockchainData, if present,
provides a verifiable record of the search on the blockchain.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.sherlockeye.io/v1/searches/' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Search found; status and results returned.
Body

Example
{
    "success": true,
    "data": {
        "searchId": "f6f3b720-4f3a-4dcf-9d0e-6e5efc46f8c9",
        "query": "email:\"someone@example.com\"",
        "status": "complete",
        "timestamp": "2025-01-01T12:00:05.000Z",
        "expiresAt": 1767264000000,
        "results": [
            {
                "id": "result-1",
                "source": "google",
                "tag": [
                    "email",
                    "search_engine"
                ],
                "additionalFields": [
                    {
                        "key": "profile_url",
                        "value": "https://profiles.google.com/someone"
                    }
                ]
            },
            {
                "id": "result-2",
                "source": "microsoft",
                "tag": [
                    "email",
                    "account"
                ],
                "additionalFields": [
                    {
                        "key": "account_status",
                        "value": "active"
                    }
                ]
            }
        ],
        "summary": null,
        "blockchainData": null
    }
}
🟠400
🟠401
🟠404
🔴500
Modified at 2026-01-28 20:51:30
Previous
Create a new OSINT search
Next
Delete a search
Built with