Skip to main content
Every index has its own unique host URL, such as docs-example-4zo0ijk.svc.us-east1-aws.pinecone.io. Data operations, such as upsert, search, and fetch, go to the index host. Operations that manage indexes go to api.pinecone.io instead. When you target an index by name, the SDK first calls describe_index to look up the index host. That’s an extra call to api.pinecone.io and another point of failure, so in production, target the index by host instead. This method is recommended for production:
When using Private Endpoints for private connectivity between your application and Pinecone, you must target the index using the Private Endpoint URL for the host.

Get an index host

You can get the unique DNS host for an index from the Pinecone console or the Pinecone API. To get an index host from the Pinecone console:
  1. Open the Pinecone console.
  2. Select the project containing the index.
  3. Select the index.
  4. Copy the URL under HOST.
To get an index host from the Pinecone API, use the Describe an index operation, which returns the index host as the host value:

Target by index name

This method is convenient for testing but isn’t recommended for production: