> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorylake.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Search Documents
> Semantic search over documents in a project
```
POST /openapi/memorylake/api/v1/projects/{id}/documents/search
```
Performs semantic search over all documents in the project. Returns matched content ranked by relevance. Results are categorized into three types — `table`, `paragraph`, and `figure` — each identified by the `type` field.
**Permission required:** [`project:doc_search`](/features/team-collaboration/permission-reference#search-documents-inside-a-project-api-only) · `instance`
### Path Parameters
Project ID
### Request Body
Search query text
Maximum number of results to return (minimum 1)
```bash cURL theme={null}
curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v1/projects/proj-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6/documents/search' \
-H 'Authorization: Bearer sk_xxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"query": "What were the quarterly sales figures in 2024?",
"top_n": 10
}'
```
### Response
Actual number of results returned
Search results ranked by relevance. Each item is a discriminated union — `type` decides which variant-only fields are present and which sub-field of `highlight` is populated. Click to expand the full per-item shape.
Discriminator. One of `paragraph`, `table`, or `figure`.
Document ID
Document file name, e.g. `report_2024.xlsx`
Source file info.
Original file name
Matched content. The object always has the same three optional fields below — exactly one is populated, selected by the parent item's `type`.
Populated when `type=paragraph`. Matched text spans, in document order. Absent otherwise.
Plain-text snippet of the match
Location hint (e.g. page number `p12`, or a cell range for workbook paragraphs)
Populated when `type=table`. Matched sub-tables within the source table region. Absent otherwise.
Inner table ID
Cell range covered, e.g. `A1:D50`
Number of data rows
Internal storage path of the materialized table
Column descriptors.
Column ID
Column header name
Inferred data type (e.g. `string`, `number`, `date`)
Column cell range
Non-null value count
Null value count
Approximate number of distinct values
Minimum value (string-encoded)
Maximum value (string-encoded)
Sample raw values from the column
Sample formatted/display values
Model-inferred semantic comment for the column
Whether the column participates in a row hierarchy
Populated when `type=figure`. The matched figure descriptor. Absent otherwise.
Original figure caption
OCR / extracted text inside the figure
Model-generated summary of the figure
Pre-generated questions the figure can answer
Internal storage path of the figure asset
**Only when `type=paragraph`.** Paragraph block ID inside the document.
**Only when `type=table`.** Table entity ID.
**Only when `type=table`.** Table title.
**Only when `type=table`.** Table footnote.
**Only when `type=table`.** Worksheet name (workbook tables).
**Only when `type=table`.** Model-inferred semantic name for the worksheet.
**Only when `type=table`.** Model-inferred semantic comment for the worksheet.
**Only when `type=table`.** Table region location, e.g. `A1:D50`.
**Only when `type=figure`.** Figure numeric ID.
```json Success (200) theme={null}
{
"success": true,
"data": {
"count": 3,
"results": [
{
"type": "paragraph",
"document_id": "doc-123",
"document_name": "report_2024.pdf",
"paragraph_block_id": "blk-456",
"highlight": {
"chunks": [
{
"text": "Q1 2024 sales reached $2.5M...",
"range": "p12"
}
]
},
"source_document": {
"file_name": "report_2024.pdf"
}
},
{
"type": "table",
"document_id": "doc-789",
"document_name": "sales_data.xlsx",
"table_id": "tbl-001",
"title": "Quarterly Sales Summary",
"sheet_name": "Sheet1",
"table_region_info": "A1:D50",
"highlight": {
"inner_tables": [...]
},
"source_document": {
"file_name": "sales_data.xlsx"
}
}
]
}
}
```