{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Search Data - search_data","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"search-data---search_data","__idx":0},"children":["Search Data - search_data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mode"]},": Both · ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Category"]},": Data Retrieval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Searches for record instances using keyword matching or semantic search. The LLM always provides the search query and keywords at runtime."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"minimal-keyword-mode-with-defaults","__idx":1},"children":["Minimal (keyword mode with defaults)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: search_data\n\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"keyword-mode-with-custom-limit","__idx":2},"children":["Keyword mode with custom limit"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: search_data  \n  instance_limit: 10\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"semantic-mode-with-vector-store","__idx":3},"children":["Semantic mode with vector store"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: search_data  \n  unique_id: vendor_search  \n  description: Semantic search over vendor records.  \n  search_mode: semantic  \n  instance_limit: 10  \n  vector_store_id: my-vector-store-ref  \n  similarity_threshold: 0.7  \n  return_row_attributes:  \n    - id: VENDOR.VENDOR_NAME  \n    - id: VENDOR.VENDOR_COUNTRY  \n  filter:  \n    pql_template:  \n      pql: 'FILTER \"VENDOR\".\"ACTIVE\" = 1'  \n      name: Active Vendors Only\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"config-fields","__idx":4},"children":["Config fields"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-tools-add-search-data.a3c8f06b02a00f1553e303986f668e9badac8d94040a6c0e3b0a3da2b32fcec4.a6bd5218.png","alt":"mcp-tools-add-search-data.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Either \"keyword\" (default) or \"semantic\"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instance_limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Max results per keyword/query (default: 5, max: 20)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vector_store_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Vector store reference for semantic search."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["similarity_threshold"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["float"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Minimum similarity score for results (default: 0.0)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_row_attributes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["list"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Attributes to include in result rows."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Pre-filter applied before searching (filter ID or PQL template)."]}]}]}]}]}]},"headings":[{"value":"Search Data - search_data","id":"search-data---search_data","depth":1},{"value":"Minimal (keyword mode with defaults)","id":"minimal-keyword-mode-with-defaults","depth":2},{"value":"Keyword mode with custom limit","id":"keyword-mode-with-custom-limit","depth":2},{"value":"Semantic mode with vector store","id":"semantic-mode-with-vector-store","depth":2},{"value":"Config fields","id":"config-fields","depth":2}],"frontmatter":{"seo":{"title":"Search Data - search_data"}},"lastModified":"2026-08-25T16:27:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/tools/search_data","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}