dataxapi 0.2.0__tar.gz → 0.3.0__tar.gz

dataxapi-0.3.0/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+All notable changes to the `dataxapi` Python package are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the package uses [Semantic Versioning](https://semver.org/) (while below 1.0.0, a minor version may change defaults or behavior).
+
+## [0.3.0]
+
+This release adopts the DataXAPI brand names, changes the default timeout and the automatic retry rules, and adds types for test keys and partial results. No API operation was added, removed or renamed since 0.2.1 (151 operations). See [Upgrading from 0.2.x](#upgrading-from-02x).
+
+### Added
+
+- `DataXClient`, `DataXError`, `DataXConnectionError` and `DataXPaginationError` are now the primary exports of `dataxapi`.
+- Constants `DEFAULT_TIMEOUT` (60.0), `IN_PROGRESS_WAIT_LIMIT` (90.0) and `NON_RETRYABLE_CODES` in `dataxapi.client`.
+- Test keys: an `sk_test_...` key works with the same client. Calls are validated like live calls, return the API's documented example and are never charged; responses carry `meta["mode"] == "test"`. See [Test keys](https://dataxapi.com/en/docs/authentication/#test-keys).
+- Response `TypedDict`s: optional `meta["mode"]` (`"test"`) on every operation, and `meta["delivered_count"]` / `meta["filtered_count"]` on operations that can return `partial` results (items returned vs. items removed for rights reasons).
+- `Usage`: `mode` (`"live" | "test"`); `status` is now `Literal["reserved", "complete", "empty", "partial", "failed"]` instead of `str`.
+- `Problem`: `limit_scope` (`"workspace" | "api_key" | "listing"`) on `rate_limited`; `request_id` may be `None`.
+- The API can now answer with these problem codes, raised as `DataXError`: `no_results` (404; since 2026-10-08 live calls no longer return it, see Changed), `not_found` (404: the data source states that the requested object does not exist), `route_not_found` (404), `method_not_allowed` (405), `account_suspended` (403) and `invalid_test_scenario` (400, test keys only). See [Errors](https://dataxapi.com/en/docs/errors/).
+- `client.call()` with an unknown operation id raises a `ValueError` that names the id, before any request is sent (0.2.x raised a bare `KeyError`).
+- Package metadata: the "Documentation" link now points to the docs center; the API catalog has its own link.
+
+### Changed
+
+- **Empty results are charged on every API (2026-10-08).** When the data source answers normally but has no data, the API returns 200 with `meta.result_status: "empty"` and charges the unit price, because the data source bills that lookup; data-source failures stay free. The 142 APIs that used to answer a free 404 `no_results` now do this, so `no_results` is no longer returned by live calls. The code stays in the types and in `NON_RETRYABLE_CODES` so existing error handling keeps working.
+- **Default `timeout` per network attempt is 60 seconds (was 10 seconds)**, above the slowest data source's own timeout, so slow sources no longer end in `DataXConnectionError` by default.
+- **`409 request_in_progress` is polled with the same idempotency key** for up to about 90 seconds, waiting `retry_after_ms` between polls, and no longer uses up `max_retries`. The original call may still be charged; polling returns its result instead of starting a new call. `max_retries=0` turns this off.
+- **Deterministic error codes are never retried automatically**: `upstream_failed`, `upstream_schema_changed`, `settlement_failed`, `previous_execution_failed`, `no_results`, `not_found`, `route_not_found`, `method_not_allowed`, `listing_paused` and `account_suspended`. In 0.2.x every 5xx except `listing_paused` was retried with the same key, which could only repeat the same answer.
+- Network errors and timeouts are retried with exponential backoff and jitter (about 0.25 s, 0.5 s, 1 s …, at most 8 s and never longer than the timeout) instead of immediately.
+- Default error messages say "DataXAPI" instead of "Exact API".
+
+### Deprecated
+
+- `ExactApiClient`, `ExactApiError`, `ExactApiConnectionError` and `ExactApiPaginationError` remain as aliases of the new classes (the same class objects, so `except ExactApiError` keeps working) and will be removed in a future major version.
+
+### Upgrading from 0.2.x
+
+1. `pip install -U "dataxapi>=0.3,<0.4"`. Existing code keeps working: the old names are aliases.
+2. Rename imports when convenient: `ExactApiClient` → `DataXClient`, `ExactApiError` → `DataXError`, `ExactApiConnectionError` → `DataXConnectionError`, `ExactApiPaginationError` → `DataXPaginationError`.
+3. If you relied on the old 10-second timeout to fail fast, pass `timeout=10`. With the defaults, a call that keeps hitting network timeouts can take about three minutes (3 attempts × 60 s) before `DataXConnectionError`.
+4. `upstream_failed`, `upstream_schema_changed`, `settlement_failed` and `previous_execution_failed` are no longer retried for you. They are not charged; retry later yourself with a **new** `idempotency_key` if you still need the data.
+5. A call that meets `request_in_progress` can now wait up to about 90 seconds inside the SDK. Use `max_retries=0` if your code polls on its own.
+6. If you caught `KeyError` for a mistyped operation id, catch `ValueError` instead.
+7. Type checkers: `Usage["status"]` is now a `Literal` union and `Problem["request_id"]` can be `None`.
+
+## 0.2.1 and earlier
+
+0.1.0 (2026-09-17), 0.2.0 (2026-09-19) and 0.2.1 (2026-09-20) were published before this changelog existed.
+
+## 中文摘要
+
+0.3.0 主要变化：
+
+- 新名称 `DataXClient`、`DataXError`、`DataXConnectionError`、`DataXPaginationError`；旧的 `ExactApi*` 名称继续可用，作为兼容别名保留。
+- 每次网络尝试的默认超时从 10 秒改为 60 秒。
+- 遇到 `request_in_progress` 时，用同一个幂等 Key 继续等待最多约 90 秒，拿到首次调用的结果，不占用 `max_retries`。
+- `upstream_failed`、`no_results`、`not_found` 等重试也不会变的错误不再自动重试；网络错误改为逐步加长、带随机抖动的等待后重试。
+- 支持测试 Key（`sk_test_`）：返回示例数据、不扣费，响应里 `meta["mode"]` 为 `"test"`；新增 `delivered_count` / `filtered_count` 等类型和 5 个新错误码。
+- 写错接口名时抛出 `ValueError`（原来是 `KeyError`）。
+- 接口本身没有增删或改名。升级方法见上面的 "Upgrading from 0.2.x"。

dataxapi-0.3.0/MANIFEST.in

@@ -0,0 +1 @@
+include CHANGELOG.md

dataxapi-0.3.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: dataxapi
+Version: 0.3.0
+Summary: DataXAPI Python SDK: exact public social data endpoints with one CNY balance
+Author-email: "DataXAPI (Aurevant LLC)" <support@dataxapi.com>
+License-Expression: MIT
+Project-URL: Homepage, https://dataxapi.com
+Project-URL: Documentation, https://dataxapi.com/en/docs/
+Project-URL: API catalog, https://dataxapi.com/en/apis/
+Project-URL: Changelog, https://dataxapi.com/en/docs/sdks/#upgrade
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# DataXAPI Python SDK
+
+Typed client for [DataXAPI](https://dataxapi.com): fixed, per-call-priced public social data APIs (X, Reddit, Xiaohongshu, Douyin, TikTok, Instagram, YouTube, Bilibili, Weibo, Kuaishou, Zhihu) paid from one CNY balance.
+
+The input, output and error `TypedDict`s are generated from the current API catalog / [OpenAPI document](https://dataxapi.com/openapi.json). The runtime only handles authentication, timeouts, safe retries with one idempotency key, pagination and Usage lookups. It has no third-party dependencies.
+
+## Install
+
+```sh
+pip install dataxapi
+```
+
+Python 3.11 or later.
+
+## Authenticate
+
+Create an API key in the [Console](https://dataxapi.com/en/console/) and keep it in an environment variable:
+
+```sh
+export DATAXAPI_API_KEY="sk_live_..."
+```
+
+For development and tests, use a test key (`sk_test_...`, created with the Console's "Test key" switch) with the same client: calls are validated like live calls but return each API's documented example with `meta["mode"] == "test"` and are never charged. See [Test keys](https://dataxapi.com/en/docs/authentication/#test-keys).
+
+## Call an API
+
+```python
+import os
+import uuid
+
+from dataxapi import DataXClient
+
+client = DataXClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])
+
+# Every API is available by its operationId (the OpenAPI operationId).
+result = client.call(
+    "x_posts_search_v1",
+    {"query": "OpenAI min_faves:100"},
+    # Optional. Store the key with your job and reuse it when you retry the same
+    # logical call: the retry returns the original result and is not charged again.
+    idempotency_key=str(uuid.uuid4()),
+)
+
+print(len(result["data"]["items"]), result["meta"]["charged_amount"], result["meta"]["balance_after"])
+```
+
+When you do not pass `idempotency_key`, the SDK generates one per call and reuses it for its own automatic retries. Unknown operation ids raise a `ValueError` that names the id.
+
+## Errors and retries
+
+- `DataXError`: the API answered with a non-2xx problem. Attributes: `status`, `code`, `detail`, `request_id`, `charge_status`, `charged_amount`, `retry_after_ms`, `retry_after`, `idempotency_key`.
+- `DataXConnectionError`: the outcome is unknown (network error or timeout). Retry later with `error.idempotency_key` so the call cannot run or charge twice.
+
+Built-in behavior (defaults: `timeout=60` seconds per attempt, `max_retries=2`):
+
+- `429 rate_limited` and retryable `5xx` errors are retried with the same key after the server's `retry_after_ms` / `Retry-After`.
+- `409 request_in_progress` means the original call with that key is still running (`charge_status` is `unknown` until it settles). The SDK waits `retry_after_ms` and polls with the same key for up to about 90 seconds; this does not use up `max_retries`. Set `max_retries=0` to disable all automatic retries.
+- Network errors are retried with exponential backoff and jitter, with the same key.
+- Codes that repeat deterministically are never retried: `upstream_failed`, `upstream_schema_changed`, `settlement_failed`, `previous_execution_failed`, `no_results`, `not_found`, `route_not_found`, `method_not_allowed`, `listing_paused`, `account_suspended`, and other 4xx errors. (`no_results` is no longer returned since 2026-10-08: an empty result is a charged 200 with `meta.result_status` `"empty"`.)
+
+```python
+from dataxapi import DataXConnectionError, DataXError
+
+try:
+    client.call("x_posts_search_v1", {"query": "OpenAI"})
+except DataXError as error:
+    print(error.status, error.code, error.request_id, error.charge_status)
+except DataXConnectionError as error:
+    print("retry later with", error.idempotency_key)
+```
+
+`DataXPaginationError` is raised when a page iterator sees a repeated cursor. `ExactApiClient`, `ExactApiError`, `ExactApiConnectionError` and `ExactApiPaginationError` remain as deprecated aliases of these classes.
+
+## Upgrading from 0.2.x
+
+0.3.0 renames the classes (old names still work), raises the default timeout from 10 to 60 seconds, polls `request_in_progress` with the same key, and stops retrying errors that a retry would only repeat. See `CHANGELOG.md` in the source distribution and the [upgrade notes](https://dataxapi.com/en/docs/sdks/#upgrade).
+
+## Links
+
+- Docs: <https://dataxapi.com/en/docs/> (中文：<https://dataxapi.com/zh/docs/>)
+- SDK guide: <https://dataxapi.com/en/docs/sdks/>
+- Upgrade notes: <https://dataxapi.com/en/docs/sdks/#upgrade>
+- Errors: <https://dataxapi.com/en/docs/errors/>
+- API catalog and prices: <https://dataxapi.com/en/apis/>
+- OpenAPI: <https://dataxapi.com/openapi.json>
+- MCP server for AI agents: <https://dataxapi.com/en/docs/mcp/>
+
+## 中文说明
+
+`dataxapi` 是 DataXAPI 的 Python SDK：用一个 API Key、一个人民币余额按次调用各平台的公开数据接口。
+
+- 安装：`pip install dataxapi`（Python 3.11+，无第三方依赖）。
+- 用法：`DataXClient("https://api.dataxapi.com", api_key)`，再用 `client.call("<operationId>", 参数, idempotency_key=...)` 调用任意接口。
+- 重试：同一个逻辑调用复用同一个 `idempotency_key`，重试不会重复执行或扣费；SDK 自动重试 429 和可重试的 5xx，遇到 `request_in_progress` 会用同一个 Key 等待最多约 90 秒；`upstream_failed`、`no_results`、`not_found` 等确定性错误不自动重试。
+- 默认每次尝试超时 60 秒，`max_retries` 默认 2。
+- 文档：<https://dataxapi.com/zh/docs/>，SDK 说明：<https://dataxapi.com/zh/docs/sdks/>。
+- 从 0.2.x 升级：旧名称仍可用，默认超时由 10 秒改为 60 秒，重试规则有调整，见源码包中的 `CHANGELOG.md` 和 <https://dataxapi.com/zh/docs/sdks/#upgrade>。
+
+## License
+
+MIT

dataxapi-0.3.0/README.md

@@ -0,0 +1,101 @@
+# DataXAPI Python SDK
+
+Typed client for [DataXAPI](https://dataxapi.com): fixed, per-call-priced public social data APIs (X, Reddit, Xiaohongshu, Douyin, TikTok, Instagram, YouTube, Bilibili, Weibo, Kuaishou, Zhihu) paid from one CNY balance.
+
+The input, output and error `TypedDict`s are generated from the current API catalog / [OpenAPI document](https://dataxapi.com/openapi.json). The runtime only handles authentication, timeouts, safe retries with one idempotency key, pagination and Usage lookups. It has no third-party dependencies.
+
+## Install
+
+```sh
+pip install dataxapi
+```
+
+Python 3.11 or later.
+
+## Authenticate
+
+Create an API key in the [Console](https://dataxapi.com/en/console/) and keep it in an environment variable:
+
+```sh
+export DATAXAPI_API_KEY="sk_live_..."
+```
+
+For development and tests, use a test key (`sk_test_...`, created with the Console's "Test key" switch) with the same client: calls are validated like live calls but return each API's documented example with `meta["mode"] == "test"` and are never charged. See [Test keys](https://dataxapi.com/en/docs/authentication/#test-keys).
+
+## Call an API
+
+```python
+import os
+import uuid
+
+from dataxapi import DataXClient
+
+client = DataXClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])
+
+# Every API is available by its operationId (the OpenAPI operationId).
+result = client.call(
+    "x_posts_search_v1",
+    {"query": "OpenAI min_faves:100"},
+    # Optional. Store the key with your job and reuse it when you retry the same
+    # logical call: the retry returns the original result and is not charged again.
+    idempotency_key=str(uuid.uuid4()),
+)
+
+print(len(result["data"]["items"]), result["meta"]["charged_amount"], result["meta"]["balance_after"])
+```
+
+When you do not pass `idempotency_key`, the SDK generates one per call and reuses it for its own automatic retries. Unknown operation ids raise a `ValueError` that names the id.
+
+## Errors and retries
+
+- `DataXError`: the API answered with a non-2xx problem. Attributes: `status`, `code`, `detail`, `request_id`, `charge_status`, `charged_amount`, `retry_after_ms`, `retry_after`, `idempotency_key`.
+- `DataXConnectionError`: the outcome is unknown (network error or timeout). Retry later with `error.idempotency_key` so the call cannot run or charge twice.
+
+Built-in behavior (defaults: `timeout=60` seconds per attempt, `max_retries=2`):
+
+- `429 rate_limited` and retryable `5xx` errors are retried with the same key after the server's `retry_after_ms` / `Retry-After`.
+- `409 request_in_progress` means the original call with that key is still running (`charge_status` is `unknown` until it settles). The SDK waits `retry_after_ms` and polls with the same key for up to about 90 seconds; this does not use up `max_retries`. Set `max_retries=0` to disable all automatic retries.
+- Network errors are retried with exponential backoff and jitter, with the same key.
+- Codes that repeat deterministically are never retried: `upstream_failed`, `upstream_schema_changed`, `settlement_failed`, `previous_execution_failed`, `no_results`, `not_found`, `route_not_found`, `method_not_allowed`, `listing_paused`, `account_suspended`, and other 4xx errors. (`no_results` is no longer returned since 2026-10-08: an empty result is a charged 200 with `meta.result_status` `"empty"`.)
+
+```python
+from dataxapi import DataXConnectionError, DataXError
+
+try:
+    client.call("x_posts_search_v1", {"query": "OpenAI"})
+except DataXError as error:
+    print(error.status, error.code, error.request_id, error.charge_status)
+except DataXConnectionError as error:
+    print("retry later with", error.idempotency_key)
+```
+
+`DataXPaginationError` is raised when a page iterator sees a repeated cursor. `ExactApiClient`, `ExactApiError`, `ExactApiConnectionError` and `ExactApiPaginationError` remain as deprecated aliases of these classes.
+
+## Upgrading from 0.2.x
+
+0.3.0 renames the classes (old names still work), raises the default timeout from 10 to 60 seconds, polls `request_in_progress` with the same key, and stops retrying errors that a retry would only repeat. See `CHANGELOG.md` in the source distribution and the [upgrade notes](https://dataxapi.com/en/docs/sdks/#upgrade).
+
+## Links
+
+- Docs: <https://dataxapi.com/en/docs/> (中文：<https://dataxapi.com/zh/docs/>)
+- SDK guide: <https://dataxapi.com/en/docs/sdks/>
+- Upgrade notes: <https://dataxapi.com/en/docs/sdks/#upgrade>
+- Errors: <https://dataxapi.com/en/docs/errors/>
+- API catalog and prices: <https://dataxapi.com/en/apis/>
+- OpenAPI: <https://dataxapi.com/openapi.json>
+- MCP server for AI agents: <https://dataxapi.com/en/docs/mcp/>
+
+## 中文说明
+
+`dataxapi` 是 DataXAPI 的 Python SDK：用一个 API Key、一个人民币余额按次调用各平台的公开数据接口。
+
+- 安装：`pip install dataxapi`（Python 3.11+，无第三方依赖）。
+- 用法：`DataXClient("https://api.dataxapi.com", api_key)`，再用 `client.call("<operationId>", 参数, idempotency_key=...)` 调用任意接口。
+- 重试：同一个逻辑调用复用同一个 `idempotency_key`，重试不会重复执行或扣费；SDK 自动重试 429 和可重试的 5xx，遇到 `request_in_progress` 会用同一个 Key 等待最多约 90 秒；`upstream_failed`、`no_results`、`not_found` 等确定性错误不自动重试。
+- 默认每次尝试超时 60 秒，`max_retries` 默认 2。
+- 文档：<https://dataxapi.com/zh/docs/>，SDK 说明：<https://dataxapi.com/zh/docs/sdks/>。
+- 从 0.2.x 升级：旧名称仍可用，默认超时由 10 秒改为 60 秒，重试规则有调整，见源码包中的 `CHANGELOG.md` 和 <https://dataxapi.com/zh/docs/sdks/#upgrade>。
+
+## License
+
+MIT

{dataxapi-0.2.0 → dataxapi-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dataxapi"
-version = "0.2.0"
+version = "0.3.0"
 requires-python = ">=3.11"
 description = "DataXAPI Python SDK: exact public social data endpoints with one CNY balance"
 readme = "README.md"
@@ -15,7 +15,9 @@ classifiers = [
 
 [project.urls]
 Homepage = "https://dataxapi.com"
-Documentation = "https://dataxapi.com/en/apis/"
+Documentation = "https://dataxapi.com/en/docs/"
+"API catalog" = "https://dataxapi.com/en/apis/"
+Changelog = "https://dataxapi.com/en/docs/sdks/#upgrade"
 
 [build-system]
 requires = ["setuptools>=77"]

dataxapi-0.3.0/src/dataxapi/__init__.py

@@ -0,0 +1,4 @@
+# Generated by scripts/generate-exact-api-sdks.mjs. Do not edit.
+from .client import DataXClient, DataXConnectionError, DataXError, DataXPaginationError, ExactApiClient, ExactApiConnectionError, ExactApiError, ExactApiPaginationError
+from .generated import Problem, Usage, OperationId, OperationInput, OperationResponse, OPERATIONS, USAGE_OPERATION, EXAMPLES, XPostsSearchV1Input, XPostsSearchV1Response, XPostsDetailV1Input, XPostsDetailV1Response, XUsersProfileV1Input, XUsersProfileV1Response, XUsersPostsV1Input, XUsersPostsV1Response, RedditPostsDetailV1Input, RedditPostsDetailV1Response, RedditPostsSearchV1Input, RedditPostsSearchV1Response, RedditPostsCommentsV1Input, RedditPostsCommentsV1Response, XiaohongshuPgyNotesDetailV1Input, XiaohongshuPgyNotesDetailV1Response, XiaohongshuPgyBloggersDetailV1Input, XiaohongshuPgyBloggersDetailV1Response, XiaohongshuPgyBloggersNotesV1Input, XiaohongshuPgyBloggersNotesV1Response, XiaohongshuPgyBloggersCoredataV1Input, XiaohongshuPgyBloggersCoredataV1Response, XiaohongshuPgyBloggersDatasummaryV1Input, XiaohongshuPgyBloggersDatasummaryV1Response, XiaohongshuNotesDetailV2Input, XiaohongshuNotesDetailV2Response, XiaohongshuNotesSearchV1Input, XiaohongshuNotesSearchV1Response, DouyinVideosDetailV2Input, DouyinVideosDetailV2Response, DouyinVideosSearchV1Input, DouyinVideosSearchV1Response, XPostsRepliesV1Input, XPostsRepliesV1Response, XPostsQuotesV1Input, XPostsQuotesV1Response, XUsersSearchV1Input, XUsersSearchV1Response, XUsersFollowersV1Input, XUsersFollowersV1Response, XUsersFollowingV1Input, XUsersFollowingV1Response, XiaohongshuNotesCommentsV1Input, XiaohongshuNotesCommentsV1Response, XiaohongshuNotesCommentsRepliesV1Input, XiaohongshuNotesCommentsRepliesV1Response, XiaohongshuUsersProfileV1Input, XiaohongshuUsersProfileV1Response, XiaohongshuUsersNotesV1Input, XiaohongshuUsersNotesV1Response, XiaohongshuUsersSearchV1Input, XiaohongshuUsersSearchV1Response, XiaohongshuPgyBloggersPerformanceV1Input, XiaohongshuPgyBloggersPerformanceV1Response, XiaohongshuPgyBloggersFansSummaryV1Input, XiaohongshuPgyBloggersFansSummaryV1Response, XiaohongshuPgyBloggersFansProfileV1Input, XiaohongshuPgyBloggersFansProfileV1Response, XiaohongshuPgyBloggersFansHistoryV1Input, XiaohongshuPgyBloggersFansHistoryV1Response, XiaohongshuPgyBloggersSearchV1Input, XiaohongshuPgyBloggersSearchV1Response, DouyinVideosCommentsV1Input, DouyinVideosCommentsV1Response, DouyinVideosCommentsRepliesV1Input, DouyinVideosCommentsRepliesV1Response, DouyinUsersProfileV1Input, DouyinUsersProfileV1Response, DouyinUsersVideosV2Input, DouyinUsersVideosV2Response, DouyinUsersSearchV1Input, DouyinUsersSearchV1Response, DouyinTrendsHotsearchV1Input, DouyinTrendsHotsearchV1Response, DouyinTrendsRisingV1Input, DouyinTrendsRisingV1Response, DouyinRankingsLowfanV1Input, DouyinRankingsLowfanV1Response, DouyinRankingsHighcompletionV1Input, DouyinRankingsHighcompletionV1Response, DouyinMixesDetailV1Input, DouyinMixesDetailV1Response, DouyinMixesVideosV1Input, DouyinMixesVideosV1Response, XiaohongshuTopicsDetailV1Input, XiaohongshuTopicsDetailV1Response, XiaohongshuTopicsNotesV1Input, XiaohongshuTopicsNotesV1Response, XiaohongshuProductsSearchV1Input, XiaohongshuProductsSearchV1Response, XiaohongshuProductsDetailV1Input, XiaohongshuProductsDetailV1Response, XPostsRetweetersV1Input, XPostsRetweetersV1Response, XTrendsListV1Input, XTrendsListV1Response, XUsersRepliesV1Input, XUsersRepliesV1Response, XUsersMediaV1Input, XUsersMediaV1Response, RedditPostsBatchV1Input, RedditPostsBatchV1Response, RedditSubredditsProfileV1Input, RedditSubredditsProfileV1Response, RedditSubredditsPostsV1Input, RedditSubredditsPostsV1Response, RedditUsersProfileV1Input, RedditUsersProfileV1Response, RedditSearchTrendingV1Input, RedditSearchTrendingV1Response, XPostsThreadContextV1Input, XPostsThreadContextV1Response, XArticlesDetailV1Input, XArticlesDetailV1Response, XUsersMentionsV1Input, XUsersMentionsV1Response, XUsersBatchDetailV1Input, XUsersBatchDetailV1Response, XUsersVerifiedFollowersV1Input, XUsersVerifiedFollowersV1Response, RedditUsersPostsV1Input, RedditUsersPostsV1Response, XiaohongshuProductsReviewsV1Input, XiaohongshuProductsReviewsV1Response, XiaohongshuCreatorInspirationRecommendedV1Input, XiaohongshuCreatorInspirationRecommendedV1Response, XiaohongshuCreatorInspirationHotV1Input, XiaohongshuCreatorInspirationHotV1Response, DouyinVideosBatchDetailV1Input, DouyinVideosBatchDetailV1Response, DouyinVideosRelatedV1Input, DouyinVideosRelatedV1Response, DouyinSearchGeneralV1Input, DouyinSearchGeneralV1Response, DouyinMusicDetailV1Input, DouyinMusicDetailV1Response, DouyinMusicVideosV1Input, DouyinMusicVideosV1Response, DouyinRankingsHighlikeV1Input, DouyinRankingsHighlikeV1Response, DouyinRankingsHighfanV1Input, DouyinRankingsHighfanV1Response, XListsTweetsV1Input, XListsTweetsV1Response, XUsersFollowerIdsV1Input, XUsersFollowerIdsV1Response, XCommunitiesMembersV1Input, XCommunitiesMembersV1Response, XCommunitiesDetailV1Input, XCommunitiesDetailV1Response, XCommunitiesTweetsV1Input, XCommunitiesTweetsV1Response, RedditSearchSuggestionsV1Input, RedditSearchSuggestionsV1Response, RedditSubredditsHighlightsV1Input, RedditSubredditsHighlightsV1Response, RedditSubredditsPostFlairsV1Input, RedditSubredditsPostFlairsV1Response, RedditUsersCommentsV1Input, RedditUsersCommentsV1Response, RedditUsersActiveSubredditsV1Input, RedditUsersActiveSubredditsV1Response, XiaohongshuUsersFavedNotesV1Input, XiaohongshuUsersFavedNotesV1Response, XiaohongshuImagesSearchV1Input, XiaohongshuImagesSearchV1Response, DouyinHashtagsDetailV1Input, DouyinHashtagsDetailV1Response, DouyinHashtagsVideosV1Input, DouyinHashtagsVideosV1Response, DouyinCreatorsSimilarV1Input, DouyinCreatorsSimilarV1Response, DouyinCreatorsTrendsCompareV1Input, DouyinCreatorsTrendsCompareV1Response, DouyinXingtuCreatorsSearchV1Input, DouyinXingtuCreatorsSearchV1Response, DouyinRankingsTopicsV1Input, DouyinRankingsTopicsV1Response, DouyinRankingsSearchesV1Input, DouyinRankingsSearchesV1Response, DouyinXingtuCreatorsBatchDetailV1Input, DouyinXingtuCreatorsBatchDetailV1Response, DouyinXingtuCreatorsAudienceV1Input, DouyinXingtuCreatorsAudienceV1Response, DouyinXingtuCreatorsVideosV1Input, DouyinXingtuCreatorsVideosV1Response, TiktokUsersProfileV1Input, TiktokUsersProfileV1Response, TiktokUsersVideosV1Input, TiktokUsersVideosV1Response, TiktokVideosDetailV1Input, TiktokVideosDetailV1Response, TiktokVideosCommentsV1Input, TiktokVideosCommentsV1Response, TiktokVideosCommentsRepliesV1Input, TiktokVideosCommentsRepliesV1Response, TiktokVideosSearchV1Input, TiktokVideosSearchV1Response, TiktokUsersSearchV1Input, TiktokUsersSearchV1Response, TiktokHashtagsDetailV1Input, TiktokHashtagsDetailV1Response, TiktokHashtagsVideosV1Input, TiktokHashtagsVideosV1Response, TiktokShopProductsSearchV1Input, TiktokShopProductsSearchV1Response, TiktokShopProductsReviewsV1Input, TiktokShopProductsReviewsV1Response, TiktokShopSellersProductsV1Input, TiktokShopSellersProductsV1Response, TiktokAdsSearchV1Input, TiktokAdsSearchV1Response, TiktokAdsDetailV1Input, TiktokAdsDetailV1Response, TiktokAdsSpotlightV1Input, TiktokAdsSpotlightV1Response, TiktokAdsPercentileV1Input, TiktokAdsPercentileV1Response, TiktokTrendsHashtagsV1Input, TiktokTrendsHashtagsV1Response, InstagramUsersProfileV1Input, InstagramUsersProfileV1Response, InstagramUsersPostsV1Input, InstagramUsersPostsV1Response, InstagramUsersReelsV1Input, InstagramUsersReelsV1Response, InstagramPostsDetailV1Input, InstagramPostsDetailV1Response, InstagramPostsCommentsV1Input, InstagramPostsCommentsV1Response, InstagramPostsCommentsRepliesV1Input, InstagramPostsCommentsRepliesV1Response, InstagramUsersSearchV1Input, InstagramUsersSearchV1Response, InstagramHashtagsPostsV1Input, InstagramHashtagsPostsV1Response, YoutubeVideosDetailV1Input, YoutubeVideosDetailV1Response, YoutubeVideosCommentsV1Input, YoutubeVideosCommentsV1Response, YoutubeChannelsProfileV1Input, YoutubeChannelsProfileV1Response, YoutubeChannelsVideosV1Input, YoutubeChannelsVideosV1Response, YoutubeChannelsShortsV1Input, YoutubeChannelsShortsV1Response, YoutubeVideosSearchV1Input, YoutubeVideosSearchV1Response, YoutubeChannelsSearchV1Input, YoutubeChannelsSearchV1Response, YoutubeVideosRelatedV1Input, YoutubeVideosRelatedV1Response, YoutubeVideosCaptionsV1Input, YoutubeVideosCaptionsV1Response, BilibiliVideosDetailV1Input, BilibiliVideosDetailV1Response, BilibiliVideosCommentsV1Input, BilibiliVideosCommentsV1Response, BilibiliVideosCommentsRepliesV1Input, BilibiliVideosCommentsRepliesV1Response, BilibiliUsersProfileV1Input, BilibiliUsersProfileV1Response, BilibiliUsersStatsV1Input, BilibiliUsersStatsV1Response, BilibiliUsersVideosV1Input, BilibiliUsersVideosV1Response, BilibiliVideosSearchV1Input, BilibiliVideosSearchV1Response, BilibiliVideosPopularV1Input, BilibiliVideosPopularV1Response, BilibiliVideosSubtitlesV1Input, BilibiliVideosSubtitlesV1Response, BilibiliHuahuoCreatorsSearchV1Input, BilibiliHuahuoCreatorsSearchV1Response, BilibiliHuahuoCreatorsDetailV1Input, BilibiliHuahuoCreatorsDetailV1Response, BilibiliHuahuoCreatorsFollowersTrendV1Input, BilibiliHuahuoCreatorsFollowersTrendV1Response, BilibiliHuahuoCreatorsVideosTrendV1Input, BilibiliHuahuoCreatorsVideosTrendV1Response, BilibiliHuahuoCreatorsVideosPerformanceV1Input, BilibiliHuahuoCreatorsVideosPerformanceV1Response, BilibiliHuahuoCreatorsSimilarV1Input, BilibiliHuahuoCreatorsSimilarV1Response, BilibiliHuahuoCreatorsShowcaseV1Input, BilibiliHuahuoCreatorsShowcaseV1Response, BilibiliHuahuoRankingsCreatorsV1Input, BilibiliHuahuoRankingsCreatorsV1Response, BilibiliHuahuoRankingsVideosV1Input, BilibiliHuahuoRankingsVideosV1Response, BilibiliHuahuoRankingsSeedingV1Input, BilibiliHuahuoRankingsSeedingV1Response, BilibiliHuahuoRankingsGoodsV1Input, BilibiliHuahuoRankingsGoodsV1Response, BilibiliHuahuoGoodsCreatorsV1Input, BilibiliHuahuoGoodsCreatorsV1Response, WeiboPostsDetailV1Input, WeiboPostsDetailV1Response, WeiboUsersProfileV1Input, WeiboUsersProfileV1Response, WeiboUsersPostsV1Input, WeiboUsersPostsV1Response, WeiboPostsCommentsV1Input, WeiboPostsCommentsV1Response, WeiboCommentsRepliesV1Input, WeiboCommentsRepliesV1Response, WeiboPostsSearchV1Input, WeiboPostsSearchV1Response, WeiboPostsHotV1Input, WeiboPostsHotV1Response, WeiboTrendsHotsearchV1Input, WeiboTrendsHotsearchV1Response, KuaishouVideosDetailV1Input, KuaishouVideosDetailV1Response, KuaishouVideosCommentsV1Input, KuaishouVideosCommentsV1Response, KuaishouVideosCommentsRepliesV1Input, KuaishouVideosCommentsRepliesV1Response, KuaishouUsersProfileV1Input, KuaishouUsersProfileV1Response, KuaishouUsersVideosV1Input, KuaishouUsersVideosV1Response, KuaishouVideosSearchV2Input, KuaishouVideosSearchV2Response, KuaishouUsersSearchV1Input, KuaishouUsersSearchV1Response, KuaishouTrendsHotV1Input, KuaishouTrendsHotV1Response, ZhihuTrendsHotV1Input, ZhihuTrendsHotV1Response, ZhihuSearchContentV1Input, ZhihuSearchContentV1Response, ZhihuUsersSearchV1Input, ZhihuUsersSearchV1Response, ZhihuQuestionsDetailV1Input, ZhihuQuestionsDetailV1Response, ZhihuQuestionsAnswersV1Input, ZhihuQuestionsAnswersV1Response, ZhihuAnswersDetailV1Input, ZhihuAnswersDetailV1Response, ZhihuAnswersCommentsV1Input, ZhihuAnswersCommentsV1Response, ZhihuCommentsRepliesV1Input, ZhihuCommentsRepliesV1Response, ZhihuUsersProfileV1Input, ZhihuUsersProfileV1Response, DouyinIndexHottopicsV1Input, DouyinIndexHottopicsV1Response, DouyinIndexVideosSuggestV1Input, DouyinIndexVideosSuggestV1Response, DouyinIndexCreatorsMetricsV1Input, DouyinIndexCreatorsMetricsV1Response, DouyinIndexCreatorsAudienceV1Input, DouyinIndexCreatorsAudienceV1Response, DouyinIndexCreatorsTopvideosV1Input, DouyinIndexCreatorsTopvideosV1Response, DouyinIndexKeywordsAudienceV1Input, DouyinIndexKeywordsAudienceV1Response, DouyinIndexKeywordsTrendsV1Input, DouyinIndexKeywordsTrendsV1Response, DouyinIndexKeywordsInterpretationV1Input, DouyinIndexKeywordsInterpretationV1Response, DouyinXingtuCreatorsDetailV1Input, DouyinXingtuCreatorsDetailV1Response, DouyinXingtuCreatorsPricesV1Input, DouyinXingtuCreatorsPricesV1Response, DouyinXingtuCreatorsContentkeywordsV1Input, DouyinXingtuCreatorsContentkeywordsV1Response, DouyinXingtuCreatorsSpreadV1Input, DouyinXingtuCreatorsSpreadV1Response, DouyinXingtuCreatorsConversionV1Input, DouyinXingtuCreatorsConversionV1Response, DouyinXingtuCreatorsLinkindexV1Input, DouyinXingtuCreatorsLinkindexV1Response, DouyinXingtuCreatorsContentmixV1Input, DouyinXingtuCreatorsContentmixV1Response, DouyinXingtuRankingsCatalogV1Input, DouyinXingtuRankingsCatalogV1Response, DouyinXingtuRankingsCreatorsV1Input, DouyinXingtuRankingsCreatorsV1Response, DouyinXingtuVideosStatsV1Input, DouyinXingtuVideosStatsV1Response, DouyinXingtuCampaignsV1Input, DouyinXingtuCampaignsV1Response, WechatMpAccountsProfileV1Input, WechatMpAccountsProfileV1Response, WechatMpAccountsArticlesV1Input, WechatMpAccountsArticlesV1Response, WechatMpArticlesDetailV1Input, WechatMpArticlesDetailV1Response, WechatMpArticlesStatsV1Input, WechatMpArticlesStatsV1Response, WechatChannelsUsersProfileV1Input, WechatChannelsUsersProfileV1Response, WechatChannelsUsersVideosV1Input, WechatChannelsUsersVideosV1Response, WechatChannelsVideosDetailV1Input, WechatChannelsVideosDetailV1Response, WechatChannelsVideosCommentsV1Input, WechatChannelsVideosCommentsV1Response, WechatChannelsUsersCollectionsV1Input, WechatChannelsUsersCollectionsV1Response, WechatChannelsCollectionsVideosV1Input, WechatChannelsCollectionsVideosV1Response, WechatChannelsUsersSearchV1Input, WechatChannelsUsersSearchV1Response, WechatSearchGeneralV1Input, WechatSearchGeneralV1Response, WechatSearchVideosV1Input, WechatSearchVideosV1Response, ToutiaoArticlesDetailV1Input, ToutiaoArticlesDetailV1Response, ToutiaoVideosDetailV1Input, ToutiaoVideosDetailV1Response, ToutiaoPostsCommentsV1Input, ToutiaoPostsCommentsV1Response, XiguaVideosSearchV1Input, XiguaVideosSearchV1Response, XiguaVideosCommentsV1Input, XiguaVideosCommentsV1Response, XiguaUsersProfileV1Input, XiguaUsersProfileV1Response, XiguaUsersVideosV1Input, XiguaUsersVideosV1Response, ThreadsUsersProfileV1Input, ThreadsUsersProfileV1Response, ThreadsUsersPostsV1Input, ThreadsUsersPostsV1Response, ThreadsPostsDetailV1Input, ThreadsPostsDetailV1Response, ThreadsPostsSearchV1Input, ThreadsPostsSearchV1Response, LinkedinCompaniesProfileV1Input, LinkedinCompaniesProfileV1Response, LinkedinCompaniesPostsV1Input, LinkedinCompaniesPostsV1Response, LinkedinPostsDetailV1Input, LinkedinPostsDetailV1Response, LinkedinPostsCommentsV1Input, LinkedinPostsCommentsV1Response, LinkedinJobsSearchV1Input, LinkedinJobsSearchV1Response, LinkedinJobsDetailV1Input, LinkedinJobsDetailV1Response, Lemon8UsersProfileV1Input, Lemon8UsersProfileV1Response, Lemon8PostsDetailV1Input, Lemon8PostsDetailV1Response, Lemon8PostsCommentsV1Input, Lemon8PostsCommentsV1Response, Lemon8TrendsHotV1Input, Lemon8TrendsHotV1Response, Lemon8TopicsDetailV1Input, Lemon8TopicsDetailV1Response, Lemon8TopicsPostsV1Input, Lemon8TopicsPostsV1Response, TelegramChannelsProfileV1Input, TelegramChannelsProfileV1Response, TelegramChannelsBatchV1Input, TelegramChannelsBatchV1Response, TelegramChannelsMessagesV1Input, TelegramChannelsMessagesV1Response, TelegramMessagesDetailV1Input, TelegramMessagesDetailV1Response, TelegramChannelsMessagesSearchV1Input, TelegramChannelsMessagesSearchV1Response
+__all__ = ["DataXClient", "DataXConnectionError", "DataXError", "DataXPaginationError", "ExactApiClient", "ExactApiConnectionError", "ExactApiError", "ExactApiPaginationError", "Problem", "Usage", "OperationId", "OperationInput", "OperationResponse", "OPERATIONS", "USAGE_OPERATION", "EXAMPLES", "XPostsSearchV1Input", "XPostsSearchV1Response", "XPostsDetailV1Input", "XPostsDetailV1Response", "XUsersProfileV1Input", "XUsersProfileV1Response", "XUsersPostsV1Input", "XUsersPostsV1Response", "RedditPostsDetailV1Input", "RedditPostsDetailV1Response", "RedditPostsSearchV1Input", "RedditPostsSearchV1Response", "RedditPostsCommentsV1Input", "RedditPostsCommentsV1Response", "XiaohongshuPgyNotesDetailV1Input", "XiaohongshuPgyNotesDetailV1Response", "XiaohongshuPgyBloggersDetailV1Input", "XiaohongshuPgyBloggersDetailV1Response", "XiaohongshuPgyBloggersNotesV1Input", "XiaohongshuPgyBloggersNotesV1Response", "XiaohongshuPgyBloggersCoredataV1Input", "XiaohongshuPgyBloggersCoredataV1Response", "XiaohongshuPgyBloggersDatasummaryV1Input", "XiaohongshuPgyBloggersDatasummaryV1Response", "XiaohongshuNotesDetailV2Input", "XiaohongshuNotesDetailV2Response", "XiaohongshuNotesSearchV1Input", "XiaohongshuNotesSearchV1Response", "DouyinVideosDetailV2Input", "DouyinVideosDetailV2Response", "DouyinVideosSearchV1Input", "DouyinVideosSearchV1Response", "XPostsRepliesV1Input", "XPostsRepliesV1Response", "XPostsQuotesV1Input", "XPostsQuotesV1Response", "XUsersSearchV1Input", "XUsersSearchV1Response", "XUsersFollowersV1Input", "XUsersFollowersV1Response", "XUsersFollowingV1Input", "XUsersFollowingV1Response", "XiaohongshuNotesCommentsV1Input", "XiaohongshuNotesCommentsV1Response", "XiaohongshuNotesCommentsRepliesV1Input", "XiaohongshuNotesCommentsRepliesV1Response", "XiaohongshuUsersProfileV1Input", "XiaohongshuUsersProfileV1Response", "XiaohongshuUsersNotesV1Input", "XiaohongshuUsersNotesV1Response", "XiaohongshuUsersSearchV1Input", "XiaohongshuUsersSearchV1Response", "XiaohongshuPgyBloggersPerformanceV1Input", "XiaohongshuPgyBloggersPerformanceV1Response", "XiaohongshuPgyBloggersFansSummaryV1Input", "XiaohongshuPgyBloggersFansSummaryV1Response", "XiaohongshuPgyBloggersFansProfileV1Input", "XiaohongshuPgyBloggersFansProfileV1Response", "XiaohongshuPgyBloggersFansHistoryV1Input", "XiaohongshuPgyBloggersFansHistoryV1Response", "XiaohongshuPgyBloggersSearchV1Input", "XiaohongshuPgyBloggersSearchV1Response", "DouyinVideosCommentsV1Input", "DouyinVideosCommentsV1Response", "DouyinVideosCommentsRepliesV1Input", "DouyinVideosCommentsRepliesV1Response", "DouyinUsersProfileV1Input", "DouyinUsersProfileV1Response", "DouyinUsersVideosV2Input", "DouyinUsersVideosV2Response", "DouyinUsersSearchV1Input", "DouyinUsersSearchV1Response", "DouyinTrendsHotsearchV1Input", "DouyinTrendsHotsearchV1Response", "DouyinTrendsRisingV1Input", "DouyinTrendsRisingV1Response", "DouyinRankingsLowfanV1Input", "DouyinRankingsLowfanV1Response", "DouyinRankingsHighcompletionV1Input", "DouyinRankingsHighcompletionV1Response", "DouyinMixesDetailV1Input", "DouyinMixesDetailV1Response", "DouyinMixesVideosV1Input", "DouyinMixesVideosV1Response", "XiaohongshuTopicsDetailV1Input", "XiaohongshuTopicsDetailV1Response", "XiaohongshuTopicsNotesV1Input", "XiaohongshuTopicsNotesV1Response", "XiaohongshuProductsSearchV1Input", "XiaohongshuProductsSearchV1Response", "XiaohongshuProductsDetailV1Input", "XiaohongshuProductsDetailV1Response", "XPostsRetweetersV1Input", "XPostsRetweetersV1Response", "XTrendsListV1Input", "XTrendsListV1Response", "XUsersRepliesV1Input", "XUsersRepliesV1Response", "XUsersMediaV1Input", "XUsersMediaV1Response", "RedditPostsBatchV1Input", "RedditPostsBatchV1Response", "RedditSubredditsProfileV1Input", "RedditSubredditsProfileV1Response", "RedditSubredditsPostsV1Input", "RedditSubredditsPostsV1Response", "RedditUsersProfileV1Input", "RedditUsersProfileV1Response", "RedditSearchTrendingV1Input", "RedditSearchTrendingV1Response", "XPostsThreadContextV1Input", "XPostsThreadContextV1Response", "XArticlesDetailV1Input", "XArticlesDetailV1Response", "XUsersMentionsV1Input", "XUsersMentionsV1Response", "XUsersBatchDetailV1Input", "XUsersBatchDetailV1Response", "XUsersVerifiedFollowersV1Input", "XUsersVerifiedFollowersV1Response", "RedditUsersPostsV1Input", "RedditUsersPostsV1Response", "XiaohongshuProductsReviewsV1Input", "XiaohongshuProductsReviewsV1Response", "XiaohongshuCreatorInspirationRecommendedV1Input", "XiaohongshuCreatorInspirationRecommendedV1Response", "XiaohongshuCreatorInspirationHotV1Input", "XiaohongshuCreatorInspirationHotV1Response", "DouyinVideosBatchDetailV1Input", "DouyinVideosBatchDetailV1Response", "DouyinVideosRelatedV1Input", "DouyinVideosRelatedV1Response", "DouyinSearchGeneralV1Input", "DouyinSearchGeneralV1Response", "DouyinMusicDetailV1Input", "DouyinMusicDetailV1Response", "DouyinMusicVideosV1Input", "DouyinMusicVideosV1Response", "DouyinRankingsHighlikeV1Input", "DouyinRankingsHighlikeV1Response", "DouyinRankingsHighfanV1Input", "DouyinRankingsHighfanV1Response", "XListsTweetsV1Input", "XListsTweetsV1Response", "XUsersFollowerIdsV1Input", "XUsersFollowerIdsV1Response", "XCommunitiesMembersV1Input", "XCommunitiesMembersV1Response", "XCommunitiesDetailV1Input", "XCommunitiesDetailV1Response", "XCommunitiesTweetsV1Input", "XCommunitiesTweetsV1Response", "RedditSearchSuggestionsV1Input", "RedditSearchSuggestionsV1Response", "RedditSubredditsHighlightsV1Input", "RedditSubredditsHighlightsV1Response", "RedditSubredditsPostFlairsV1Input", "RedditSubredditsPostFlairsV1Response", "RedditUsersCommentsV1Input", "RedditUsersCommentsV1Response", "RedditUsersActiveSubredditsV1Input", "RedditUsersActiveSubredditsV1Response", "XiaohongshuUsersFavedNotesV1Input", "XiaohongshuUsersFavedNotesV1Response", "XiaohongshuImagesSearchV1Input", "XiaohongshuImagesSearchV1Response", "DouyinHashtagsDetailV1Input", "DouyinHashtagsDetailV1Response", "DouyinHashtagsVideosV1Input", "DouyinHashtagsVideosV1Response", "DouyinCreatorsSimilarV1Input", "DouyinCreatorsSimilarV1Response", "DouyinCreatorsTrendsCompareV1Input", "DouyinCreatorsTrendsCompareV1Response", "DouyinXingtuCreatorsSearchV1Input", "DouyinXingtuCreatorsSearchV1Response", "DouyinRankingsTopicsV1Input", "DouyinRankingsTopicsV1Response", "DouyinRankingsSearchesV1Input", "DouyinRankingsSearchesV1Response", "DouyinXingtuCreatorsBatchDetailV1Input", "DouyinXingtuCreatorsBatchDetailV1Response", "DouyinXingtuCreatorsAudienceV1Input", "DouyinXingtuCreatorsAudienceV1Response", "DouyinXingtuCreatorsVideosV1Input", "DouyinXingtuCreatorsVideosV1Response", "TiktokUsersProfileV1Input", "TiktokUsersProfileV1Response", "TiktokUsersVideosV1Input", "TiktokUsersVideosV1Response", "TiktokVideosDetailV1Input", "TiktokVideosDetailV1Response", "TiktokVideosCommentsV1Input", "TiktokVideosCommentsV1Response", "TiktokVideosCommentsRepliesV1Input", "TiktokVideosCommentsRepliesV1Response", "TiktokVideosSearchV1Input", "TiktokVideosSearchV1Response", "TiktokUsersSearchV1Input", "TiktokUsersSearchV1Response", "TiktokHashtagsDetailV1Input", "TiktokHashtagsDetailV1Response", "TiktokHashtagsVideosV1Input", "TiktokHashtagsVideosV1Response", "TiktokShopProductsSearchV1Input", "TiktokShopProductsSearchV1Response", "TiktokShopProductsReviewsV1Input", "TiktokShopProductsReviewsV1Response", "TiktokShopSellersProductsV1Input", "TiktokShopSellersProductsV1Response", "TiktokAdsSearchV1Input", "TiktokAdsSearchV1Response", "TiktokAdsDetailV1Input", "TiktokAdsDetailV1Response", "TiktokAdsSpotlightV1Input", "TiktokAdsSpotlightV1Response", "TiktokAdsPercentileV1Input", "TiktokAdsPercentileV1Response", "TiktokTrendsHashtagsV1Input", "TiktokTrendsHashtagsV1Response", "InstagramUsersProfileV1Input", "InstagramUsersProfileV1Response", "InstagramUsersPostsV1Input", "InstagramUsersPostsV1Response", "InstagramUsersReelsV1Input", "InstagramUsersReelsV1Response", "InstagramPostsDetailV1Input", "InstagramPostsDetailV1Response", "InstagramPostsCommentsV1Input", "InstagramPostsCommentsV1Response", "InstagramPostsCommentsRepliesV1Input", "InstagramPostsCommentsRepliesV1Response", "InstagramUsersSearchV1Input", "InstagramUsersSearchV1Response", "InstagramHashtagsPostsV1Input", "InstagramHashtagsPostsV1Response", "YoutubeVideosDetailV1Input", "YoutubeVideosDetailV1Response", "YoutubeVideosCommentsV1Input", "YoutubeVideosCommentsV1Response", "YoutubeChannelsProfileV1Input", "YoutubeChannelsProfileV1Response", "YoutubeChannelsVideosV1Input", "YoutubeChannelsVideosV1Response", "YoutubeChannelsShortsV1Input", "YoutubeChannelsShortsV1Response", "YoutubeVideosSearchV1Input", "YoutubeVideosSearchV1Response", "YoutubeChannelsSearchV1Input", "YoutubeChannelsSearchV1Response", "YoutubeVideosRelatedV1Input", "YoutubeVideosRelatedV1Response", "YoutubeVideosCaptionsV1Input", "YoutubeVideosCaptionsV1Response", "BilibiliVideosDetailV1Input", "BilibiliVideosDetailV1Response", "BilibiliVideosCommentsV1Input", "BilibiliVideosCommentsV1Response", "BilibiliVideosCommentsRepliesV1Input", "BilibiliVideosCommentsRepliesV1Response", "BilibiliUsersProfileV1Input", "BilibiliUsersProfileV1Response", "BilibiliUsersStatsV1Input", "BilibiliUsersStatsV1Response", "BilibiliUsersVideosV1Input", "BilibiliUsersVideosV1Response", "BilibiliVideosSearchV1Input", "BilibiliVideosSearchV1Response", "BilibiliVideosPopularV1Input", "BilibiliVideosPopularV1Response", "BilibiliVideosSubtitlesV1Input", "BilibiliVideosSubtitlesV1Response", "BilibiliHuahuoCreatorsSearchV1Input", "BilibiliHuahuoCreatorsSearchV1Response", "BilibiliHuahuoCreatorsDetailV1Input", "BilibiliHuahuoCreatorsDetailV1Response", "BilibiliHuahuoCreatorsFollowersTrendV1Input", "BilibiliHuahuoCreatorsFollowersTrendV1Response", "BilibiliHuahuoCreatorsVideosTrendV1Input", "BilibiliHuahuoCreatorsVideosTrendV1Response", "BilibiliHuahuoCreatorsVideosPerformanceV1Input", "BilibiliHuahuoCreatorsVideosPerformanceV1Response", "BilibiliHuahuoCreatorsSimilarV1Input", "BilibiliHuahuoCreatorsSimilarV1Response", "BilibiliHuahuoCreatorsShowcaseV1Input", "BilibiliHuahuoCreatorsShowcaseV1Response", "BilibiliHuahuoRankingsCreatorsV1Input", "BilibiliHuahuoRankingsCreatorsV1Response", "BilibiliHuahuoRankingsVideosV1Input", "BilibiliHuahuoRankingsVideosV1Response", "BilibiliHuahuoRankingsSeedingV1Input", "BilibiliHuahuoRankingsSeedingV1Response", "BilibiliHuahuoRankingsGoodsV1Input", "BilibiliHuahuoRankingsGoodsV1Response", "BilibiliHuahuoGoodsCreatorsV1Input", "BilibiliHuahuoGoodsCreatorsV1Response", "WeiboPostsDetailV1Input", "WeiboPostsDetailV1Response", "WeiboUsersProfileV1Input", "WeiboUsersProfileV1Response", "WeiboUsersPostsV1Input", "WeiboUsersPostsV1Response", "WeiboPostsCommentsV1Input", "WeiboPostsCommentsV1Response", "WeiboCommentsRepliesV1Input", "WeiboCommentsRepliesV1Response", "WeiboPostsSearchV1Input", "WeiboPostsSearchV1Response", "WeiboPostsHotV1Input", "WeiboPostsHotV1Response", "WeiboTrendsHotsearchV1Input", "WeiboTrendsHotsearchV1Response", "KuaishouVideosDetailV1Input", "KuaishouVideosDetailV1Response", "KuaishouVideosCommentsV1Input", "KuaishouVideosCommentsV1Response", "KuaishouVideosCommentsRepliesV1Input", "KuaishouVideosCommentsRepliesV1Response", "KuaishouUsersProfileV1Input", "KuaishouUsersProfileV1Response", "KuaishouUsersVideosV1Input", "KuaishouUsersVideosV1Response", "KuaishouVideosSearchV2Input", "KuaishouVideosSearchV2Response", "KuaishouUsersSearchV1Input", "KuaishouUsersSearchV1Response", "KuaishouTrendsHotV1Input", "KuaishouTrendsHotV1Response", "ZhihuTrendsHotV1Input", "ZhihuTrendsHotV1Response", "ZhihuSearchContentV1Input", "ZhihuSearchContentV1Response", "ZhihuUsersSearchV1Input", "ZhihuUsersSearchV1Response", "ZhihuQuestionsDetailV1Input", "ZhihuQuestionsDetailV1Response", "ZhihuQuestionsAnswersV1Input", "ZhihuQuestionsAnswersV1Response", "ZhihuAnswersDetailV1Input", "ZhihuAnswersDetailV1Response", "ZhihuAnswersCommentsV1Input", "ZhihuAnswersCommentsV1Response", "ZhihuCommentsRepliesV1Input", "ZhihuCommentsRepliesV1Response", "ZhihuUsersProfileV1Input", "ZhihuUsersProfileV1Response", "DouyinIndexHottopicsV1Input", "DouyinIndexHottopicsV1Response", "DouyinIndexVideosSuggestV1Input", "DouyinIndexVideosSuggestV1Response", "DouyinIndexCreatorsMetricsV1Input", "DouyinIndexCreatorsMetricsV1Response", "DouyinIndexCreatorsAudienceV1Input", "DouyinIndexCreatorsAudienceV1Response", "DouyinIndexCreatorsTopvideosV1Input", "DouyinIndexCreatorsTopvideosV1Response", "DouyinIndexKeywordsAudienceV1Input", "DouyinIndexKeywordsAudienceV1Response", "DouyinIndexKeywordsTrendsV1Input", "DouyinIndexKeywordsTrendsV1Response", "DouyinIndexKeywordsInterpretationV1Input", "DouyinIndexKeywordsInterpretationV1Response", "DouyinXingtuCreatorsDetailV1Input", "DouyinXingtuCreatorsDetailV1Response", "DouyinXingtuCreatorsPricesV1Input", "DouyinXingtuCreatorsPricesV1Response", "DouyinXingtuCreatorsContentkeywordsV1Input", "DouyinXingtuCreatorsContentkeywordsV1Response", "DouyinXingtuCreatorsSpreadV1Input", "DouyinXingtuCreatorsSpreadV1Response", "DouyinXingtuCreatorsConversionV1Input", "DouyinXingtuCreatorsConversionV1Response", "DouyinXingtuCreatorsLinkindexV1Input", "DouyinXingtuCreatorsLinkindexV1Response", "DouyinXingtuCreatorsContentmixV1Input", "DouyinXingtuCreatorsContentmixV1Response", "DouyinXingtuRankingsCatalogV1Input", "DouyinXingtuRankingsCatalogV1Response", "DouyinXingtuRankingsCreatorsV1Input", "DouyinXingtuRankingsCreatorsV1Response", "DouyinXingtuVideosStatsV1Input", "DouyinXingtuVideosStatsV1Response", "DouyinXingtuCampaignsV1Input", "DouyinXingtuCampaignsV1Response", "WechatMpAccountsProfileV1Input", "WechatMpAccountsProfileV1Response", "WechatMpAccountsArticlesV1Input", "WechatMpAccountsArticlesV1Response", "WechatMpArticlesDetailV1Input", "WechatMpArticlesDetailV1Response", "WechatMpArticlesStatsV1Input", "WechatMpArticlesStatsV1Response", "WechatChannelsUsersProfileV1Input", "WechatChannelsUsersProfileV1Response", "WechatChannelsUsersVideosV1Input", "WechatChannelsUsersVideosV1Response", "WechatChannelsVideosDetailV1Input", "WechatChannelsVideosDetailV1Response", "WechatChannelsVideosCommentsV1Input", "WechatChannelsVideosCommentsV1Response", "WechatChannelsUsersCollectionsV1Input", "WechatChannelsUsersCollectionsV1Response", "WechatChannelsCollectionsVideosV1Input", "WechatChannelsCollectionsVideosV1Response", "WechatChannelsUsersSearchV1Input", "WechatChannelsUsersSearchV1Response", "WechatSearchGeneralV1Input", "WechatSearchGeneralV1Response", "WechatSearchVideosV1Input", "WechatSearchVideosV1Response", "ToutiaoArticlesDetailV1Input", "ToutiaoArticlesDetailV1Response", "ToutiaoVideosDetailV1Input", "ToutiaoVideosDetailV1Response", "ToutiaoPostsCommentsV1Input", "ToutiaoPostsCommentsV1Response", "XiguaVideosSearchV1Input", "XiguaVideosSearchV1Response", "XiguaVideosCommentsV1Input", "XiguaVideosCommentsV1Response", "XiguaUsersProfileV1Input", "XiguaUsersProfileV1Response", "XiguaUsersVideosV1Input", "XiguaUsersVideosV1Response", "ThreadsUsersProfileV1Input", "ThreadsUsersProfileV1Response", "ThreadsUsersPostsV1Input", "ThreadsUsersPostsV1Response", "ThreadsPostsDetailV1Input", "ThreadsPostsDetailV1Response", "ThreadsPostsSearchV1Input", "ThreadsPostsSearchV1Response", "LinkedinCompaniesProfileV1Input", "LinkedinCompaniesProfileV1Response", "LinkedinCompaniesPostsV1Input", "LinkedinCompaniesPostsV1Response", "LinkedinPostsDetailV1Input", "LinkedinPostsDetailV1Response", "LinkedinPostsCommentsV1Input", "LinkedinPostsCommentsV1Response", "LinkedinJobsSearchV1Input", "LinkedinJobsSearchV1Response", "LinkedinJobsDetailV1Input", "LinkedinJobsDetailV1Response", "Lemon8UsersProfileV1Input", "Lemon8UsersProfileV1Response", "Lemon8PostsDetailV1Input", "Lemon8PostsDetailV1Response", "Lemon8PostsCommentsV1Input", "Lemon8PostsCommentsV1Response", "Lemon8TrendsHotV1Input", "Lemon8TrendsHotV1Response", "Lemon8TopicsDetailV1Input", "Lemon8TopicsDetailV1Response", "Lemon8TopicsPostsV1Input", "Lemon8TopicsPostsV1Response", "TelegramChannelsProfileV1Input", "TelegramChannelsProfileV1Response", "TelegramChannelsBatchV1Input", "TelegramChannelsBatchV1Response", "TelegramChannelsMessagesV1Input", "TelegramChannelsMessagesV1Response", "TelegramMessagesDetailV1Input", "TelegramMessagesDetailV1Response", "TelegramChannelsMessagesSearchV1Input", "TelegramChannelsMessagesSearchV1Response"]

{dataxapi-0.2.0 → dataxapi-0.3.0}/src/dataxapi/client.py

@@ -2,6 +2,7 @@ import json
 import io
 import http.client
 import math
+import random
 import re
 import socket
 import time
@@ -13,9 +14,30 @@ from urllib.parse import quote, urlsplit
 from .generated import OPERATIONS, USAGE_OPERATION, GeneratedOperationsClient, OperationId, OperationInput, OperationResponse, RedditPostsDetailV1Input, RedditPostsDetailV1Response, Usage, XiaohongshuPgyBloggersCoredataV1Input, XiaohongshuPgyBloggersCoredataV1Response, XiaohongshuPgyBloggersDatasummaryV1Input, XiaohongshuPgyBloggersDatasummaryV1Response, XiaohongshuPgyBloggersDetailV1Input, XiaohongshuPgyBloggersDetailV1Response, XiaohongshuPgyBloggersNotesV1Input, XiaohongshuPgyBloggersNotesV1Response, XiaohongshuPgyNotesDetailV1Input, XiaohongshuPgyNotesDetailV1Response, XPostsDetailV1Input, XPostsDetailV1Response, XPostsSearchV1Input, XPostsSearchV1Response
 
 
-class ExactApiError(Exception):
+DEFAULT_TIMEOUT = 60.0
+"""Seconds per network attempt; above the slowest data-source timeout (30 s)."""
+IN_PROGRESS_WAIT_LIMIT = 90.0
+"""Seconds to keep polling a `request_in_progress` call with the same key."""
+NON_RETRYABLE_CODES = frozenset({
+    "account_suspended",
+    "listing_paused",
+    "upstream_failed",
+    "upstream_schema_changed",
+    "settlement_failed",
+    "previous_execution_failed",
+    # Not returned by live calls since 2026-10-08 (empty results are a charged
+    # 200); kept so older error handling keeps working.
+    "no_results",
+    "not_found",
+    "route_not_found",
+    "method_not_allowed",
+})
+"""Codes that repeat deterministically, so an automatic retry cannot help."""
+
+
+class DataXError(Exception):
     def __init__(self, status: int, problem: dict[str, Any], idempotency_key: str | None = None, retry_after: str | None = None):
-        super().__init__(problem.get("detail", f"Exact API request failed with HTTP {status}"))
+        super().__init__(problem.get("detail", f"DataXAPI request failed with HTTP {status}"))
         self.status = status
         self.code = problem.get("code", "unknown_error")
         self.detail = problem.get("detail", str(self))
@@ -27,14 +49,14 @@ class ExactApiError(Exception):
         self.idempotency_key = idempotency_key
 
 
-class ExactApiConnectionError(Exception):
+class DataXConnectionError(Exception):
     def __init__(self, message: str, idempotency_key: str | None):
         super().__init__(message)
         self.idempotency_key = idempotency_key
 
 
-class ExactApiClient(GeneratedOperationsClient):
-    def __init__(self, base_url: str, api_key: str, *, timeout: float = 10, max_retries: int = 2):
+class DataXClient(GeneratedOperationsClient):
+    def __init__(self, base_url: str, api_key: str, *, timeout: float = DEFAULT_TIMEOUT, max_retries: int = 2):
         if not base_url or not api_key:
             raise ValueError("base_url and api_key are required")
         parsed_base_url = urlsplit(base_url)
@@ -51,7 +73,12 @@ class ExactApiClient(GeneratedOperationsClient):
         self.usage = _Usage(self)
 
     def _call_operation(self, operation_id: OperationId, input: OperationInput, *, idempotency_key: str | None = None) -> OperationResponse:
-        operation = OPERATIONS[operation_id]
+        operation = OPERATIONS.get(operation_id)
+        if operation is None:
+            raise ValueError(
+                f"unknown operation {operation_id!r}; valid ids are the keys of dataxapi.OPERATIONS "
+                "(the OpenAPI operationId, e.g. 'x_posts_search_v1'); see https://dataxapi.com/en/docs/sdks/"
+            )
         return cast(OperationResponse, self._execute(operation["method"], operation["path"], dict(input), idempotency_key))
 
     def _execute(self, method: str, path: str, body: dict[str, Any], idempotency_key: str | None = None) -> dict[str, Any]:
@@ -67,7 +94,9 @@ class ExactApiClient(GeneratedOperationsClient):
         if idempotency_key:
             headers["Idempotency-Key"] = idempotency_key
 
-        for attempt in range(self._max_retries + 1):
+        attempt = 0
+        in_progress_since: float | None = None
+        while True:
             try:
                 status, response_headers, payload = self._send(method, path, headers, data)
                 try:
@@ -76,28 +105,40 @@ class ExactApiClient(GeneratedOperationsClient):
                     decoded = None
                 if 200 <= status < 300:
                     if not isinstance(decoded, dict):
-                        raise _InvalidResponse("Exact API success response must be a JSON object")
+                        raise _InvalidResponse("DataXAPI success response must be a JSON object")
                     return cast(dict[str, Any], decoded)
                 problem: dict[str, Any] = cast(dict[str, Any], decoded) if isinstance(decoded, dict) else {
                     "code": "invalid_error_response",
-                    "detail": f"Exact API returned an invalid HTTP {status} error body.",
+                    "detail": f"DataXAPI returned an invalid HTTP {status} error body.",
                 }
-                error = ExactApiError(status, problem, idempotency_key, response_headers.get("Retry-After"))
+                error = DataXError(status, problem, idempotency_key, response_headers.get("Retry-After"))
+                delay = _retry_delay(error.retry_after, problem)
+                if status == 409 and error.code == "request_in_progress" and idempotency_key and self._max_retries > 0:
+                    # The original call is still running and may still charge; its
+                    # outcome arrives by polling with the same key, not a new call.
+                    now = time.monotonic()
+                    in_progress_since = now if in_progress_since is None else in_progress_since
+                    if delay is not None and delay <= self._timeout and now - in_progress_since + delay <= IN_PROGRESS_WAIT_LIMIT:
+                        if delay > 0:
+                            time.sleep(delay)
+                        continue
+                    raise error
                 if attempt < self._max_retries and _retryable(status, error.code):
-                    delay = _retry_delay(error.retry_after, problem)
                     if delay is not None and delay <= self._timeout:
+                        attempt += 1
                         if delay > 0:
                             time.sleep(delay)
                         continue
                 raise error
             except (OSError, TimeoutError, socket.timeout, http.client.HTTPException, _InvalidResponse) as error:
                 if attempt < self._max_retries:
+                    time.sleep(_network_backoff(attempt, self._timeout))
+                    attempt += 1
                     continue
-                raise ExactApiConnectionError(
+                raise DataXConnectionError(
                     "The request outcome is unknown. Retry the same logical operation with this idempotency key.",
                     idempotency_key,
                 ) from error
-        raise AssertionError("unreachable")
 
     def get_usage(self, request_id: str) -> Usage:
         path = USAGE_OPERATION["path"].replace("{requestId}", quote(request_id, safe=""))
@@ -158,12 +199,12 @@ class _DeadlineReader(io.RawIOBase):
 
 
 class _X:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self.posts = _XPosts(client)
 
 
 class _XPosts:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self._client = client
 
     def search(self, input: XPostsSearchV1Input, *, idempotency_key: str | None = None) -> XPostsSearchV1Response:
@@ -176,7 +217,7 @@ class _XPosts:
             page = self.search(cast(XPostsSearchV1Input, current))
             cursor = page["page"]["next_cursor"]
             if cursor and cursor in seen_cursors:
-                raise ExactApiPaginationError(cursor)
+                raise DataXPaginationError(cursor)
             if cursor:
                 seen_cursors.add(cursor)
             yield page
@@ -189,12 +230,12 @@ class _XPosts:
 
 
 class _Reddit:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self.posts = _RedditPosts(client)
 
 
 class _RedditPosts:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self._client = client
 
     def detail(self, input: RedditPostsDetailV1Input, *, idempotency_key: str | None = None) -> RedditPostsDetailV1Response:
@@ -202,18 +243,18 @@ class _RedditPosts:
 
 
 class _Xiaohongshu:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self.pgy = _XiaohongshuPgy(client)
 
 
 class _XiaohongshuPgy:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self.notes = _XiaohongshuPgyNotes(client)
         self.bloggers = _XiaohongshuPgyBloggers(client)
 
 
 class _XiaohongshuPgyNotes:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self._client = client
 
     def detail(self, input: XiaohongshuPgyNotesDetailV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyNotesDetailV1Response:
@@ -221,7 +262,7 @@ class _XiaohongshuPgyNotes:
 
 
 class _XiaohongshuPgyBloggers:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self._client = client
 
     def detail(self, input: XiaohongshuPgyBloggersDetailV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyBloggersDetailV1Response:
@@ -238,7 +279,7 @@ class _XiaohongshuPgyBloggers:
 
 
 class _Usage:
-    def __init__(self, client: ExactApiClient):
+    def __init__(self, client: DataXClient):
         self._client = client
 
     def get(self, request_id: str) -> Usage:
@@ -249,7 +290,7 @@ class _InvalidResponse(Exception):
     pass
 
 
-class ExactApiPaginationError(Exception):
+class DataXPaginationError(Exception):
     def __init__(self, cursor: str):
         super().__init__("Pagination stopped because the API returned a repeated cursor.")
         self.cursor = cursor
@@ -281,7 +322,12 @@ def _set_socket_timeout(connection: http.client.HTTPConnection, deadline: float)
 
 
 def _retryable(status: int, code: str) -> bool:
-    return status == 429 or (status >= 500 and code != "listing_paused") or (status == 409 and code == "request_in_progress")
+    return code not in NON_RETRYABLE_CODES and (status == 429 or status >= 500)
+
+
+def _network_backoff(attempt: int, timeout: float) -> float:
+    """Exponential backoff with jitter, never longer than one attempt's timeout."""
+    return min(0.25 * 2 ** attempt, 8.0, timeout) * random.uniform(0.5, 1.0)
 
 
 def _retry_delay(retry_after: str | None, problem: dict[str, Any]) -> float | None:
@@ -300,3 +346,10 @@ def _retry_delay(retry_after: str | None, problem: dict[str, Any]) -> float | No
     else:
         seconds = 0.1
     return seconds if math.isfinite(seconds) and seconds >= 0 else None
+
+
+# Deprecated aliases kept for code written against the preview names.
+ExactApiClient = DataXClient
+ExactApiError = DataXError
+ExactApiConnectionError = DataXConnectionError
+ExactApiPaginationError = DataXPaginationError