Skip to main content
Polyvia turns visual & multimodal documents into a queryable knowledge graph. This guide takes you from zero to a cited answer.

1. Get an API key

1

Sign in to Polyvia Platform

Open the Polyvia Platform and sign up or log in.
2

Create a key

Open API in the sidebar of the Polyvia Platform, then Create API Key. Copy it — it’s shown only once. All keys start with poly_.
In the snippets below you can paste your key straight into api_key to get going. For real projects, keep it out of code instead — run export POLYVIA_API_KEY=poly_<key> and call Polyvia() (or new Polyvia()) with no arguments; the SDK reads the variable automatically. An explicit api_key always takes precedence over the environment variable.

2. Install an SDK

Prefer raw HTTP? Every example here maps 1:1 to the REST API Reference. No SDK required.

3a. Ingest & query — a single file

Ingestion is asynchronous: upload returns a task_id, then you poll (or wait) until it’s completed. Once indexed, query in natural language and get an answer grounded in the exact source page.

3b. Ingest & query — across many documents

The power of Polyvia is querying a whole corpus jointly. Ingest a batch into a group, then ask one question across all of it.

Next steps

Core concepts

Documents, groups, ingestion, citations.

Python SDK

Async client, error handling, agent tools.

MCP Server

Use Polyvia from Claude, Cursor and agents.
Need help? Email mgierlach5@gmail.com.