Get

TopK collections store documents as key-value pairs. get() provides direct key-based lookup, similar to a key-value store. This operation is optimized for high throughput and low latency.

docs = client.collection("books").get(["lotr", "moby"])

const docs = await client.collection("books").get(["lotr", "moby"]);

The result is a key-value mapping: each key is a document ID and each value is a full document as it was upserted into the collection.

# Example response
{
	"lotr": {
		"_id": "lotr",
		"title": "The Lord of the Rings",
		"author": "J.R.R. Tolkien",
		"published_year": 1954
	},
	"moby": {
		"_id": "moby",
		"title": "Moby Dick",
		"author": "Herman Melville",
		"published_year": 1851
	}
}

// Example response
{
	lotr: {
	_id: "lotr",
		title: "The Lord of the Rings",
		author: "J.R.R. Tolkien",
		published_year: 1954
	},
	moby: {
	_id: "moby",
		title: "Moby Dick",
		author: "Herman Melville",
		published_year: 1851
	}
}

If a document with a given ID does not exist in the collection, it is simply omitted from the results - no error is thrown.

Query Datasets

Overview

Dataset API

Collection API

Management API