v1

latestOpenAPI 3.1.02026-07-265111.5 MB

Sandbox

Query (JSON)

Returns a JSON array of module results for the given query. Results are deterministic — the same query always returns the same modules and values.

get/sandbox/request

Query parameters

querystring required

The value to search. Format depends on type:

email — jack@gmail.com
phone — +14155552671 (E.164 format)
username — jack_sparrow
name — John Smith
wallet — 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

type'email' | 'phone' | 'username' | 'name' | 'wallet' required

Input type. Determines which modules are queried and the number of results returned:

type	Modules returned	Breach module
email	400 – 450	Yes (10 – 20 breaches)
username	480 – 520	No
phone	60 – 80	Yes (5 – 10 breaches)
name	60 – 80 (up to 50 persons each)	No
wallet	40 – 50	No

timeoutnumber

Request timeout in seconds. Present for API parity; has no effect in the sandbox.

premiumboolean

Include premium modules. Present for API parity; has no effect in the sandbox.

exact_matchboolean

For name searches — only return records where the name matches exactly. Present for API parity; has no effect in the sandbox.

info_signalsboolean

Stream only. When true, emits an InfoEvent at the start and end of the stream. Has no effect on the JSON (/sandbox/request) endpoints.

Response

Array of module results.

modulestring required

Unique platform slug. The special slug "breach" aggregates data-breach records.

status'found' required

Always "found" in sandbox responses.

querystring required

The original query value echoed back.

fromstring required

Human-readable description of the query source.

reliable_sourceboolean required

Example response

[
  {
    "module": "instaband",
    "category": {
      "type": "Activity",
      "name": "Health & Fitness",
      "description": "Health tracking and fitness platforms."
    },
    "query": "jack@gmail.com",
    "from": "User supplied email.",
    "reliable_source": true,
    "data": {
      "data": true
    },
    "spec_format": [
      {
        "registered": {
          "type": "bool",
          "proper_key": "Registered",
          "value": true
        },
        "name": {
          "type": "str",
          "proper_key": "Name",
          "value": "Brittany Martinez"
        },
        "username": {
          "type": "str",
          "proper_key": "Username",
          "value": "ngonzales"
        },
        "location": {
          "type": "str",
          "proper_key": "Location",
          "value": "Perkinsside, BE"
        },
        "creation_date": {
          "type": "datetime",
          "proper_key": "Creation Date",
          "value": "2019-03-05T15:34:38"
        },
        "gender": {
          "type": "str",
          "proper_key": "Gender",
          "value": "male"
        },
        "platform_variables": [
          {
            "key": "followers",
            "proper_key": "Followers",
            "value": 277388,
            "type": "int"
          },
          {
            "key": "following",
            "proper_key": "Following",
            "value": 16791,
            "type": "int"
          }
        ]
      }
    ],
    "front_schemas": [
      {
        "module": "InstaBand",
        "image": "https://i.pravatar.cc/200?u=ngonzales",
        "body": {
          "Name": "Brittany Martinez",
          "Bio": "Security poor rule remain discuss star finish.",
          "Followers": 277388
        },
        "tags": [
          {
            "tag": "Followers: 277,388",
            "url": "https://instaband.com/ngonzales"
          }
        ],
        "timeline": {
          "last_seen": true,
          "registered": true
        },
        "map": [
          {
            "lat_lng": [
              57.733063,
              14.227727
            ],
            "icon": {
              "awesome_marker": true,
              "location_type": "ship",
              "icon_color": "orange",
              "marker_color": "red",
              "extra_classes": "marker-red"
            },
            "popup": {
              "address": "4875 Amber Dale, Nguyenhaven, NC 38774"
            }
          }
        ]
      }
    ]
  }
]