Skip to main content
POST /{index_id}/search Performs a similarity search using a query vector.

​
Request Body

FieldTypeRequiredDescription
vectorarrayYesThe query vector for the search.
top_kintegerYesThe number of top similar results to return (1-1000).
filterobjectNoA metadata filter to apply before searching.
include_metadatabooleanNoIf true, includes vector metadata in the results.
include_valuesbooleanNoIf true, includes vector embeddings in the results.

​
Example Requests

  • cURL
  • Python SDK
  • JavaScript SDK
curl --location 'https://api.gravixlayer.com/v1/vectors/indexes/bf93acdc-dc02-4514-8a6f-292e85fc3450/search' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --data '{
    "vector": [0.1, 0.2, 0.3, "... (1536 floats total)"],
    "top_k": 5,
    "filter": { "category": "finance" },
    "include_metadata": true,
    "include_values": false
  }'

​
Response

A JSON object containing the search hits and query processing time. 
{
  "hits": [
    {
      "id": "3ae68ad7-647a-4dd4-885c-cbd498e30428",
      "score": 0.74717253,
      "metadata": {
        "category": "finance",
        "document_id": "doc_123"
      }
    },
    {
      "id": "vec_finance_002",
      "score": 0.005163048,
      "metadata": {
        "category": "finance",
        "language": "english"
      }
    }
  ],
  "query_time_ms": 3
}
⌘I