1. Searches
Sherlockeye API
  • Getting started
  • Searches
    • Create a new asynchronous OSINT search
      POST
    • Get search details and results
      GET
    • Run a synchronous OSINT search with timeout
      POST
    • Delete a search
      DELETE
  • Blockchain
    • Register a search on the blockchain
      POST
  • Webhooks
    • Create a new webhook
      POST
    • List all webhooks for the authenticated user
      GET
    • Get webhook details
      GET
    • Update a webhook
      PUT
    • Delete a webhook
      DELETE
    • Get webhook delivery history
      GET
    • Retry a webhook delivery
      POST
  • Balance
    • Get token balance for the authenticated user
      GET
  • Schemas
    • SearchResult
    • ErrorResponse
    • BalanceResponse
    • CreateSearchRequest
    • CreateSyncSearchRequest
    • CreateSyncSearchResponse
    • CreateSearchResponse
    • GetSearchResponse
    • DeleteSearchResponse
    • BlockchainResponse
    • BlockchainData
    • CreateWebhookRequest
    • UpdateWebhookRequest
    • WebhookResponse
    • WebhookListResponse
    • Webhook
    • DeleteWebhookResponse
    • WebhookDeliveriesResponse
    • WebhookRetryResponse
    • WebhookDelivery
    • WebhookDeliveryAttempt
  1. Searches

Run a synchronous OSINT search with timeout

POST
/v1/searches/sync
Executes a synchronous OSINT search and returns the results collected
within the specified timeout window. The response includes a searchId and
the same result format as the asynchronous flow; the search is also stored
in KV and credits are applied like a normal search.
Use this when you prefer a single request/response that waits for results
(up to the given timeout) instead of the asynchronous pattern
(POST /v1/searches + GET /v1/searches/{searchId}).
To Deep Research (Available on Email, Phone and Name search), include:
"additional_modules": ["digital_accounts_expansion"]

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Synchronous search completed (fully or partially) within the timeout.
Body

🟠400
🟠401
🟠403
🟠422
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.sherlockeye.io/v1/searches/sync' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "email",
    "value": "someone@example.com",
    "timeoutSeconds": 80,
    "additional_modules": [
        "digital_accounts_expansion"
    ]
}'
Response Response Example
200 - Partial results within timeout
{
    "success": true,
    "data": {
        "type": "email",
        "value": "someone@example.com",
        "timeoutSeconds": 20,
        "status": "partial",
        "progress": 60,
        "results": [
            {
                "id": "result-1",
                "source": "google",
                "attributes": {
                    "link": "https://profiles.google.com/someone"
                }
            }
        ]
    }
}
Modified at 2026-03-23 17:43:23
Previous
Get search details and results
Next
Delete a search
Built with