td-client
Treasure Data API library for Python
Decision gist · record as of 2026-08-14
Yes, if you use Treasure Data. The library is stable, has low install friction, carries no known vulnerabilities, and provides both raw API access and Database API compatibility. The 197-day release gap suggests maintenance is reactive rather than proactive, so verify that it still aligns with your Treasure Data API version before relying on it for production.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Treasure Data API key must be provided via TD_API_KEY environment variable or apikey= argument.
- Low install friction with three common runtime dependencies.
License · maintenance · safety
Apache Software License (permissive) — Apache Software License (permissive) allows use in most projects with minimal restrictions; you must include a copy of the license and state significant changes.
last release 2026-01-29 (197 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 370,233 downloads/mo, #7,181 on PyPI
Alternatives
Verify before relying
pip install td-client
import tdclient
with tdclient.Client() as td:
for job in td.jobs():
print(job.job_id)- Whether the 197-day release gap indicates active maintenance or dormancy relative to Treasure Data's own API evolution.
- Current state of SSL certificate verification and whether certifi is still recommended or now bundled.
- Whether the package implements the full Python Database API v2.0 specification or a subset.
What it is and what it does
td-client is a Python wrapper around Treasure Data's REST API that lets you run queries, manage jobs, and import data into Treasure Data's cloud warehouse. It supports direct API calls and Database API compatibility for tools like pandas. The library includes comprehensive type hints for static type checking and handles streaming imports, bulk batch imports, and result retrieval.
You interact with Treasure Data through a Client context manager, passing your API key and choosing an endpoint. The package handles authentication, request formatting, and response parsing. It depends on python-dateutil, msgpack, and urllib3 for date handling, binary serialization, and HTTP requests respectively.
Use it for
- Run SQL queries (Hive or Presto) against Treasure Data and retrieve results row-by-row in Python.
- List and monitor query jobs running on Treasure Data, checking status and retrieving results.
- Import CSV or JSON files into Treasure Data tables in streaming or batch mode with custom column type handling.
- Load Treasure Data query results into DataFrames using pandas with Database API compatibility.
- Bulk import msgpack-formatted data with error tracking and validation before committing to the warehouse.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Treasure Data.
The library is stable, has low install friction, carries no known vulnerabilities, and provides both raw API access and Database API compatibility. The 197-day release gap suggests maintenance is reactive rather than proactive, so verify that it still aligns with your Treasure Data API version before relying on it for production.
Install
td-client on PyPI
Before you install
Low install friction with three common runtime dependencies. Package is aging (197 days since last release) but maintains stable support for Python 3.10 through 3.14 and PyPy.
Requires Python 3.10 or later. Treasure Data API key must be provided via TD_API_KEY environment variable or apikey= argument.
License in practice
Apache Software License (permissive) allows use in most projects with minimal restrictions; you must include a copy of the license and state significant changes.
Quickstart
pip install td-client
import tdclient
with tdclient.Client() as td:
for job in td.jobs():
print(job.job_id)Verify before relying
- Whether the 197-day release gap indicates active maintenance or dormancy relative to Treasure Data's own API evolution.
- Current state of SSL certificate verification and whether certifi is still recommended or now bundled.
- Whether the package implements the full Python Database API v2.0 specification or a subset.
Package facts
| License | Apache Software License permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagespython-dateutilmsgpackurllib3 |
| Maintenance | Aging 197 days since the last release |
| First released | |
| Downloads | 370,233 / month, #7,181 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: Web EnvironmentIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Internet |
Evidence: td_client-1.7.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “treasure data python client”
- td-clientPython client library for the Treasure Data REST API, enabling…
- pytdpytd provides Python interfaces to Treasure Data's REST APIs, Presto…
- pandas-tdPandas-TD connects pandas DataFrames to Treasure Data's cloud…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also pandas-td · pytd · salesforce-bulk · Nasdaq-Data-Link · Quandl · scrapinghub · robin-stocks · sqlite-utils · hdbcli · dbs3-pycurl