---
title: "Perform a Node Search"
method: POST
path: "/api/discovery/node_result/"
tags: ["Discovery"]
---

# Perform a Node Search

`POST /api/discovery/node_result/`

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

## Headers

- `X-Count-Id` string, required — The Discovery tool tracks sets of available searches associated with a node or group using this ID.

## Request body

- object
  - `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_value` string, required — A value of the node.
  - `search_field_id` integer, required — The ID of the search type.

## Response `200`

__Search Results__

- object
  - `aggregations` NodeSearchResult[] — Search results returned by related to the performed search aggregation.
    - `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_value` string, required — A value of the node.
    - `is_valid` boolean, required — Indicates that the search result should be ignored due to an inappropriate format.

## Other responses

- `400` — __Bad Request__: Some required parameters were not passed or were not validated
- `402` — __Not Enough Coins__: You are out of your current subscription plan limits
- `403` — __Access Denied__: You are not allowed to perform this action Error details are included in the response body.
- `429` — __Daily request limit exceeded__ or __Request throttled__. Additional error details are provided in the response body
- `500` — __Internal Server Error__: Details are included in the response body
- `504` — __Timeout__: The request took too long to process

---

[API](https://skmtc.net/netlas/apis/netlas-api.md) · [All operations](https://skmtc.net/netlas/apis/netlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netlas/netlas-api/revisions/2b1f84425791/schema)