dataxapi 1.0.0__tar.gz → 1.1.1__tar.gz

{dataxapi-1.0.0/src/dataxapi.egg-info → dataxapi-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataxapi
-Version: 1.0.0
+Version: 1.1.1
 Summary: DataXAPI for Python: market data from 21 platforms (Douyin, Xiaohongshu/RedNote, TikTok, WeChat, X, YouTube...) over one interface, paid per call.
 Author-email: "DataXAPI (Aurevant LLC)" <support@dataxapi.com>
 License-Expression: MIT
@@ -22,10 +22,10 @@ Dynamic: license-file
 
 # DataXAPI for Python
 
-[DataXAPI](https://dataxapi.com) is market data infrastructure for developers and AI agents: 204 endpoints across 20
+[DataXAPI](https://dataxapi.com) is market data infrastructure for developers and AI agents: 224 endpoints across 20
 platforms (Douyin, Xiaohongshu (RedNote), TikTok, WeChat, X, YouTube and more) behind one key and one response
 shape, paid per call from $0.0003, with failed calls free and $0.10 of free credit on sign-up. Social media is the
-largest category; creator rate cards, ad libraries and shop products are the others. Figures as of version 1.0.0
+largest category; creator rate cards, ad libraries and shop products are the others. Figures as of version 1.1.0
 (October 2026); the live catalog is at [dataxapi.com/apis](https://dataxapi.com/apis/).
 
 `dataxapi` is the Python client: every endpoint is a method, generated from the catalog, with its price in its

{dataxapi-1.0.0 → dataxapi-1.1.1}/README.md

@@ -1,9 +1,9 @@
 # DataXAPI for Python
 
-[DataXAPI](https://dataxapi.com) is market data infrastructure for developers and AI agents: 204 endpoints across 20
+[DataXAPI](https://dataxapi.com) is market data infrastructure for developers and AI agents: 224 endpoints across 20
 platforms (Douyin, Xiaohongshu (RedNote), TikTok, WeChat, X, YouTube and more) behind one key and one response
 shape, paid per call from $0.0003, with failed calls free and $0.10 of free credit on sign-up. Social media is the
-largest category; creator rate cards, ad libraries and shop products are the others. Figures as of version 1.0.0
+largest category; creator rate cards, ad libraries and shop products are the others. Figures as of version 1.1.0
 (October 2026); the live catalog is at [dataxapi.com/apis](https://dataxapi.com/apis/).
 
 `dataxapi` is the Python client: every endpoint is a method, generated from the catalog, with its price in its

{dataxapi-1.0.0 → dataxapi-1.1.1}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dataxapi"
-version = "1.0.0"
+version = "1.1.1"
 description = "DataXAPI for Python: market data from 21 platforms (Douyin, Xiaohongshu/RedNote, TikTok, WeChat, X, YouTube...) over one interface, paid per call."
 readme = "README.md"
 license = "MIT"

{dataxapi-1.0.0 → dataxapi-1.1.1}/src/dataxapi/__init__.py

@@ -15,4 +15,4 @@ from ._generated import DataXAPI, ERRORS, REVISION, ROLES
 from ._runtime import CallOptions, Client, Envelope, KeyTooLongError, Meta, Page, PlatformOutcome, RunRef, UnknownRoleError
 from ._transport import APIConnectionError, DataXAPIError, FailedCall
 
-__version__ = "1.0.0"
+__version__ = "1.1.1"

{dataxapi-1.0.0 → dataxapi-1.1.1}/src/dataxapi/_generated.py

@@ -1,4 +1,4 @@
-# Generated by `npm run generate` from catalog revision c48ce454ae6c4c65, starting prices.
+# Generated by `npm run generate` from catalog revision 0320b465c3862c54, starting prices.
 # Do not edit: change the definitions and generate again.
 from __future__ import annotations
 
@@ -7,10 +7,10 @@ from typing import Any, Dict, List, Literal, Optional, Sequence, TypedDict
 from ._runtime import CallOptions, Client, Envelope
 from ._transport import DataXAPIError
 
-__all__ = ["REVISION","Approximate","PostAuthor","PostMetrics","PostMentions","Post","CommentAuthor","CommentMetrics","Comment","AccountMetrics","Account","Trend","TranscriptSegments","Transcript","CreatorRatesRates","CreatorRates","CommunityMetrics","Community","ProductMetrics","ProductShop","Product","ReviewAuthor","Review","KeywordHistoryPoints","KeywordHistory","KeywordRelated","KeywordAudienceAge","KeywordAudienceGender","KeywordAudienceProvince","KeywordAudienceCity","KeywordAudienceCityTier","KeywordAudienceInterest","KeywordAudience","AccountHistoryGained","AccountHistoryChange","AccountHistoryTotals","AccountHistory","BrandHistoryPoints","BrandHistory","BrandMetricsBenchmarks","BrandMetrics","CreatorMetrics","Creator","AudienceGender","AudienceAge","AudienceProvince","AudienceCity","AudienceInterest","AudienceDevice","AudienceCityTier","AudienceCrowd","AudiencePurchaseCategory","AudiencePurchaseAmount","Audience","XingtuCreatorMetrics","XingtuCreatorPostMetrics","XingtuCreatorPost","PgyCreatorMetrics","PgyCreatorPostMetrics","PgyCreatorPost","AdAdvertiser","Ad","Advertiser","IndexCreatorMetricsAverage7d","IndexCreatorMetricsAverage30d","IndexCreatorMetricsChange7d","IndexCreatorMetricsChange30d","IndexCreatorMetrics","XingtuCreatorKeywordsKeywords","XingtuCreatorKeywords","XingtuCreatorScoresOverall","XingtuCreatorScoresReach","XingtuCreatorScoresSeeding","XingtuCreatorScoresConversion","XingtuCreatorScoresCooperation","XingtuCreatorScoresValueForMoney","XingtuCreatorScores","XingtuCreatorContentMixCategories","XingtuCreatorContentMix","XingtuCreatorConversionCategories","XingtuCreatorConversion","XingtuCampaign","ChannelsCollectionMetrics","ChannelsCollection","TopicMetrics","Topic","DouyinCommentExt","DouyinTrendExt","DouyinAccountExt","DouyinPostExt","DouyinKeywordHistoryExt","DouyinKeywordRelatedExt","DouyinCreatorExt","KuaishouAccountExt","KuaishouCommentExt","XiaohongshuPostExt","XiaohongshuCommentExt","XiaohongshuTopicExt","XiaohongshuAccountExt","XiaohongshuReviewExt","XiaohongshuKeywordRelatedExt","XiaohongshuCreatorExt","WechatMpAccountExt","WechatMpPostExt","WechatMpCommentExt","WechatPostExt","WechatChannelsPostExt","WechatChannelsAccountExt","WechatChannelsCommentExt","BilibiliPostExt","WeiboPostExt","WeiboCommentExt","XPostExt","XCommunityExt","TelegramPostExt","YoutubeAccountExt","YoutubePostExt","YoutubeCommentExt","PinterestPostExt","FacebookAccountExt","LinkedinAccountExt","LinkedinAdExt","ThreadsPostExt","RedditPostExt","RedditCommentExt","RedditCommunityExt","RedditAccountExt","ZhihuPostExt","ZhihuAccountExt","ZhihuTrendExt","TiktokPostExt","TiktokAccountExt","TiktokReviewExt","TiktokAdExt","MetaAdExtPlatforms","MetaAdExtCards","MetaAdExt","MetaAdvertiserExt","GoogleAdExtVariations","GoogleAdExt","GoogleAdvertiserExt","InstagramPostExt","InstagramAccountExt","InvalidParamsError","RequestNotServedError","MaxPriceExceededError","CursorInvalidError","CursorMismatchError","UnauthorizedError","InsufficientBalanceError","KeyBudgetExceededError","RunBudgetExceededError","AccountSuspendedError","ForbiddenError","KeyScopeDeniedError","NotFoundError","ResultNotFoundError","RunNotFoundError","UnknownEndpointError","CallInProgressError","IdempotencyConflictError","CursorExpiredError","ResultExpiredError","RunExpiredError","RateLimitedError","CostCapExceededError","UnchargedCostLimitError","SettlementUnknownError","InternalError","UpstreamFailedError","UpstreamChangedError","UpstreamUnclearError","CursorUnavailableError","UpstreamBusyError","CapabilityPausedError","OverloadedError","CallTimeoutError","ERRORS","ROLES","DataXAPI"]
+__all__ = ["REVISION","Approximate","PostAuthor","PostMetrics","PostMentions","Post","CommentAuthor","CommentMetrics","Comment","AccountMetrics","Account","Trend","TranscriptSegments","Transcript","CreatorRatesRates","CreatorRates","CommunityMetrics","Community","ProductMetrics","ProductShop","Product","ReviewAuthor","Review","KeywordHistoryPoints","KeywordHistory","KeywordRelated","KeywordAudienceAge","KeywordAudienceGender","KeywordAudienceProvince","KeywordAudienceCity","KeywordAudienceCityTier","KeywordAudienceInterest","KeywordAudience","AccountHistoryGained","AccountHistoryChange","AccountHistoryTotals","AccountHistory","BrandHistoryPoints","BrandHistory","BrandMetricsBenchmarks","BrandMetrics","CreatorMetrics","Creator","AudienceGender","AudienceAge","AudienceProvince","AudienceCity","AudienceInterest","AudienceDevice","AudienceCityTier","AudienceCrowd","AudiencePurchaseCategory","AudiencePurchaseAmount","Audience","XingtuCreatorMetrics","XingtuCreatorPostMetrics","XingtuCreatorPost","PgyCreatorMetrics","PgyCreatorPostMetrics","PgyCreatorPost","AdAdvertiser","Ad","Advertiser","IndexCreatorMetricsAverage7d","IndexCreatorMetricsAverage30d","IndexCreatorMetricsChange7d","IndexCreatorMetricsChange30d","IndexCreatorMetrics","XingtuCreatorKeywordsKeywords","XingtuCreatorKeywords","XingtuCreatorScoresOverall","XingtuCreatorScoresReach","XingtuCreatorScoresSeeding","XingtuCreatorScoresConversion","XingtuCreatorScoresCooperation","XingtuCreatorScoresValueForMoney","XingtuCreatorScores","XingtuCreatorContentMixCategories","XingtuCreatorContentMix","XingtuCreatorConversionCategories","XingtuCreatorConversion","XingtuCampaign","ChannelsCollectionMetrics","ChannelsCollection","TopicMetrics","Topic","AccountOwner","Miniprogram","DouyinCommentExt","DouyinTrendExt","DouyinAccountExt","DouyinPostExt","DouyinKeywordHistoryExt","DouyinKeywordRelatedExt","DouyinCreatorExt","KuaishouAccountExt","KuaishouCommentExt","XiaohongshuPostExt","XiaohongshuCommentExt","XiaohongshuTopicExt","XiaohongshuAccountExt","XiaohongshuReviewExt","XiaohongshuKeywordRelatedExt","XiaohongshuCreatorExt","WechatMpAccountExt","WechatMpPostExt","WechatMpCommentExt","WechatPostExt","WechatChannelsPostExt","WechatChannelsAccountExt","WechatChannelsCommentExt","BilibiliPostExt","WeiboPostExt","WeiboCommentExt","XPostExt","XCommunityExt","TelegramPostExt","YoutubeAccountExt","YoutubePostExt","YoutubeCommentExt","PinterestPostExt","FacebookAccountExt","LinkedinAccountExt","LinkedinAdExt","ThreadsPostExt","RedditPostExt","RedditCommentExt","RedditCommunityExt","RedditAccountExt","ZhihuPostExt","ZhihuAccountExt","ZhihuTrendExt","TiktokPostExt","TiktokAccountExt","TiktokReviewExt","TiktokAdExt","MetaAdExtPlatforms","MetaAdExtCards","MetaAdExt","MetaAdvertiserExt","GoogleAdExtVariations","GoogleAdExt","GoogleAdvertiserExt","InstagramPostExt","InstagramAccountExt","InvalidParamsError","RequestNotServedError","MaxPriceExceededError","CursorInvalidError","CursorMismatchError","UnauthorizedError","InsufficientBalanceError","KeyBudgetExceededError","RunBudgetExceededError","AccountSuspendedError","ForbiddenError","KeyScopeDeniedError","NotFoundError","ResultNotFoundError","RunNotFoundError","UnknownEndpointError","CallInProgressError","IdempotencyConflictError","CursorExpiredError","ResultExpiredError","RunExpiredError","RateLimitedError","CostCapExceededError","UnchargedCostLimitError","SettlementUnknownError","InternalError","UpstreamFailedError","UpstreamChangedError","UpstreamUnclearError","CursorUnavailableError","UpstreamBusyError","CapabilityPausedError","OverloadedError","CallTimeoutError","ERRORS","ROLES","DataXAPI"]
 
 # The catalog revision this file was made from.
-REVISION = "c48ce454ae6c4c65"
+REVISION = "0320b465c3862c54"
 
 
 # --- objects ---------------------------------------------------------------------------
@@ -427,8 +427,8 @@ class KeywordRelated(TypedDict, total=False):
     keyword: Optional[str]
     # The keyword it is related to: the one asked about
     related_to: Optional[str]
-    # How it is related: query (searched together with the keyword asked about), posts (appears together with it in content), prior (searched before it), after (searched after it)
-    relation: Optional[Literal["query", "posts", "prior", "after"]]
+    # How it is related: query (searched together with the keyword asked about), posts (appears together with it in content), prior (searched before it), after (searched after it), suggestion (what the platform suggests as the keyword is typed into its search box)
+    relation: Optional[Literal["query", "posts", "prior", "after", "suggestion"]]
     # Position by relevance among the keywords of the same relation, from 1
     rank: Optional[int]
     # How closely it is related to the keyword asked about, 0 to 1
@@ -1399,6 +1399,62 @@ class Topic(TypedDict, total=False):
     ext: Dict[str, Any]
 
 
+class AccountOwner(TypedDict, total=False):
+    """Account owner (preview: may change, announced beforehand)"""
+
+    # The owner's name: the full name of a company or body, or a person's name for a personal owner
+    name: Optional[str]
+    # What the owner is: company, government, media, individual, or other (another kind of organisation)
+    type: Optional[Literal["company", "government", "media", "individual", "other"]]
+    # The number the owner is registered under (unified social credit code, business licence or organisation code); null where the platform gives none
+    registration_id: Optional[str]
+    # The owner's country or region, in the platform's words (standard view)
+    country: Optional[str]
+    # The account's verification: verified (a personal verification included), unverified, or expired
+    verification: Optional[Literal["verified", "unverified", "expired"]]
+    # The kind of verification, in the platform's words (such as 企业认证, company verification); null when not verified (standard view)
+    verification_type: Optional[str]
+    # The date the verification was granted, written as midnight UTC of that date (standard view)
+    verified_at: Optional[str]
+    # ID of the account asked about: this is its owner
+    account_id: Optional[str]
+    # The date the account asked about was registered, written as midnight UTC of that date (standard view)
+    account_created_at: Optional[str]
+    # Third-party services the account asked about has authorised, in the platform's words (company names) (full view)
+    authorized_services: Optional[List[str]]
+    # Which numbers of this item are approximate or lower bounds; absent when all are exact
+    approximate: Optional[List[Approximate]]
+    # The platform's own fields (full view)
+    ext: Dict[str, Any]
+
+
+class Miniprogram(TypedDict, total=False):
+    """Mini program (preview: may change, announced beforehand)"""
+
+    # Original ID (starting with gh_)
+    id: Optional[str]
+    # AppID (starting with wx), used to open or link to the mini program; null where the platform gives none
+    app_id: Optional[str]
+    # Name
+    name: Optional[str]
+    # Description
+    description: Optional[str]
+    # Icon (standard view)
+    icon_url: Optional[str]
+    # The owner's name: the company or body that runs it
+    owner_name: Optional[str]
+    # Whether the owner is verified (standard view)
+    owner_verified: Optional[bool]
+    # How many people used it lately, as the platform shows it; one shown like 1万+ is a lower bound; null where it shows none (standard view)
+    recent_users: Optional[int]
+    # Whether it is a mini game (standard view)
+    is_game: Optional[bool]
+    # Which numbers of this item are approximate or lower bounds; absent when all are exact
+    approximate: Optional[List[Approximate]]
+    # The platform's own fields (full view)
+    ext: Dict[str, Any]
+
+
 class DouyinCommentExt(TypedDict, total=False):
     """What only Douyin has on a comment"""
 
@@ -1572,6 +1628,20 @@ class WechatMpAccountExt(TypedDict, total=False):
     original_articles: Optional[int]
     # ID of the linked Channels account (full view)
     channels_id: Optional[str]
+    # The account's __biz: what follows __biz= in the links of its articles (full view)
+    biz: Optional[str]
+    # Name of the account's owner (a company or body); null for a personal account and where none is on record (full view)
+    owner_name: Optional[str]
+    # Estimated active followers: a third-party database's estimate from reads and the like, not a follower count the platform publishes (it publishes none), and possibly weeks to months old (full view)
+    estimated_followers: Optional[int]
+    # Estimated average reads of the account's lead articles: a third-party database's estimate, possibly out of date (full view)
+    estimated_headline_reads: Optional[int]
+    # Estimated average likes of the account's lead articles: a third-party database's estimate, possibly out of date (full view)
+    estimated_headline_likes: Optional[int]
+    # Estimated articles a week: as a third-party database counts them, possibly out of date (full view)
+    estimated_weekly_articles: Optional[int]
+    # When the account last published, as a third-party database has it; earlier than the truth when the database has not caught up (full view)
+    estimated_last_published_at: Optional[str]
 
 
 class WechatMpPostExt(TypedDict, total=False):
@@ -1611,6 +1681,8 @@ class WechatChannelsAccountExt(TypedDict, total=False):
 
     # IP location as the platform shows it (full view)
     ip_location: Optional[str]
+    # What the verification says, in the platform's words: the owner's name for a company or body, a role or profession for a person; null when not verified (full view)
+    verification: Optional[str]
 
 
 class WechatChannelsCommentExt(TypedDict, total=False):
@@ -2020,7 +2092,7 @@ class InstagramAccountExt(TypedDict, total=False):
 
 
 class InvalidParamsError(DataXAPIError):
-    """400, retry: after_fix. A parameter is invalid"""
+    """400, retry: after_fix, charged the endpoint's price where its data source billed the answer. A parameter is invalid"""
 
 
 class RequestNotServedError(DataXAPIError):
@@ -2068,7 +2140,7 @@ class KeyScopeDeniedError(DataXAPIError):
 
 
 class NotFoundError(DataXAPIError):
-    """404, retry: no. The object does not exist, is private or was deleted"""
+    """404, retry: no, charged the endpoint's price where its data source billed the answer. The object does not exist, is private or was deleted"""
 
 
 class ResultNotFoundError(DataXAPIError):
@@ -2204,6 +2276,7 @@ ROLES: Dict[str, Dict[str, Any]] = {
         "weibo": "weibo.comments.replies.list",
         "xiaohongshu": "xiaohongshu.comments.replies.list",
         "youtube": "youtube.comments.replies.list",
+        "wechat_channels": "wechat_channels.comments.replies.list",
         "zhihu": "zhihu.comments.replies.list"
     },
     "social.topics.posts.list": {
@@ -2340,11 +2413,14 @@ ROLES: Dict[str, Dict[str, Any]] = {
         "x": "x.users.search",
         "xiaohongshu": "xiaohongshu.users.search",
         "youtube": "youtube.channels.search",
+        "wechat_mp": "wechat_mp.accounts.search",
+        "wechat_channels": "wechat_channels.users.search",
         "zhihu": "zhihu.users.search"
     },
     "social.posts.metrics": {
         "douyin": "douyin.videos.metrics",
-        "wechat_mp": "wechat_mp.articles.metrics"
+        "wechat_mp": "wechat_mp.articles.metrics",
+        "wechat_channels": "wechat_channels.videos.metrics"
     },
     "social.posts.related": {
         "douyin": "douyin.videos.related"
@@ -2726,20 +2802,22 @@ class _DouyinUsersVideos:
     def __init__(self, client: Client) -> None:
         self._client = client
 
-    def list(self, *, id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def list(self, *, id: Optional[str] = None, url: Optional[str] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Douyin user videos. Get a page of the videos a Douyin account has posted, newest first: caption, engagement counts, time posted.
 
         GET /v1/douyin/users/videos/list; returns a page of `post`.
         Price: $0.002 per call, also when the result is empty.
         Paging: about 20 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+        Give exactly one of id, url.
         An account that does not exist cannot be told from an account without videos: both return an empty result, not a 404, and are charged as an empty result is.
 
-        id: Account ID (the sec_uid, the string that starts with MS4w). Required.
+        id: Account ID (the sec_uid, the string that starts with MS4w). With only a profile link or a share text, give it as url.
+        url: Link to the profile, pasted as it is: the https://www.douyin.com/user/… web link, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which account it leads to.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("douyin.users.videos.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+        return self._client.call("douyin.users.videos.list", {"id": id, "url": url, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
 class _DouyinUsers:
@@ -2755,8 +2833,8 @@ class _DouyinUsers:
         Paging: none: one object a call.
         Give exactly one of id, url.
 
-        id: Account ID (the sec_uid, the string that starts with MS4w).
-        url: Long web link to the profile.
+        id: Account ID (the sec_uid, the string that starts with MS4w). With only a profile link or a share text, give it as url.
+        url: Link to the profile, pasted as it is: the https://www.douyin.com/user/… web link, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which account it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -2797,20 +2875,22 @@ class _DouyinVideosComments:
     def __init__(self, client: Client) -> None:
         self._client = client
 
-    def list(self, *, id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def list(self, *, id: Optional[str] = None, url: Optional[str] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Douyin video comments. Get a page of comments on a Douyin video: text, commenter, likes, reply count, time posted.
 
         GET /v1/douyin/videos/comments/list; returns a page of `comment`.
         Price: $0.002 per call, also when the result is empty.
         Paging: about 20 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+        Give exactly one of id, url.
         A video that does not exist cannot be told from a video without comments: both return an empty result, not a 404, and are charged as an empty result is.
 
-        id: Video ID. Required.
+        id: Video ID, a string of digits. With only a link or a share text, give it as url.
+        url: Link to the video, pasted as it is: the https://www.douyin.com/video/… web link, a web link with modal_id in it, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("douyin.videos.comments.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+        return self._client.call("douyin.videos.comments.list", {"id": id, "url": url, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
 class _DouyinVideos:
@@ -2826,25 +2906,27 @@ class _DouyinVideos:
         Paging: none: one object a call.
         Give exactly one of id, url.
 
-        id: Video ID, a string of digits.
-        url: Long web link to the video.
+        id: Video ID, a string of digits. With only a link or a share text, give it as url.
+        url: Link to the video, pasted as it is: the https://www.douyin.com/video/… web link, a web link with modal_id in it, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
         return self._client.call("douyin.videos.get", {"id": id, "url": url, "view": view, "fields": fields}, options=options)
 
-    def metrics(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def metrics(self, *, id: Optional[str] = None, url: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Douyin video play count. Get a Douyin video's counts as of now, by its ID: plays and likes.
 
         GET /v1/douyin/videos/metrics; returns one `post`.
         Price: $0.002 per call, nothing when it finds nothing.
         Paging: none: one object a call.
+        Give exactly one of id, url.
 
-        id: Video ID, a string of digits. Required.
+        id: Video ID, a string of digits. With only a link or a share text, give it as url.
+        url: Link to the video, pasted as it is: the https://www.douyin.com/video/… web link, a web link with modal_id in it, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("douyin.videos.metrics", {"id": id, "view": view, "fields": fields}, options=options)
+        return self._client.call("douyin.videos.metrics", {"id": id, "url": url, "view": view, "fields": fields}, options=options)
 
     def related(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Douyin related videos. Get the batch of videos Douyin recommends beside a video, by its ID: caption, author, engagement counts. The recommendations may differ from call to call.
@@ -3100,6 +3182,62 @@ class _DouyinXingtu:
         self.campaigns = _DouyinXingtuCampaigns(client)
 
 
+class _DouyinBackupUsersVideos:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def list(self, *, id: Optional[str] = None, url: Optional[str] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """Douyin user videos (backup). The backup of Douyin user videos, to call when the original fails upstream: the same parameters and result, at a higher price.
+
+        GET /v1/douyin/backup/users/videos/list; returns a page of `post`.
+        Price: $0.03 per call, also when the result is empty.
+        Paging: about 20 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+        Give exactly one of id, url.
+        An account that does not exist cannot be told from an account without videos: both return an empty result, not a 404, and are charged as an empty result is.
+
+        id: Account ID (the sec_uid, the string that starts with MS4w). With only a profile link or a share text, give it as url.
+        url: Link to the profile, pasted as it is: the https://www.douyin.com/user/… web link, the page a share opens on a phone, the v.douyin.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which account it leads to.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("douyin.backup.users.videos.list", {"id": id, "url": url, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _DouyinBackupUsers:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.videos = _DouyinBackupUsersVideos(client)
+
+
+class _DouyinBackupVideos:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def search(self, *, query: str, sort: Optional[Literal["relevance", "latest", "popular"]] = None, published_within: Optional[Literal["day", "week", "half_year"]] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """Douyin video search (backup). The backup of Douyin video search, to call when the original fails upstream: the same parameters and result, at a higher price.
+
+        GET /v1/douyin/backup/videos/search; returns a page of `post`.
+        Price: $0.03 per call, also when the result is empty.
+        Paging: about 8 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+
+        query: Search terms. Required.
+        sort: Order: the platform's ranking, newest first, most liked first. Douyin does not serve most liked within a day; with that pair, a day's results come with each page in order of likes. Default: relevance.
+        published_within: Only videos posted within the last day, week or half year; any time when left out.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("douyin.backup.videos.search", {"query": query, "sort": sort, "published_within": published_within, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _DouyinBackup:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.users = _DouyinBackupUsers(client)
+        self.videos = _DouyinBackupVideos(client)
+
+
 class _Douyin:
     def __init__(self, client: Client) -> None:
         self._client = client
@@ -3110,6 +3248,7 @@ class _Douyin:
         self.users = _DouyinUsers(client)
         self.videos = _DouyinVideos(client)
         self.xingtu = _DouyinXingtu(client)
+        self.backup = _DouyinBackup(client)
 
 
 class _BilibiliCommentsReplies:
@@ -3228,7 +3367,7 @@ class _BilibiliVideos:
         Give exactly one of id, url.
 
         id: The video's BV number: 12 characters starting with BV1.
-        url: Link to the video page (www.bilibili.com/video/BV…); b23.tv short links are not taken.
+        url: Link to the video, pasted as it is: the www.bilibili.com/video/BV… page, the phone site's m.bilibili.com/video/BV…, or the b23.tv short link the app copies. A short link is opened once to see which video it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -3263,6 +3402,38 @@ class _BilibiliVideos:
         return self._client.call("bilibili.videos.trending", {"cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
+class _BilibiliBackupUsersVideos:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def list(self, *, id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """Bilibili user videos (backup). The backup of Bilibili user videos, to call when the original fails upstream: the same parameters and result (without the description and the comment count), at a higher price.
+
+        GET /v1/bilibili/backup/users/videos/list; returns a page of `post`.
+        Price: $0.03 per call, also when the result is empty.
+        Paging: about 30 items a page, 30 at most; next page by `cursor`, valid 3600 s.
+        A user that does not exist cannot be told from a user without videos: both return an empty result, not a 404, and are charged as an empty result is.
+
+        id: User number (mid), a string of digits. Required.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("bilibili.backup.users.videos.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _BilibiliBackupUsers:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.videos = _BilibiliBackupUsersVideos(client)
+
+
+class _BilibiliBackup:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.users = _BilibiliBackupUsers(client)
+
+
 class _Bilibili:
     def __init__(self, client: Client) -> None:
         self._client = client
@@ -3270,6 +3441,7 @@ class _Bilibili:
         self.trends = _BilibiliTrends(client)
         self.users = _BilibiliUsers(client)
         self.videos = _BilibiliVideos(client)
+        self.backup = _BilibiliBackup(client)
 
 
 class _KuaishouCommentsReplies:
@@ -3374,20 +3546,22 @@ class _KuaishouVideosComments:
     def __init__(self, client: Client) -> None:
         self._client = client
 
-    def list(self, *, id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def list(self, *, id: Optional[str] = None, url: Optional[str] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Kuaishou video comments. Get a page of top-level comments on a Kuaishou video: text, commenter, likes, time posted, IP location.
 
         GET /v1/kuaishou/videos/comments/list; returns a page of `comment`.
         Price: $0.002 per call, also when the result is empty.
         Paging: about 40 items a page, 40 at most; next page by `cursor`, valid 3600 s.
+        Give exactly one of id, url.
         A video that does not exist cannot be told from a video without comments: both return an empty result, not a 404, and are charged as an empty result is.
 
-        id: Video ID: the part of the video's web link that starts with 3x. Required.
+        id: Video ID: the part of the video's web link that starts with 3x. With only a link or a share text, give it as url.
+        url: Link to the video, pasted as it is: the https://www.kuaishou.com/short-video/… web link, the v.kuaishou.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("kuaishou.videos.comments.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+        return self._client.call("kuaishou.videos.comments.list", {"id": id, "url": url, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
 class _KuaishouVideos:
@@ -3403,8 +3577,8 @@ class _KuaishouVideos:
         Paging: none: one object a call.
         Give exactly one of id, url.
 
-        id: Video ID: the part of the video's web link that starts with 3x.
-        url: Long web link to the video.
+        id: Video ID: the part of the video's web link that starts with 3x. With only a link or a share text, give it as url.
+        url: Link to the video, pasted as it is: the https://www.kuaishou.com/short-video/… web link, the v.kuaishou.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -4817,7 +4991,7 @@ class _TiktokVideosComments:
         A video that does not exist cannot be told from a video without comments: both return an empty result, not a 404, and are charged as an empty result is.
 
         id: Video ID, a string of digits.
-        url: Web link to the video.
+        url: Link to the video, pasted as it is: the https://www.tiktok.com/@handle/video/… web link, the www.tiktok.com/t/… or vm.tiktok.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
@@ -4838,7 +5012,7 @@ class _TiktokVideosTranscript:
         Give exactly one of id, url.
 
         id: Video ID, a string of digits.
-        url: Web link to the video.
+        url: Link to the video, pasted as it is: the https://www.tiktok.com/@handle/video/… web link, the www.tiktok.com/t/… or vm.tiktok.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -4860,7 +5034,7 @@ class _TiktokVideos:
         Give exactly one of id, url.
 
         id: Video ID, a string of digits.
-        url: Web link to the video.
+        url: Link to the video, pasted as it is: the https://www.tiktok.com/@handle/video/… web link, the www.tiktok.com/t/… or vm.tiktok.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -5007,37 +5181,41 @@ class _WeiboPostsComments:
     def __init__(self, client: Client) -> None:
         self._client = client
 
-    def list(self, *, id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def list(self, *, id: Optional[str] = None, url: Optional[str] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Weibo post comments. Get a page of comments on a Weibo post by post ID: text, commenter, likes, reply count, time posted, IP location.
 
         GET /v1/weibo/posts/comments/list; returns a page of `comment`.
         Price: $0.002 per call, also when the result is empty.
         Paging: about 20 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+        Give exactly one of id, url.
 
-        id: Post ID, a string of digits. Required.
+        id: Post ID, a string of digits. With only a link or a share text, give it as url.
+        url: Link to the post, pasted as it is: the site's https://weibo.com/<user>/… (digits or letters after it), the phone site's https://m.weibo.cn/detail/… or /status/…, or a whole share text with one of these in it.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("weibo.posts.comments.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+        return self._client.call("weibo.posts.comments.list", {"id": id, "url": url, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
 class _WeiboPostsLikers:
     def __init__(self, client: Client) -> None:
         self._client = client
 
-    def list(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def list(self, *, id: Optional[str] = None, url: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Weibo post likers. Get the accounts that most recently liked a Weibo post by post ID, about 50 at a time: name, bio, avatar, verification, follower and following counts, number of posts.
 
         GET /v1/weibo/posts/likers/list; returns a page of `account`.
         Price: $0.002 per call, also when the result is empty.
         Paging: about 50 items a page, 100 at most; one page only.
+        Give exactly one of id, url.
 
-        id: Post ID, a string of digits. Required.
+        id: Post ID, a string of digits. With only a link or a share text, give it as url.
+        url: Link to the post, pasted as it is: the site's https://weibo.com/<user>/… (digits or letters after it), the phone site's https://m.weibo.cn/detail/… or /status/…, or a whole share text with one of these in it.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("weibo.posts.likers.list", {"id": id, "view": view, "fields": fields}, options=options)
+        return self._client.call("weibo.posts.likers.list", {"id": id, "url": url, "view": view, "fields": fields}, options=options)
 
 
 class _WeiboPosts:
@@ -5046,18 +5224,20 @@ class _WeiboPosts:
         self.comments = _WeiboPostsComments(client)
         self.likers = _WeiboPostsLikers(client)
 
-    def get(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+    def get(self, *, id: Optional[str] = None, url: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Weibo post detail. Get one Weibo post by ID: the whole text (of a long post too), author, likes, comments, reposts, reads, pictures, topics.
 
         GET /v1/weibo/posts/get; returns one `post`.
         Price: $0.002 per call, nothing when it finds nothing.
         Paging: none: one object a call.
+        Give exactly one of id, url.
 
-        id: Post ID, a string of digits (the id the post lists return). Required.
+        id: Post ID, a string of digits. With only a link or a share text, give it as url.
+        url: Link to the post, pasted as it is: the site's https://weibo.com/<user>/… (digits or letters after it), the phone site's https://m.weibo.cn/detail/… or /status/…, or a whole share text with one of these in it.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
-        return self._client.call("weibo.posts.get", {"id": id, "view": view, "fields": fields}, options=options)
+        return self._client.call("weibo.posts.get", {"id": id, "url": url, "view": view, "fields": fields}, options=options)
 
     def search(self, *, query: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """Weibo realtime search. Get a page of Weibo posts for search terms, newest first: text (a long post is cut short here), author and follower count, likes, comments, reposts, pictures, topics.
@@ -5164,6 +5344,30 @@ class _WeiboUsers:
         return self._client.call("weibo.users.search", {"query": query, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
+class _WeiboBackupTrends:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def list(self, *, board: Optional[Literal["hot_search"]] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """Weibo hot search board (backup). The backup of the Weibo hot search board, to call when the original fails upstream: the same parameters and result, at a higher price.
+
+        GET /v1/weibo/backup/trends/list; returns a page of `trend`.
+        Price: $0.03 per call, also when the result is empty.
+        Paging: about 50 items a page, 51 at most; one page only.
+
+        board: Which list: hot searches is the only one. Default: hot_search.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("weibo.backup.trends.list", {"board": board, "view": view, "fields": fields}, options=options)
+
+
+class _WeiboBackup:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.trends = _WeiboBackupTrends(client)
+
+
 class _Weibo:
     def __init__(self, client: Client) -> None:
         self._client = client
@@ -5171,6 +5375,7 @@ class _Weibo:
         self.posts = _WeiboPosts(client)
         self.trends = _WeiboTrends(client)
         self.users = _WeiboUsers(client)
+        self.backup = _WeiboBackup(client)
 
 
 class _XiaohongshuImages:
@@ -5813,7 +6018,7 @@ class _WechatChannelsUsersCollections:
         Price: $0.02 per call, also when the result is empty.
         Paging: about 7 items a page, 100 at most; one page only.
 
-        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one. Required.
+        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one (search with wechat_channels.videos.search to find a video of it). The sph… ID the app shows is not it. Required.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -5831,7 +6036,7 @@ class _WechatChannelsUsersVideos:
         Price: $0.02 per call, also when the result is empty.
         Paging: about 15 items a page, 30 at most; next page by `cursor`, valid 3600 s.
 
-        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one. Required.
+        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one (search with wechat_channels.videos.search to find a video of it). The sph… ID the app shows is not it. Required.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
@@ -5839,11 +6044,31 @@ class _WechatChannelsUsersVideos:
         return self._client.call("wechat_channels.users.videos.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
+class _WechatChannelsUsersLiveReplays:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def list(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels live replays. Get the replays of a WeChat Channels account's live streams by the account's ID, newest first, the first page only (up to 48 seen on one): title, time, length, cover, likes, comments, forwards, saves.
+
+        GET /v1/wechat_channels/users/live_replays/list; returns a page of `post`.
+        Price: $0.02 per call, also when the result is empty.
+        Paging: about 10 items a page, 50 at most; one page only.
+        An account that does not exist cannot be told from one with no live replays: both return an empty result, not a 404, and are charged as an empty result is.
+
+        id: The Channels account's ID, starting with v2_ and ending in @finder; not knowing it, look the name up with wechat_channels.users.search. The sph… ID the app shows is not it. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.users.live_replays.list", {"id": id, "view": view, "fields": fields}, options=options)
+
+
 class _WechatChannelsUsers:
     def __init__(self, client: Client) -> None:
         self._client = client
         self.collections = _WechatChannelsUsersCollections(client)
         self.videos = _WechatChannelsUsersVideos(client)
+        self.live_replays = _WechatChannelsUsersLiveReplays(client)
 
     def get(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """WeChat Channels account profile. Get a WeChat Channels account by its ID: name, signature, avatar, IP location, number of videos.
@@ -5852,12 +6077,25 @@ class _WechatChannelsUsers:
         Price: $0.02 per call, nothing when it finds nothing.
         Paging: none: one object a call.
 
-        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one. Required.
+        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one (search with wechat_channels.videos.search to find a video of it). The sph… ID the app shows is not it. Required.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
         return self._client.call("wechat_channels.users.get", {"id": id, "view": view, "fields": fields}, options=options)
 
+    def search(self, *, query: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels account search. Find WeChat Channels accounts by name: the name has to match exactly, and every account of that name is returned, with its ID, name, signature, avatar, whether it is verified and what the verification says. The ID can be passed to the Channels profile, video list, live replay and other endpoints.
+
+        GET /v1/wechat_channels/users/search; returns a page of `account`.
+        Price: $0.06 per call, nothing when it finds nothing.
+        Paging: about 1 items a page, 20 at most; one page only.
+
+        query: The Channels account's name, exactly. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.users.search", {"query": query, "view": view, "fields": fields}, options=options)
+
 
 class _WechatChannelsVideosComments:
     def __init__(self, client: Client) -> None:
@@ -5890,7 +6128,7 @@ class _WechatChannelsVideos:
         Price: $0.02 per call, nothing when it finds nothing.
         Paging: none: one object a call.
 
-        id: The video's ID, a string of digits: the id a video list gives. Required.
+        id: The video's ID, a string of digits: the id a video list or a search gives. Neither the letters after sph/ in a shared link nor an export/… ID is it. Required.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -5912,6 +6150,19 @@ class _WechatChannelsVideos:
         """
         return self._client.call("wechat_channels.videos.search", {"query": query, "sort": sort, "published_within": published_within, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
+    def metrics(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels video stats. Get the current counts of a WeChat Channels video by its ID: likes, comments, shares, saves, with its description and account. Cheaper than the whole video.
+
+        GET /v1/wechat_channels/videos/metrics; returns one `post`.
+        Price: $0.015 per call, nothing when it finds nothing.
+        Paging: none: one object a call.
+
+        id: The video's ID, a string of digits: the id a video list or a video gives. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.videos.metrics", {"id": id, "view": view, "fields": fields}, options=options)
+
 
 class _WechatChannelsCollectionsVideos:
     def __init__(self, client: Client) -> None:
@@ -5938,12 +6189,107 @@ class _WechatChannelsCollections:
         self.videos = _WechatChannelsCollectionsVideos(client)
 
 
+class _WechatChannelsBackupUsersVideos:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def list(self, *, id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels account videos (backup). The backup of wechat_channels.users.videos.list: the same parameters and result from another source, priced on its own.
+
+        GET /v1/wechat_channels/backup/users/videos/list; returns a page of `post`.
+        Price: $0.06 per call, also when the result is empty.
+        Paging: about 15 items a page, 30 at most; next page by `cursor`, valid 3600 s.
+
+        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one (search with wechat_channels.videos.search to find a video of it). The sph… ID the app shows is not it. Required.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.backup.users.videos.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _WechatChannelsBackupUsers:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.videos = _WechatChannelsBackupUsersVideos(client)
+
+    def get(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels account profile (backup). The backup of wechat_channels.users.get: the same parameters and result from another source, priced on its own. No number of videos.
+
+        GET /v1/wechat_channels/backup/users/get; returns one `account`.
+        Price: $0.03 per call, nothing when it finds nothing.
+        Paging: none: one object a call.
+
+        id: The Channels account's ID, starting with v2_ and ending in @finder; a video's author.id is one (search with wechat_channels.videos.search to find a video of it). The sph… ID the app shows is not it. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.backup.users.get", {"id": id, "view": view, "fields": fields}, options=options)
+
+
+class _WechatChannelsBackupVideos:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def search(self, *, query: str, sort: Optional[Literal["relevance", "latest", "popular"]] = None, published_within: Optional[Literal["day", "week", "half_year"]] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels video search (backup). The backup of wechat_channels.videos.search: the same parameters and result from another source, priced on its own. No saves.
+
+        GET /v1/wechat_channels/backup/videos/search; returns a page of `post`.
+        Price: $0.1 per call, also when the result is empty.
+        Paging: about 10 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+
+        query: Search terms. Required.
+        sort: By relevance, by time published (newest first) or by how hot. Default: relevance.
+        published_within: Only those published in the last day, week or half year.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.backup.videos.search", {"query": query, "sort": sort, "published_within": published_within, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _WechatChannelsBackup:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.users = _WechatChannelsBackupUsers(client)
+        self.videos = _WechatChannelsBackupVideos(client)
+
+
+class _WechatChannelsCommentsReplies:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def list(self, *, id: str, post_id: str, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Channels comment replies. Get a page of the replies under a comment on a WeChat Channels video, by the comment's and the video's IDs: text, replier, likes, time posted, IP location, which reply each answers. About 10 a page, with further pages.
+
+        GET /v1/wechat_channels/comments/replies/list; returns a page of `comment`.
+        Price: $0.015 per call, also when the result is empty.
+        Paging: about 10 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+        A comment that does not exist cannot be told from one with no replies: both return an empty result, not a 404, and are charged as an empty result is.
+
+        id: The comment's ID, a string of digits: the id a Channels video's comments give. Required.
+        post_id: ID of the video the comment is on, a string of digits. Required.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_channels.comments.replies.list", {"id": id, "post_id": post_id, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _WechatChannelsComments:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.replies = _WechatChannelsCommentsReplies(client)
+
+
 class _WechatChannels:
     def __init__(self, client: Client) -> None:
         self._client = client
         self.users = _WechatChannelsUsers(client)
         self.videos = _WechatChannelsVideos(client)
         self.collections = _WechatChannelsCollections(client)
+        self.backup = _WechatChannelsBackup(client)
+        self.comments = _WechatChannelsComments(client)
 
 
 class _WechatPosts:
@@ -5967,10 +6313,103 @@ class _WechatPosts:
         return self._client.call("wechat.posts.search", {"query": query, "sort": sort, "published_within": published_within, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
+class _WechatBackupPosts:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def search(self, *, query: str, sort: Optional[Literal["relevance", "latest", "popular"]] = None, published_within: Optional[Literal["day", "week", "half_year"]] = None, cursor: Optional[str] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Search articles and videos (backup). The backup of wechat.posts.search: the same parameters and result from another source, priced on its own. Videos come without saves.
+
+        GET /v1/wechat/backup/posts/search; returns a page of `post`.
+        Price: $0.1 per call, also when the result is empty.
+        Paging: about 20 items a page, 30 at most; next page by `cursor`, valid 3600 s.
+
+        query: Search terms. Required.
+        sort: By relevance, by time published (newest first) or by how hot. Default: relevance.
+        published_within: Only those published in the last day, week or half year.
+        cursor: Cursor returned by the previous page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat.backup.posts.search", {"query": query, "sort": sort, "published_within": published_within, "cursor": cursor, "view": view, "fields": fields}, options=options)
+
+
+class _WechatBackup:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.posts = _WechatBackupPosts(client)
+
+
+class _WechatIndexKeywords:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def history(self, *, keyword: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Index. Get a keyword's WeChat Index over the last 30 days, one figure a day. The WeChat Index is WeChat's score of attention across its search, articles, Moments and more, not a count of searches, and is not comparable with Douyin's or Xiaohongshu's; days are calendar days in China time (UTC+8).
+
+        GET /v1/wechat/index/keywords/history; returns a page of `keyword_history` (preview: may change).
+        Price: $0.1 per call, also when the result is empty.
+        Paging: about 1 items a page, 1 at most; one page only.
+        A keyword the WeChat Index does not cover returns an empty result, never a not-found error.
+
+        keyword: One keyword. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat.index.keywords.history", {"keyword": keyword, "view": view, "fields": fields}, options=options)
+
+
+class _WechatIndex:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+        self.keywords = _WechatIndexKeywords(client)
+
+
+class _WechatKeywords:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def related(self, *, keyword: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Search suggestions. Get the suggestions WeChat Search lists in its search box for a keyword, in the order it lists them, about 10 at a time. The words and their places only, with no index.
+
+        GET /v1/wechat/keywords/related; returns a page of `keyword_related` (preview: may change).
+        Price: $0.1 per call, also when the result is empty.
+        Paging: about 9 items a page, 20 at most; one page only.
+        A keyword WeChat Search has no suggestions for returns an empty result, never a not-found error.
+
+        keyword: One keyword. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat.keywords.related", {"keyword": keyword, "view": view, "fields": fields}, options=options)
+
+
+class _WechatMiniprograms:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def search(self, *, query: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat mini program search. Find WeChat mini programs for search terms through WeChat Search, the first page (about 25): name, description, icon, original ID and AppID, the owner's name and whether it is verified, how many used it lately as the platform shows it, and whether it is a mini game.
+
+        GET /v1/wechat/miniprograms/search; returns a page of `miniprogram` (preview: may change).
+        Price: $0.1 per call, also when the result is empty.
+        Paging: about 25 items a page, 40 at most; one page only.
+
+        query: Search terms. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat.miniprograms.search", {"query": query, "view": view, "fields": fields}, options=options)
+
+
 class _Wechat:
     def __init__(self, client: Client) -> None:
         self._client = client
         self.posts = _WechatPosts(client)
+        self.backup = _WechatBackup(client)
+        self.index = _WechatIndex(client)
+        self.keywords = _WechatKeywords(client)
+        self.miniprograms = _WechatMiniprograms(client)
 
 
 class _WechatMpAccountsArticles:
@@ -5984,7 +6423,7 @@ class _WechatMpAccountsArticles:
         Price: $0.02 per call, also when the result is empty.
         Paging: about 10 items a page, 20 at most; next page by `cursor`, valid 3600 s.
 
-        id: The account's original ID, starting with gh_. Required.
+        id: The account's original ID, starting with gh_, not the account's name; knowing only the name, search its articles with wechat.posts.search and take author.id. Required.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
@@ -5992,10 +6431,29 @@ class _WechatMpAccountsArticles:
         return self._client.call("wechat_mp.accounts.articles.list", {"id": id, "cursor": cursor, "view": view, "fields": fields}, options=options)
 
 
+class _WechatMpAccountsOwner:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def get(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Official Account owner. Get who a WeChat Official Account is registered to, by its original ID: the owner's name, type, registration number, country, verification status, kind and date, and the account's registration date and authorised third-party services.
+
+        GET /v1/wechat_mp/accounts/owner/get; returns one `account_owner` (preview: may change).
+        Price: $0.1 per call, nothing when it finds nothing.
+        Paging: none: one object a call.
+
+        id: The account's original ID, starting with gh_; not knowing it, search the name with wechat_mp.accounts.search and take id. Required.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_mp.accounts.owner.get", {"id": id, "view": view, "fields": fields}, options=options)
+
+
 class _WechatMpAccounts:
     def __init__(self, client: Client) -> None:
         self._client = client
         self.articles = _WechatMpAccountsArticles(client)
+        self.owner = _WechatMpAccountsOwner(client)
 
     def get(self, *, id: str, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
         """WeChat Official Account profile. Get a WeChat Official Account by its original ID: name, IP location, number of original articles, the linked Channels account.
@@ -6004,12 +6462,26 @@ class _WechatMpAccounts:
         Price: $0.02 per call, nothing when it finds nothing.
         Paging: none: one object a call.
 
-        id: The account's original ID, starting with gh_; an article's author.id is one. Required.
+        id: The account's original ID, starting with gh_, not the account's name; knowing only the name, search its articles with wechat.posts.search and take author.id; an article's author.id is one. Required.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
         return self._client.call("wechat_mp.accounts.get", {"id": id, "view": view, "fields": fields}, options=options)
 
+    def search(self, *, query: str, limit: Optional[int] = None, view: Optional[Literal["compact", "standard", "full"]] = None, fields: Optional[Sequence[str]] = None, options: Optional[CallOptions] = None) -> Envelope:
+        """WeChat Official Account name search. Find WeChat Official Accounts by name or keyword, closest first: original ID, WeChat ID, name, avatar, owner, and a third-party database's estimates of active followers, lead-article reads and likes, and articles a week (not official, possibly months old). Charged per account; limit sets how many (5 by default, at most 15).
+
+        GET /v1/wechat_mp/accounts/search; returns a page of `account`.
+        Price: $0.05635 per item returned, at least $0.06 and at most $0.84525 per call, nothing when it finds nothing.
+        Paging: about 5 items a page, 15 at most (set with `limit`); one page only.
+
+        query: The account's name, or a keyword. Required.
+        limit: Items per page.
+        view: How much of each item to return. Default: standard.
+        fields: Return only these fields.
+        """
+        return self._client.call("wechat_mp.accounts.search", {"query": query, "limit": limit, "view": view, "fields": fields}, options=options)
+
 
 class _WechatMpArticlesComments:
     def __init__(self, client: Client) -> None:
@@ -6020,9 +6492,9 @@ class _WechatMpArticlesComments:
 
         GET /v1/wechat_mp/articles/comments/list; returns a page of `comment`.
         Price: $0.02 per call, also when the result is empty.
-        Paging: about 20 items a page, 20 at most; next page by `cursor`, valid 3600 s.
+        Paging: about 20 items a page, 100 at most; next page by `cursor`, valid 3600 s.
 
-        url: Link to the article: the long link with __biz, mid, idx and sn, or the short /s/ link. Required.
+        url: Link to the article, pasted as it is: the long link with __biz, mid, idx and sn, the short /s/ link, or a share text with one of them in it. Required.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
@@ -6042,7 +6514,7 @@ class _WechatMpArticles:
         Price: $0.02 per call, nothing when it finds nothing.
         Paging: none: one object a call.
 
-        url: Link to the article: the long link with __biz, mid, idx and sn, or the short /s/ link. Required.
+        url: Link to the article, pasted as it is: the long link with __biz, mid, idx and sn, the short /s/ link, or a share text with one of them in it. Required.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -6072,6 +6544,7 @@ class _WechatMpCommentsReplies:
         GET /v1/wechat_mp/comments/replies/list; returns a page of `comment`.
         Price: $0.02 per call, also when the result is empty.
         Paging: about 3 items a page, 20 at most; one page only.
+        A comment that does not exist is usually a 404; it may also read like a comment without replies, an empty result rather than a 404, charged as an empty result is.
 
         id: The comment's ID, a string of digits: the id a comment list gives. Required.
         post_id: Link to the article the comment is on (a WeChat Official Account article is named only by its link): the long link with __biz, mid, idx and sn, or the short /s/ link. Required.
@@ -6108,7 +6581,7 @@ class _RedditPostsComments:
         Give exactly one of id, url.
 
         id: Post ID, with its t3_ prefix.
-        url: Web link to the post.
+        url: Link to the post, pasted as it is: the https://www.reddit.com/r/<community>/comments/… web link (phone or old site too), a redd.it short link, or the /r/<community>/s/… link the app shares. A share link is opened once to see which post it leads to.
         sort: Reddit's default order (best), newest first, or top score first. Default: best.
         cursor: Cursor returned by the previous page.
         view: How much of each item to return. Default: standard.
@@ -6130,7 +6603,7 @@ class _RedditPostsTranscript:
         Give exactly one of id, url.
 
         id: Post ID, with its t3_ prefix.
-        url: Web link to the post.
+        url: Link to the post, pasted as it is: the https://www.reddit.com/r/<community>/comments/… web link (phone or old site too), a redd.it short link, or the /r/<community>/s/… link the app shares. A share link is opened once to see which post it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """
@@ -6152,7 +6625,7 @@ class _RedditPosts:
         Give exactly one of id, url.
 
         id: Post ID, with its t3_ prefix.
-        url: Web link to the post.
+        url: Link to the post, pasted as it is: the https://www.reddit.com/r/<community>/comments/… web link (phone or old site too), a redd.it short link, or the /r/<community>/s/… link the app shares. A share link is opened once to see which post it leads to.
         view: How much of each item to return. Default: standard.
         fields: Return only these fields.
         """

{dataxapi-1.0.0 → dataxapi-1.1.1}/src/dataxapi/_transport.py

@@ -84,8 +84,17 @@ class DataXAPIError(Exception):
         self.status = status
         self.request_id: str = body["request_id"]
         # False: nothing was charged. None: not known (settlement_unknown);
-        # look the call up by `request_id` before assuming either.
+        # look the call up by `request_id` before assuming either. True:
+        # `amount` was charged (below).
         self.charged: Optional[bool] = body.get("charged")
+        # What was charged, where `charged` is True: the endpoint's price, for
+        # an object not there or input refused that its source billed.
+        self.amount: Optional[str] = body.get("amount")
+        # The endpoint's backup version, when its source failed and the backup
+        # can be called: capability, path, per, price, note, note_zh. The same
+        # parameters and fields at its own price; call it with a new
+        # idempotency key.
+        self.alternative: Optional[Dict[str, Any]] = body.get("alternative")
         self.retry: str = body["retry"]
         self.retry_after_seconds: Optional[int] = body.get("retry_after_seconds")
         self.param: Optional[str] = body.get("param")

{dataxapi-1.0.0 → dataxapi-1.1.1/src/dataxapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataxapi
-Version: 1.0.0
+Version: 1.1.1
 Summary: DataXAPI for Python: market data from 21 platforms (Douyin, Xiaohongshu/RedNote, TikTok, WeChat, X, YouTube...) over one interface, paid per call.
 Author-email: "DataXAPI (Aurevant LLC)" <support@dataxapi.com>
 License-Expression: MIT
@@ -22,10 +22,10 @@ Dynamic: license-file
 
 # DataXAPI for Python
 
-[DataXAPI](https://dataxapi.com) is market data infrastructure for developers and AI agents: 204 endpoints across 20
+[DataXAPI](https://dataxapi.com) is market data infrastructure for developers and AI agents: 224 endpoints across 20
 platforms (Douyin, Xiaohongshu (RedNote), TikTok, WeChat, X, YouTube and more) behind one key and one response
 shape, paid per call from $0.0003, with failed calls free and $0.10 of free credit on sign-up. Social media is the
-largest category; creator rate cards, ad libraries and shop products are the others. Figures as of version 1.0.0
+largest category; creator rate cards, ad libraries and shop products are the others. Figures as of version 1.1.0
 (October 2026); the live catalog is at [dataxapi.com/apis](https://dataxapi.com/apis/).
 
 `dataxapi` is the Python client: every endpoint is a method, generated from the catalog, with its price in its

{dataxapi-1.0.0 → dataxapi-1.1.1}/src/dataxapi.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE
 README.md
 pyproject.toml
+setup.cfg
 src/dataxapi/__init__.py
 src/dataxapi/_generated.py
 src/dataxapi/_runtime.py