Pinecone’s APIs let you interact programatically with your Pinecone account.

Database API

Use the Database API to store and query records in the Pinecone Vector Database. This API is comprised of data plane and control plane endpoints:

  • The data plane handles requests to write and read records in indexes. Indexes are partitioned into one or more logical namespaces, and all write and read requests are scoped by namespace.

    For each index, there is a unique URL for performing data plane operations in the form of https://{index_host}/{operation}. The Pinecone SDKs construct these URLs for you. However, when using the API directly, you must explicitly specify them.

    You can get index URLs in the Pinecone console or using the describe_index operation. For more details, see Get an index endpoint.

  • The control plane handles requests to create and manage indexes and collections.

    The global URL for all control plane operations is https://api.pinecone.io. You use this URL regardless of the cloud environment where an index is hosted.

Inference API

Use the Inference API to generate embeddings for text data such as queries or passages and to rerank items like text documents.

Assistant API

Use the Assistant API to upload documents, ask questions, and receive responses that reference your documents. This is known as retrieval-augmented generation (RAG).

Was this page helpful?