Search Seeds
Perform semantic search across your document library using natural language queries powered by vector embeddings. This endpoint uses Jina Embeddings v4 to convert your query into a 1024-dimensional vector and finds the most semantically similar content chunks. Results are ranked by similarity score and include the matching text content, source seed information, and relevance scores. Supports both text queries and image-based search through multimodal embeddings.
{baseAPIUrl}/seeds/queryAuthentication
Required. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | string | Required | Application identifier |
| externalUserId | string | Required | External user identifier for data isolation |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| query | string | Required | Natural language search query |
| seedIds | string[] | Optional | Limit search to specific seed IDs (default: []) |
| limit | number | Optional | Max results to return (1-100, default: 30) |
| threshold | number | Optional | Similarity threshold (0-1, default: 0.5) |
| imageData | string | Optional | Base64-encoded image for image search |
Understanding the Threshold Parameter
The threshold parameter
controls the minimum similarity score required for results to be returned. Values range
from 0 to 1.
- Development (0.3): Use a lower threshold to see more results and understand search behavior.
- Production (0.5): The default threshold filters out lower-quality matches for relevance.
Response
| Field | Type | Description |
|---|---|---|
| results | array | Array of search results |
| results[].seedId | string | ID of the seed containing the match |
| results[].chunkId | string | ID of the matching chunk |
| results[].content | string | Content of the matching chunk |
| results[].similarity | number | Similarity score (0-1, higher is better) |
| total | number | Total matching results |
| queryTime | number | Query execution time in seconds |
Try It
Query Parameters
Application identifier
External user identifier for data isolation
Request Body
Natural language search query
Limit search to specific seed IDs
Max results to return (1-100)
Similarity threshold (0-1)