Skip to content
Tools/Nodes/search_nodes

search_nodes

Search entities by text. Default fields: title (score 3) and description (score 1). Add `fields` to include tags (score 2) and properties (score 1). Results include `matched_field`.

Nodesatomic (read-only)

Arguments

querystringrequired

Search text (case-insensitive substring match)

typestringoptional

Optional type filter

fieldsarrayoptional

Fields to search: "title", "description", "tags", "properties" (default: title + description)

limitnumberoptional

Max results (default 20, max 100)

Returns

Shape
{ results: Array<{ id, type, title, status, tags, match_field, score }>, total, searched_fields }

Examples

Live call against the Notion example graph.

Input

{
  "query": "Notion"
}

Output

{
  "results": [
    {
      "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851",
      "type": "product",
      "title": "Notion (SATURATED test graph)",
      "match_field": "title",
      "score": 3
    },
    {
      "id": "7f5ae55d-68c5-4ca7-9e4c-b5e9d4dd32a5",
      "type": "design_system",
      "title": "Notion Design System · Block-primitive foundation",
      "match_field": "title",
      "score": 3
    },
    {
      "id": "24b43d57-48a4-4499-bac7-e38f3eb7bae4",
      "type": "design_system",
      "title": "Notion Design System · Database views",
      "match_field": "title",
      "score": 3
    },
    {
      "id": "6700fd68-27be-4b21-9186-82e490bebf33",
      "type": "workspace",
      "title": "Notion Internal · Architecture Decisions workspace",
      "match_field": "title",
      "score": 3
    },
    {
      "id": "c355f3ea-1e9f-45a1-aedc-a7adf66050e1",
      "type": "product",
      "title": "Notion Calendar",
      "match_field": "title",
      "score": 3
    },
    {
      "id": "2a3ab02e-4110-43f2-848b-a1ebeedb6fa9",
      "type": "product",
      "title": "Notion Mail (preview)",
      "match_field": "title",
      "score": 3
    },
    {
      "id": "e83e8cec-8f00-4dd5-b36a-c5e143f7e911",
      "type": "design_system",
      "title": "Notion Design System · Mobile parity tokens",
      "match_field": "title",
      "score": 3
    },
    {
      "id":
… (truncated)

See Also