dataxapi 0.1.0__tar.gz

dataxapi-0.1.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: dataxapi
+Version: 0.1.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/apis/
+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（内部 Preview）
+
+该包由当前 Catalog Release／OpenAPI 生成 `TypedDict` 输入、输出、错误和样例；运行时只负责认证、超时、同一逻辑调用的幂等重试、分页和 Usage。它不包含 Provider、价格判断或接口选择逻辑。
+
+```python
+import os
+from dataxapi import ExactApiClient
+
+client = ExactApiClient(
+    os.environ["DATAXAPI_API_BASE_URL"],
+    os.environ["DATAXAPI_API_KEY"],
+)
+result = client.x.posts.search({"query": "OpenAI min_faves:100"})
+print(result["data"]["items"], result["meta"]["charged_amount"])
+```
+
+`timeout` 限制每次网络尝试的总时长，覆盖响应头和正文。SDK 只自动等待不超过该值的合法重试间隔；更长或无效的服务端间隔会直接返回原 `ExactApiError`，由调用方决定何时重试。错误保留 `retry_after_ms`／`retry_after` 和 `idempotency_key`；恢复同一次调用时必须复用该 Key。合法的正文间隔优先于 `Retry-After`，每次调用最多进行 `max_retries + 1` 次尝试。
+
+当前仍使用内部包名并带有 `Private :: Do Not Upload` 分类。正式 PyPI 发布账户与包名尚未签收；本文内部包示例不代表已经可以从公开 Registry 安装。

dataxapi-0.1.0/README.md

@@ -0,0 +1,19 @@
+# DataXAPI Python SDK（内部 Preview）
+
+该包由当前 Catalog Release／OpenAPI 生成 `TypedDict` 输入、输出、错误和样例；运行时只负责认证、超时、同一逻辑调用的幂等重试、分页和 Usage。它不包含 Provider、价格判断或接口选择逻辑。
+
+```python
+import os
+from dataxapi import ExactApiClient
+
+client = ExactApiClient(
+    os.environ["DATAXAPI_API_BASE_URL"],
+    os.environ["DATAXAPI_API_KEY"],
+)
+result = client.x.posts.search({"query": "OpenAI min_faves:100"})
+print(result["data"]["items"], result["meta"]["charged_amount"])
+```
+
+`timeout` 限制每次网络尝试的总时长，覆盖响应头和正文。SDK 只自动等待不超过该值的合法重试间隔；更长或无效的服务端间隔会直接返回原 `ExactApiError`，由调用方决定何时重试。错误保留 `retry_after_ms`／`retry_after` 和 `idempotency_key`；恢复同一次调用时必须复用该 Key。合法的正文间隔优先于 `Retry-After`，每次调用最多进行 `max_retries + 1` 次尝试。
+
+当前仍使用内部包名并带有 `Private :: Do Not Upload` 分类。正式 PyPI 发布账户与包名尚未签收；本文内部包示例不代表已经可以从公开 Registry 安装。

dataxapi-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "dataxapi"
+version = "0.1.0"
+requires-python = ">=3.11"
+description = "DataXAPI Python SDK: exact public social data endpoints with one CNY balance"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "DataXAPI (Aurevant LLC)", email = "support@dataxapi.com" }]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://dataxapi.com"
+Documentation = "https://dataxapi.com/en/apis/"
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+dataxapi = ["py.typed"]
+
+[tool.pyright]
+include = ["src"]
+extraPaths = ["src"]
+pythonVersion = "3.11"
+typeCheckingMode = "strict"

dataxapi-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dataxapi-0.1.0/src/dataxapi/__init__.py

@@ -0,0 +1,4 @@
+# Generated by scripts/generate-exact-api-sdks.mjs. Do not edit.
+from .client import 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, XiaohongshuNotesDetailV1Input, XiaohongshuNotesDetailV1Response, 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, DouyinUsersVideosV1Input, DouyinUsersVideosV1Response, DouyinUsersSearchV1Input, DouyinUsersSearchV1Response, DouyinTrendsHotsearchV1Input, DouyinTrendsHotsearchV1Response, DouyinTrendsRisingV1Input, DouyinTrendsRisingV1Response, DouyinRankingsLowfanV1Input, DouyinRankingsLowfanV1Response, DouyinRankingsHighcompletionV1Input, DouyinRankingsHighcompletionV1Response, DouyinMixesDetailV1Input, DouyinMixesDetailV1Response, DouyinMixesVideosV1Input, DouyinMixesVideosV1Response, XiaohongshuTopicsDetailV1Input, XiaohongshuTopicsDetailV1Response, XiaohongshuTopicsNotesV1Input, XiaohongshuTopicsNotesV1Response, XiaohongshuProductsSearchV1Input, XiaohongshuProductsSearchV1Response, XiaohongshuProductsDetailV1Input, XiaohongshuProductsDetailV1Response, XPostsBatchDetailV1Input, XPostsBatchDetailV1Response, 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, RedditSearchCommentsV1Input, RedditSearchCommentsV1Response, RedditSearchMediaV1Input, RedditSearchMediaV1Response, RedditSearchCommunitiesV1Input, RedditSearchCommunitiesV1Response, RedditSearchUsersV1Input, RedditSearchUsersV1Response, 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
+__all__ = ["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", "XiaohongshuNotesDetailV1Input", "XiaohongshuNotesDetailV1Response", "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", "DouyinUsersVideosV1Input", "DouyinUsersVideosV1Response", "DouyinUsersSearchV1Input", "DouyinUsersSearchV1Response", "DouyinTrendsHotsearchV1Input", "DouyinTrendsHotsearchV1Response", "DouyinTrendsRisingV1Input", "DouyinTrendsRisingV1Response", "DouyinRankingsLowfanV1Input", "DouyinRankingsLowfanV1Response", "DouyinRankingsHighcompletionV1Input", "DouyinRankingsHighcompletionV1Response", "DouyinMixesDetailV1Input", "DouyinMixesDetailV1Response", "DouyinMixesVideosV1Input", "DouyinMixesVideosV1Response", "XiaohongshuTopicsDetailV1Input", "XiaohongshuTopicsDetailV1Response", "XiaohongshuTopicsNotesV1Input", "XiaohongshuTopicsNotesV1Response", "XiaohongshuProductsSearchV1Input", "XiaohongshuProductsSearchV1Response", "XiaohongshuProductsDetailV1Input", "XiaohongshuProductsDetailV1Response", "XPostsBatchDetailV1Input", "XPostsBatchDetailV1Response", "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", "RedditSearchCommentsV1Input", "RedditSearchCommentsV1Response", "RedditSearchMediaV1Input", "RedditSearchMediaV1Response", "RedditSearchCommunitiesV1Input", "RedditSearchCommunitiesV1Response", "RedditSearchUsersV1Input", "RedditSearchUsersV1Response", "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"]

dataxapi-0.1.0/src/dataxapi/client.py

@@ -0,0 +1,302 @@
+import json
+import io
+import http.client
+import math
+import re
+import socket
+import time
+import uuid
+from collections.abc import Iterator
+from typing import Any, cast
+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):
+    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}"))
+        self.status = status
+        self.code = problem.get("code", "unknown_error")
+        self.detail = problem.get("detail", str(self))
+        self.request_id = problem.get("request_id")
+        self.charge_status = problem.get("charge_status")
+        self.charged_amount = problem.get("charged_amount")
+        self.retry_after_ms = problem.get("retry_after_ms")
+        self.retry_after = retry_after.strip(" \t") if retry_after is not None else None
+        self.idempotency_key = idempotency_key
+
+
+class ExactApiConnectionError(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):
+        if not base_url or not api_key:
+            raise ValueError("base_url and api_key are required")
+        parsed_base_url = urlsplit(base_url)
+        loopback = parsed_base_url.hostname in ("localhost", "127.0.0.1", "::1")
+        if parsed_base_url.scheme not in ("http", "https") or not parsed_base_url.hostname or (parsed_base_url.scheme == "http" and not loopback) or parsed_base_url.username or parsed_base_url.password or parsed_base_url.query or parsed_base_url.fragment:
+            raise ValueError("base_url must be an HTTP(S) URL without embedded credentials")
+        self._base_url = base_url.rstrip("/")
+        self._api_key = api_key
+        self._timeout = _validate_timeout(timeout)
+        self._max_retries = _validate_retries(max_retries)
+        self.x = _X(self)
+        self.reddit = _Reddit(self)
+        self.xiaohongshu = _Xiaohongshu(self)
+        self.usage = _Usage(self)
+
+    def _call_operation(self, operation_id: OperationId, input: OperationInput, *, idempotency_key: str | None = None) -> OperationResponse:
+        operation = OPERATIONS[operation_id]
+        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]:
+        key = idempotency_key or f"sdk_{uuid.uuid4()}"
+        return self._request(path, method=method, body=body, idempotency_key=key)
+
+    def _request(self, path: str, *, method: str, body: dict[str, Any] | None = None, idempotency_key: str | None = None) -> dict[str, Any]:
+        headers = {"Authorization": f"Bearer {self._api_key}", "Accept": "application/json"}
+        data = None
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+            data = json.dumps(body).encode()
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+
+        for attempt in range(self._max_retries + 1):
+            try:
+                status, response_headers, payload = self._send(method, path, headers, data)
+                try:
+                    decoded: object = json.loads(payload)
+                except (ValueError, RecursionError):
+                    decoded = None
+                if 200 <= status < 300:
+                    if not isinstance(decoded, dict):
+                        raise _InvalidResponse("Exact API 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.",
+                }
+                error = ExactApiError(status, problem, idempotency_key, response_headers.get("Retry-After"))
+                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:
+                        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:
+                    continue
+                raise ExactApiConnectionError(
+                    "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=""))
+        return cast(Usage, self._request(path, method=USAGE_OPERATION["method"]))
+
+    def _send(self, method: str, path: str, headers: dict[str, str], data: bytes | None) -> tuple[int, http.client.HTTPMessage, bytes]:
+        parsed = urlsplit(f"{self._base_url}{path}")
+        if parsed.scheme not in ("http", "https") or not parsed.hostname:
+            raise ValueError("base_url must use http or https")
+        deadline = time.monotonic() + self._timeout
+        connection_type = http.client.HTTPSConnection if parsed.scheme == "https" else http.client.HTTPConnection
+        connection = connection_type(parsed.hostname, parsed.port, timeout=_remaining(deadline))
+        request_path = parsed.path or "/"
+        if parsed.query:
+            request_path += f"?{parsed.query}"
+
+        class DeadlineResponse(http.client.HTTPResponse):
+            def __init__(self, sock: socket.socket, debuglevel: int = 0, method: str | None = None, url: str | None = None):
+                super().__init__(sock, debuglevel=debuglevel, method=method, url=url)
+                reader = self.fp
+                self.fp = io.BufferedReader(_DeadlineReader(reader.detach(), sock, deadline))
+
+        connection.response_class = DeadlineResponse
+        response: http.client.HTTPResponse | None = None
+        try:
+            connection.connect()
+            _set_socket_timeout(connection, deadline)
+            connection.request(method, request_path, body=data, headers=headers)
+            response = connection.getresponse()
+            payload = response.read()
+            _remaining(deadline)
+            return response.status, response.headers, payload
+        finally:
+            if response is not None:
+                response.close()
+            connection.close()
+
+
+class _DeadlineReader(io.RawIOBase):
+    def __init__(self, reader: io.RawIOBase, sock: socket.socket, deadline: float):
+        self._reader = reader
+        self._socket = sock
+        self._deadline = deadline
+
+    def readable(self) -> bool:
+        return True
+
+    def readinto(self, buffer: Any) -> int | None:
+        # HTTP status, headers and chunk framing can perform many reads internally.
+        self._socket.settimeout(_remaining(self._deadline))
+        return self._reader.readinto(buffer)
+
+    def close(self) -> None:
+        try:
+            self._reader.close()
+        finally:
+            super().close()
+
+
+class _X:
+    def __init__(self, client: ExactApiClient):
+        self.posts = _XPosts(client)
+
+
+class _XPosts:
+    def __init__(self, client: ExactApiClient):
+        self._client = client
+
+    def search(self, input: XPostsSearchV1Input, *, idempotency_key: str | None = None) -> XPostsSearchV1Response:
+        return self._client.call("x_posts_search_v1", input, idempotency_key=idempotency_key)
+
+    def search_pages(self, input: XPostsSearchV1Input) -> Iterator[XPostsSearchV1Response]:
+        current = dict(input)
+        seen_cursors: set[str] = {input["cursor"]} if "cursor" in input else set()
+        while True:
+            page = self.search(cast(XPostsSearchV1Input, current))
+            cursor = page["page"]["next_cursor"]
+            if cursor and cursor in seen_cursors:
+                raise ExactApiPaginationError(cursor)
+            if cursor:
+                seen_cursors.add(cursor)
+            yield page
+            if not cursor:
+                return
+            current = {**input, "cursor": cursor}
+
+    def detail(self, input: XPostsDetailV1Input, *, idempotency_key: str | None = None) -> XPostsDetailV1Response:
+        return self._client.call("x_posts_detail_v1", input, idempotency_key=idempotency_key)
+
+
+class _Reddit:
+    def __init__(self, client: ExactApiClient):
+        self.posts = _RedditPosts(client)
+
+
+class _RedditPosts:
+    def __init__(self, client: ExactApiClient):
+        self._client = client
+
+    def detail(self, input: RedditPostsDetailV1Input, *, idempotency_key: str | None = None) -> RedditPostsDetailV1Response:
+        return self._client.call("reddit_posts_detail_v1", input, idempotency_key=idempotency_key)
+
+
+class _Xiaohongshu:
+    def __init__(self, client: ExactApiClient):
+        self.pgy = _XiaohongshuPgy(client)
+
+
+class _XiaohongshuPgy:
+    def __init__(self, client: ExactApiClient):
+        self.notes = _XiaohongshuPgyNotes(client)
+        self.bloggers = _XiaohongshuPgyBloggers(client)
+
+
+class _XiaohongshuPgyNotes:
+    def __init__(self, client: ExactApiClient):
+        self._client = client
+
+    def detail(self, input: XiaohongshuPgyNotesDetailV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyNotesDetailV1Response:
+        return self._client.call("xiaohongshu_pgy_notes_detail_v1", input, idempotency_key=idempotency_key)
+
+
+class _XiaohongshuPgyBloggers:
+    def __init__(self, client: ExactApiClient):
+        self._client = client
+
+    def detail(self, input: XiaohongshuPgyBloggersDetailV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyBloggersDetailV1Response:
+        return self._client.call("xiaohongshu_pgy_bloggers_detail_v1", input, idempotency_key=idempotency_key)
+
+    def notes(self, input: XiaohongshuPgyBloggersNotesV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyBloggersNotesV1Response:
+        return self._client.call("xiaohongshu_pgy_bloggers_notes_v1", input, idempotency_key=idempotency_key)
+
+    def core_data(self, input: XiaohongshuPgyBloggersCoredataV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyBloggersCoredataV1Response:
+        return self._client.call("xiaohongshu_pgy_bloggers_coredata_v1", input, idempotency_key=idempotency_key)
+
+    def data_summary(self, input: XiaohongshuPgyBloggersDatasummaryV1Input, *, idempotency_key: str | None = None) -> XiaohongshuPgyBloggersDatasummaryV1Response:
+        return self._client.call("xiaohongshu_pgy_bloggers_datasummary_v1", input, idempotency_key=idempotency_key)
+
+
+class _Usage:
+    def __init__(self, client: ExactApiClient):
+        self._client = client
+
+    def get(self, request_id: str) -> Usage:
+        return self._client.get_usage(request_id)
+
+
+class _InvalidResponse(Exception):
+    pass
+
+
+class ExactApiPaginationError(Exception):
+    def __init__(self, cursor: str):
+        super().__init__("Pagination stopped because the API returned a repeated cursor.")
+        self.cursor = cursor
+
+
+def _remaining(deadline: float) -> float:
+    remaining = deadline - time.monotonic()
+    if remaining <= 0:
+        raise TimeoutError("request timeout exceeded")
+    return remaining
+
+
+def _validate_timeout(value: object) -> float:
+    if isinstance(value, bool) or not isinstance(value, (int, float)) or not math.isfinite(value) or value <= 0:
+        raise ValueError("timeout must be a finite positive number")
+    return float(value)
+
+
+def _validate_retries(value: object) -> int:
+    if isinstance(value, bool) or not isinstance(value, int) or value < 0:
+        raise ValueError("max_retries must be a non-negative integer")
+    return value
+
+
+def _set_socket_timeout(connection: http.client.HTTPConnection, deadline: float) -> None:
+    if connection.sock is None:
+        raise ConnectionError("connection socket is unavailable")
+    connection.sock.settimeout(_remaining(deadline))
+
+
+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")
+
+
+def _retry_delay(retry_after: str | None, problem: dict[str, Any]) -> float | None:
+    if "retry_after_ms" in problem:
+        retry_after_ms: object = problem["retry_after_ms"]
+        if isinstance(retry_after_ms, bool) or not isinstance(retry_after_ms, (int, float)):
+            return None
+        try:
+            seconds = retry_after_ms / 1000
+        except OverflowError:
+            return None
+    elif retry_after is not None:
+        if not re.fullmatch(r"[0-9]+(?:\.[0-9]+)?", retry_after):
+            return None
+        seconds = float(retry_after)
+    else:
+        seconds = 0.1
+    return seconds if math.isfinite(seconds) and seconds >= 0 else None