---
title: Python client library
description: Use the InfluxDB Python client library to interact with InfluxDB.
url: https://docs.influxdata.com/influxdb3/core/reference/client-libraries/v2/python/
estimated_tokens: 1074
product: InfluxDB 3 Core
version: core
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/core/reference/client-libraries/v2/python/
date: '2025-04-09T17:03:44-05:00'
lastmod: '2025-04-09T17:03:44-05:00'
---

#### Use InfluxDB 3 clients to query

InfluxDB 3 supports [compatibility endpoints for *writing data*](/influxdb3/core/write-data/compatibility-apis/) using InfluxDB v2 and v1 tools. However, the `/api/v2/query` API endpoint and associated tooling, such as InfluxDB v2 client libraries and the `influx` CLI, *can’t query* data stored in InfluxDB 3 Core.

[InfluxDB 3 client libraries](/influxdb3/core/reference/client-libraries/v3/) are available that integrate with your code to write and query data stored in InfluxDB 3 Core.

[**Compare tools you can use**](/influxdb3/core/get-started/#tools-to-use) to interact with InfluxDB 3 Core.

Use the [InfluxDB Python client library](https://github.com/influxdata/influxdb-client-python) to integrate InfluxDB into Python scripts and applications.

This guide presumes some familiarity with Python and InfluxDB.
If just getting started, see [Get started with InfluxDB](/influxdb3/core/get-started/).

## Before you begin

You’ll need the following prerequisites:

1. Install the InfluxDB Python library:

   ```
   pip install influxdb-client
   ```

2. InfluxDB Cloud Dedicated cluster URL using the HTTPS protocol–for example:

   ```
   https://localhost:8181
   ```

3. Name of the [database](/influxdb3/core/admin/databases/) to write to.

4. InfluxDB [database token](/influxdb3/core/admin/tokens/#database-tokens)with permission to write to the database.*For security reasons, we recommend setting an environment variable to store your token and avoid exposing the raw token value in your script.*

## Write data to InfluxDB with Python

Follow the steps to write [line protocol](/influxdb3/core/reference/syntax/line-protocol/) data to an InfluxDB Cloud Dedicated database.

1. In your editor, create a file for your Python program–for example: `write.py`.

2. In the file, import the InfluxDB client library.

   ```
   import influxdb_client
   from influxdb_client.client.write_api import SYNCHRONOUS
   import os
   ```

3. Define variables for your [database name](/influxdb3/core/admin/databases/), organization (required, but ignored), and [database token](/influxdb3/core/admin/tokens/#database-tokens).

   ```
   database = "DATABASE_NAME"
   org = "ignored"
   # INFLUX_TOKEN is an environment variable you created for your database WRITE token
   token = os.getenv('INFLUX_TOKEN')
   url="https://localhost:8181"
   ```

4. To instantiate the client, call the `influxdb_client.InfluxDBClient()` method with the following keyword arguments: `url`, `org`, and `token`.

   ```
   client = influxdb_client.InfluxDBClient(
      url=url,
      token=token,
      org=org
   )
   ```

   The `InfluxDBClient` object has a `write_api` method used for configuration.

5. Instantiate a **write client** by calling the `client.write_api()` method with write configuration options.

   ```
   write_api = client.write_api(write_options=SYNCHRONOUS)
   ```

6. Create a [point](/influxdb3/core/reference/glossary/#point) object and write it to InfluxDB using the `write` method of the API writer object. The write method requires three parameters: `bucket`, `org`, and `record`.

   ```
   p = influxdb_client.Point("my_measurement").tag("location", "Prague").field("temperature", 25.3)
   write_api.write(bucket=database, org=org, record=p)
   ```

### Complete example write script

```python
import influxdb_client
from influxdb_client.client.write_api import SYNCHRONOUS
import os

database = "DATABASE_NAME"
org = "ignored"
# INFLUX_TOKEN is an environment variable you created for your database WRITE token
token = os.getenv('INFLUX_TOKEN')
url="https://localhost:8181"

client = influxdb_client.InfluxDBClient(
    url=url,
    token=token,
    org=org
)

# Write script
write_api = client.write_api(write_options=SYNCHRONOUS)

p = influxdb_client.Point("my_measurement").tag("location", "Prague").field("temperature", 25.3)
write_api.write(bucket=database, org=org, record=p)
```

## Query data from InfluxDB with Python

The InfluxDB v2 Python client can’t query InfluxDB Cloud Dedicated.
To query your dedicated instance, use a Python [Flight SQL client with gRPC](/influxdb3/core/reference/client-libraries/flight-sql/).

[client libraries](/influxdb3/core/tags/client-libraries/)[python](/influxdb3/core/tags/python/)