sync SDK to OpenAPI spec V5.3.2 (1106 endpoints)

Regenerate the SDK from the latest https://api.tikhub.io/openapi.json:
1010 -> 1106 endpoints (+121 added, -25 removed). Two new platforms:
client.douyin_index (44) and client.linkedin_web_v2 (43).

- Regenerated resources, both clients, examples, and docs/reference.md.
- Fix scripts/refresh_spec.py: send a browser User-Agent (the API now
  rejects urllib's default UA with HTTP 403).
- Make test_total_endpoint_count spec-derived instead of hardcoding 1010,
  so it no longer breaks on a spec bump.
- Update human-facing counts across READMEs, docs, examples/README, and the
  CHANGELOG Unreleased entry (released history untouched).

Verified: verify_coverage 1106/1106; an independent param check confirms all
1106 methods' parameter names and required/optional flags match the spec
exactly; 110 tests, ruff, and mypy all green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: callmeiks

CHANGELOG.md

@@ -10,7 +10,7 @@ All notable changes to `tikhub` will be documented in this file. The format is b
   for authentication, async, errors, pagination, retries, logging, CLI,
   naming rules, and a migration guide from `tikhub_sdk_v2`.
 - **Auto-generated API reference** (`docs/reference.md`, 1540 lines) listing
-  all 1010 methods with their endpoint paths and signatures.
+  all 1106 methods with their endpoint paths and signatures.
   Regenerated by `scripts/generate_docs.py`.
 - **CLI** (`pip install "tikhub[cli]"` -> `tikhub` console script):
   - `tikhub health`
@@ -36,7 +36,8 @@ All notable changes to `tikhub` will be documented in this file. The format is b
   - `refresh_spec.py` — pulls latest `openapi.json`, prints diff vs cached snapshot.
   - `generate_resources.py` — regenerates all resource modules + `client.py` + `async_client.py` from `spec/openapi.json`.
   - `verify_coverage.py` — CI gate that asserts every spec endpoint has a matching SDK method (and vice versa).
-- **All 52 resources** for TikHub OpenAPI V5.3.2 wired up — **1010 / 1010 endpoints**.
+- **All 54 resources** for TikHub OpenAPI V5.3.2 wired up — **1106 / 1106 endpoints**.
+- **Spec sync to V5.3.2 (1106 endpoints)** — added two platforms (`douyin_index`, 44 endpoints; `linkedin_web_v2`, 43 endpoints), +121 new endpoints across LinkedIn/YouTube/Reddit/WeChat/Douyin and others, −25 removed (deprecated Douyin & Xiaohongshu search/feed variants).
 - **Multipart support** in `_base_client._request` (the one Sora2 image-upload endpoint).
 - **GitHub Actions CI** (`.github/workflows/ci.yml`): lint, mypy, pytest matrix on Python 3.9–3.13, plus the coverage gate.
 - **`docs/quickstart.md`** — runnable 5-minute tour.

README.md

@@ -30,7 +30,7 @@ Built for developers, data scientists, and AI engineers who need structured soci
 
 ## Why This SDK?
 
-- **100% endpoint coverage** — 1010 / 1010 endpoints from OpenAPI spec V5.3.2, mechanically generated and verified
+- **100% endpoint coverage** — 1106 / 1106 endpoints from OpenAPI spec V5.3.2, mechanically generated and verified
 - **Sync + async** — `TikHub` and `AsyncTikHub` clients with identical APIs
 - **Production-ready** — automatic retries with exponential backoff, rate-limit handling, structured error hierarchy with full debugging context
 - **Type-safe** — `mypy --strict` clean, built on `httpx` + `pydantic v2`
@@ -43,15 +43,15 @@ Built for developers, data scientists, and AI engineers who need structured soci
 | Platform | Resource | Endpoints |
 |---|---|---|
 | TikTok | `tiktok_web`, `tiktok_app_v3`, `tiktok_creator`, `tiktok_analytics`, `tiktok_ads`, `tiktok_shop_web` | 200+ |
-| Douyin | `douyin_web`, `douyin_app_v3`, `douyin_search`, `douyin_billboard`, `douyin_creator`, `douyin_xingtu` | 400+ |
+| Douyin | `douyin_web`, `douyin_app_v3`, `douyin_search`, `douyin_billboard`, `douyin_creator`, `douyin_xingtu`, `douyin_index` | 400+ |
 | Instagram | `instagram_v1`, `instagram_v2`, `instagram_v3` | 80+ |
 | YouTube | `youtube_web`, `youtube_web_v2` | 50+ |
 | Twitter / X | `twitter_web` | 13+ |
 | Xiaohongshu (Red Note) | `xiaohongshu_web`, `xiaohongshu_app` (+ v2/v3 variants) | 80+ |
 | Bilibili | `bilibili_web`, `bilibili_app` | 40+ |
 | Weibo | `weibo_web`, `weibo_web_v2`, `weibo_app` | 30+ |
 | Threads | `threads_web` | 10+ |
-| LinkedIn | `linkedin_web` | 10+ |
+| LinkedIn | `linkedin_web`, `linkedin_web_v2` | 10+ |
 | Reddit | `reddit_app` | 10+ |
 | Kuaishou | `kuaishou_web`, `kuaishou_app` | 20+ |
 | WeChat | `wechat_channels`, `wechat_media_platform_web` | 20+ |
@@ -160,8 +160,8 @@ Parameter names match the OpenAPI spec verbatim. If you can read the TikHub API
 
 | | |
 |---|---|
-| Resources | **52** (one per OpenAPI tag) |
-| Endpoints | **1010 / 1010** |
+| Resources | **54** (one per OpenAPI tag) |
+| Endpoints | **1106 / 1106** |
 | Tests | 110 passing |
 | Type-check | mypy `--strict` clean across 71 source files |
 | Lint | ruff clean |
@@ -180,7 +180,7 @@ The resource layer is **mechanically generated** from `spec/openapi.json`. To re
 
 ```bash
 python scripts/refresh_spec.py        # pulls latest openapi.json, prints diff
-python scripts/generate_resources.py  # regenerates all 52 resource files + clients
+python scripts/generate_resources.py  # regenerates all 54 resource files + clients
 python scripts/generate_docs.py       # regenerates docs/reference.md
 python scripts/verify_coverage.py     # asserts 100% coverage
 pytest -q                             # 110 tests
@@ -204,7 +204,7 @@ Every command prints JSON to stdout — pipe to `jq` or any other formatter.
 
 ## Documentation
 
-Full docs (mkdocs-material): authentication, async, errors, pagination, retries, logging, CLI, migration guide, naming rules, and the auto-generated reference for all 1010 endpoints.
+Full docs (mkdocs-material): authentication, async, errors, pagination, retries, logging, CLI, migration guide, naming rules, and the auto-generated reference for all 1106 endpoints.
 
 ```bash
 pip install -e ".[docs]"

README_CN.md

@@ -30,7 +30,7 @@
 
 ## 为什么选择这个 SDK？
 
-- **100% 接口覆盖** — OpenAPI 规范 V5.3.2 的 1010 / 1010 个接口，机械化生成并验证
+- **100% 接口覆盖** — OpenAPI 规范 V5.3.2 的 1106 / 1106 个接口，机械化生成并验证
 - **同步 + 异步** — `TikHub` 和 `AsyncTikHub` 客户端，API 完全一致
 - **生产就绪** — 自动重试（指数退避）、速率限制处理、结构化异常体系（含完整调试上下文）
 - **类型安全** — `mypy --strict` 通过，基于 `httpx` + `pydantic v2` 构建
@@ -160,8 +160,8 @@ SDK 由 TikHub OpenAPI 规范机械化生成。两条规则：
 
 | | |
 |---|---|
-| 资源 | **52**（每个 OpenAPI 标签一个） |
-| 接口 | **1010 / 1010** |
+| 资源 | **54**（每个 OpenAPI 标签一个） |
+| 接口 | **1106 / 1106** |
 | 测试 | 110 个通过 |
 | 类型检查 | mypy `--strict` 71 个源文件全部通过 |
 | 代码检查 | ruff 通过 |
@@ -170,7 +170,7 @@ SDK 由 TikHub OpenAPI 规范机械化生成。两条规则：
 
 ```bash
 python scripts/refresh_spec.py        # 拉取最新 openapi.json，打印差异
-python scripts/generate_resources.py  # 重新生成所有 52 个资源文件 + 客户端
+python scripts/generate_resources.py  # 重新生成所有 54 个资源文件 + 客户端
 python scripts/generate_docs.py       # 重新生成 docs/reference.md
 python scripts/verify_coverage.py     # 验证 100% 覆盖
 pytest -q                             # 110 个测试
@@ -193,7 +193,7 @@ tikhub user usage                             # 今日请求量
 
 ## 文档
 
-完整文档（mkdocs-material）：身份认证、异步、异常处理、分页、重试、日志、CLI、迁移指南、命名规则，以及所有 1010 个接口的自动生成参考文档。
+完整文档（mkdocs-material）：身份认证、异步、异常处理、分页、重试、日志、CLI、迁移指南、命名规则，以及所有 1106 个接口的自动生成参考文档。
 
 ```bash
 pip install -e ".[docs]"

README_ES.md

@@ -30,7 +30,7 @@ Diseñado para desarrolladores, científicos de datos e ingenieros d
 
 ## ¿Por qué este SDK?
 
-- **Cobertura del 100%** — 1010 / 1010 endpoints de la especificación OpenAPI V5.3.2, generados y verificados mecánicamente
+- **Cobertura del 100%** — 1106 / 1106 endpoints de la especificación OpenAPI V5.3.2, generados y verificados mecánicamente
 - **Sync + async** — clientes `TikHub` y `AsyncTikHub` con APIs idénticas
 - **Listo para producción** — reintentos automáticos con backoff exponencial, manejo de límites de tasa, jerarquía de errores estructurada
 - **Type-safe** — compatible con `mypy --strict`, construido sobre `httpx` + `pydantic v2`

README_FR.md

@@ -30,7 +30,7 @@ Conçu pour les développeurs, les data scientists et les ing&eacute
 
 ## Pourquoi ce SDK ?
 
-- **Couverture à 100%** — 1010 / 1010 endpoints de la spécification OpenAPI V5.3.2, générés et vérifiés mécaniquement
+- **Couverture à 100%** — 1106 / 1106 endpoints de la spécification OpenAPI V5.3.2, générés et vérifiés mécaniquement
 - **Sync + async** — clients `TikHub` et `AsyncTikHub` avec des APIs identiques
 - **Prêt pour la production** — nouvelles tentatives automatiques avec backoff exponentiel, gestion des limites de taux, hiérarchie d'erreurs structurée
 - **Type-safe** — compatible `mypy --strict`, construit sur `httpx` + `pydantic v2`

README_JP.md

@@ -30,7 +30,7 @@
 
 ## この SDK を選ぶ理由
 
-- **100% エンドポイントカバレッジ** — OpenAPI 仕様 V5.3.2 の 1010 / 1010 エンドポイント、機械的に生成・検証
+- **100% エンドポイントカバレッジ** — OpenAPI 仕様 V5.3.2 の 1106 / 1106 エンドポイント、機械的に生成・検証
 - **同期 + 非同期** — `TikHub` と `AsyncTikHub` クライアント、API は完全に同一
 - **本番環境対応** — 指数バックオフによる自動リトライ、レート制限処理、構造化エラー階層
 - **型安全** — `mypy --strict` 対応、`httpx` + `pydantic v2` で構築

docs/index.md

@@ -14,8 +14,8 @@ with TikHub(api_key="YOUR_API_KEY") as client:
 
 ## At a glance
 
-- :material-check-circle: **100% endpoint coverage** — 1010 / 1010 endpoints from spec V5.3.2
-- :material-check-circle: **52 resources** — one per OpenAPI tag, flat namespace
+- :material-check-circle: **100% endpoint coverage** — 1106 / 1106 endpoints from spec V5.3.2
+- :material-check-circle: **54 resources** — one per OpenAPI tag, flat namespace
 - :material-check-circle: **Async-first** with a parallel sync surface
 - :material-check-circle: **Typed exceptions** with status-code mapping and request-id
 - :material-check-circle: **Built-in retries** with exponential backoff and `Retry-After` honouring
@@ -59,5 +59,5 @@ Requires Python 3.9+.
 
 - [Quickstart](quickstart.md) — 5-minute runnable tour
 - [Authentication](authentication.md)
-- [API reference](reference.md) — all 1010 endpoints
+- [API reference](reference.md) — all 1106 endpoints
 - [Migrating from V2](migrating-from-v2.md)

docs/migrating-from-v2.md

@@ -11,7 +11,7 @@ pip install tikhub_sdk_v2 tikhub      # both at once
 | | V1.x (`tikhub_sdk_v2`) | V2.1 (`tikhub`) |
 |---|---|---|
 | Package | `tikhub_sdk_v2` | `tikhub` |
-| Spec version targeted | V1.0.0 (~28 tags) | **V5.3.2 (52 tags, 1010 endpoints)** |
+| Spec version targeted | V1.0.0 (~28 tags) | **V5.3.2 (54 tags, 1106 endpoints)** |
 | Naming | `BodyFetchHotTotalHighFanListApiV1DouyinBillboardFetchHotTotalHighFanListPost` | `client.douyin_billboard.fetch_hot_total_high_fan_list(...)` |
 | Async | "library: asyncio" was set in the generator config but the emitted code is sync | Native `httpx.AsyncClient` |
 | Python | 2 / 3 (with `six`) | **3.9+** |