Retrieve context snippets

Retrieve context snippets and citations from an assistant to use with your own LLM, RAG application, or agentic workflow.

To try this in your browser, use the Pinecone Assistant - Context colab notebook.

Retrieve snippets with the API or an SDK

To retrieve context snippets from an assistant, call context:

from pinecone import Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")

response = pc.assistants.context(
    assistant_name="example-assistant",
    query="Who is the CFO of Netflix?",
)

for snippet in response.snippets:
    print(snippet)

import { Pinecone } from '@pinecone-database/pinecone';

const pc = new Pinecone({ apiKey: 'YOUR_API_KEY' });

const assistant = pc.assistant({ name: 'example-assistant' });
const response = await assistant.context({
  query: 'Who is the CFO of Netflix?',
});
console.log(response);

PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"

curl "https://prod-1-data.ke.pinecone.io/assistant/chat/$ASSISTANT_NAME/context" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Pinecone-Api-Version: 2026-07" \
  -d '{
    "query": "Who is the CFO of Netflix?"
}'

The example above returns a response like the following:

Response

{
    "snippets":
    [
        {
            "type":"text",
            "content":"EXHIBIT 31.3\nCERTIFICATION OF CHIEF FINANCIAL OFFICER\nPURSUANT TO SECTION 302 OF THE SARBANES-OXLEY ACT OF 2002\nI, Spencer Neumann, certify that: ..."
            "score":0.9960699,
            "reference":
            {
                "type":"pdf",
                "file":
                {
                    "status":"Available",
                    "id":"e6034e51-0bb9-4926-84c6-70597dbd07a7",
                    "name":"Netflix-10-K-01262024.pdf",
                    "size":1073470,
                    "metadata":null,
                    "updated_on":"2024-11-21T22:59:10.426001030Z",
                    "created_on":"2024-11-21T22:58:35.879120257Z", 
                    "signed_url":"https://storage.googleapis.com..."
                    },
                "pages":[78]
            }
        },
{
    "type":"text",
    "content":"EXHIBIT 32.1\n..."
...

signed_url provides temporary, read-only access to the relevant file. Anyone with the link can access the file, so treat it as sensitive data. Expires in one hour.

Control the snippets retrieved

This is available in API versions 2025-04 and later.

You can limit token usage by tuning top_k * snippet_size:

snippet_size: Controls the max size of a snippet, from 512 to 8192 tokens (default 2048). Note that snippet size can vary and, in rare cases, may be bigger than the set snippet_size. Snippet size controls the amount of context given for each chunk of text.
top_k: Controls the max number of context snippets retrieved, up to 64 (default 16). top_k controls the diversity of information received in the returned snippets.

While additional tokens will be used for other parameters, adjusting the top_k and snippet_size can help manage token consumption.

from pinecone import Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")

response = pc.assistants.context(
    assistant_name="example-assistant",
    query="Who is the CFO of Netflix?",
    top_k=10,
    snippet_size=2500,
)

for snippet in response.snippets:
    print(snippet)

PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"

curl "https://prod-1-data.ke.pinecone.io/assistant/chat/$ASSISTANT_NAME/context" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Pinecone-Api-Version: 2026-07" \
  -d '{
    "query": "Who is the CFO of Netflix?",
    "top_k": 10,
    "snippet_size": 2500
}'

Get started

Build an assistant

Upload your data

Chat with an assistant

Context snippets

Evaluate answers

Agents

Admin

Retrieve context snippets

Retrieve snippets with the API or an SDK

Control the snippets retrieved

​Retrieve snippets with the API or an SDK

​Control the snippets retrieved

Retrieve snippets with the API or an SDK

Control the snippets retrieved