Sign in
latestOpenAPI 3.0.3Netlas API & Data License Agreement2026-08-104487309.0 KB

2b1f84425791

Discovery

Perform a Node Search

Execute a search using search_field_id for a node specified by node_value and node_type, and retrieve the corresponding results.

post/api/discovery/node_result/

Headers

X-Count-Idstring required

The Discovery tool tracks sets of available searches associated with a node or group using this ID.

Example:99ec3869b238d440bffc2c6e7b4c8dc3f98cdd9f6b3106d1350cf3c8c0af1837e2942a04780e223b215eb8b663cf5353

Perform a /api/discovery/node_count request to get the X-Count-Id.

Request body

node_type'address' | 'as_name' | 'asn' | 'dns_txt' | 'domain' | 'email' | 'favicon' | 'http_tracker' | 'ip' | 'ip-range' | 'jarm' | 'network_name' | 'organization' | 'person' | 'phone' | 'text' required

The type of the node(s).

node_valuestring required

A value of the node.

search_field_idinteger required

The ID of the search type.

Example request

{
  "node_type": "domain",
  "node_value": "example.com",
  "search_field_id": 29
}

Response

Search Results

Example response

{
  "aggregations": [
    {
      "is_valid": true,
      "node_value": "23.192.228.80",
      "node_type": "ip"
    },
    {
      "is_valid": true,
      "node_value": "23.192.228.84",
      "node_type": "ip"
    }
  ]
}