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
querystringrequiredSearch text (case-insensitive substring match)
typestringoptionalOptional type filter
fieldsarrayoptionalFields to search: "title", "description", "tags", "properties" (default: title + description)
limitnumberoptionalMax 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)