captapi 0.2.0__tar.gz → 0.3.0__tar.gz

{captapi-0.2.0 → captapi-0.3.0}/.gitignore

@@ -52,6 +52,7 @@ backend/_trend*
 backend/scripts/_probe*.py
 backend/scripts/_spike*.py
 **/comprehensive-live-audit*
+**/playground-defaults-*.json
 **/*-live-audit-report.json
 **/*-live-audit-live.jsonl
 scripts/.env
@@ -63,5 +64,12 @@ backend/secrets/
 
 # Cursor API-surface sync marker
 .cursor/.api-surface-dirty
-.vercel
-.env*
+
+# Credit-restore audits: customer URLs and response bodies, never committed
+**/restore-candidates*
+**/restore-list*
+**/*-restore-verdicts*
+**/*response-samples*.json
+**/*response-samples*.md
+**/*response_samples*.json
+**/*response_samples*.jsonl

{captapi-0.2.0 → captapi-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: captapi
-Version: 0.2.0
+Version: 0.3.0
 Summary: Official typed Python SDK for the Captapi social media API - 178 endpoints across 32 platforms (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Twitch, Spotify, and more).
 Project-URL: Homepage, https://captapi.com
 Project-URL: Documentation, https://captapi.com/docs

{captapi-0.2.0 → captapi-0.3.0}/README.md

@@ -1,67 +1,67 @@
-# captapi
-
-Official typed Python SDK for the [Captapi](https://captapi.com) social media API — 178 endpoints across 32 platforms (YouTube, TikTok, Instagram, Facebook, X/Twitter, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Twitch, Spotify, SoundCloud, GitHub, and more).
-
-- Sync **and** async clients (`Captapi` / `AsyncCaptapi`), built on `httpx`
-- Typed, documented method for every endpoint — great autocomplete for humans and AI coding agents
-- Errors always raise `CaptapiError` with status code and detail — no silent failures
-- One bounded retry on 502/503 (skipped when the API says the failure is persistent or already cached)
-
-## Install
-
-```bash
-pip install captapi
-```
-
-## Quick start
-
-```python
-from captapi import Captapi
-
-client = Captapi(api_key="YOUR_KEY")  # or set CAPTAPI_API_KEY
-
-transcript = client.youtube.transcript(url="https://youtube.com/watch?v=dQw4w9WgXcQ")
-print(transcript["data"])
-
-profile = client.tiktok.channel_details(url="https://tiktok.com/@nba")
-posts = client.reddit.subreddit_posts(url="https://reddit.com/r/programming", limit=25)
-ads = client.google_ad_library.company_ads(advertiser="nike.com")
-```
-
-## Async
-
-```python
-from captapi import AsyncCaptapi
-
-async with AsyncCaptapi() as client:
-    result = await client.instagram.channel_details(url="https://instagram.com/nba")
-```
-
-## Error handling
-
-Every failed request raises — nothing fails silently:
-
-```python
-from captapi import Captapi, CaptapiError
-
-try:
-    client.instagram.channel_details(url="https://instagram.com/whoever")
-except CaptapiError as err:
-    print(err.status_code, err.code, err.detail)
-```
-
-## Responses
-
-All methods return the standard Captapi envelope as a `dict`:
-
-```json
-{ "success": true, "data": { ... } }
-```
-
-## Links
-
-- [Documentation](https://captapi.com/docs)
-- [Get an API key (100 free credits)](https://captapi.com/dashboard/api-keys)
-- TypeScript SDK: [`npm install @captapi/sdk`](https://www.npmjs.com/package/@captapi/sdk)
-- MCP server for AI agents: [`@captapi/mcp`](https://www.npmjs.com/package/@captapi/mcp)
-- CLI: [`@captapi/cli`](https://www.npmjs.com/package/@captapi/cli)
+# captapi
+
+Official typed Python SDK for the [Captapi](https://captapi.com) social media API — 178 endpoints across 32 platforms (YouTube, TikTok, Instagram, Facebook, X/Twitter, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Twitch, Spotify, SoundCloud, GitHub, and more).
+
+- Sync **and** async clients (`Captapi` / `AsyncCaptapi`), built on `httpx`
+- Typed, documented method for every endpoint — great autocomplete for humans and AI coding agents
+- Errors always raise `CaptapiError` with status code and detail — no silent failures
+- One bounded retry on 502/503 (skipped when the API says the failure is persistent or already cached)
+
+## Install
+
+```bash
+pip install captapi
+```
+
+## Quick start
+
+```python
+from captapi import Captapi
+
+client = Captapi(api_key="YOUR_KEY")  # or set CAPTAPI_API_KEY
+
+transcript = client.youtube.transcript(url="https://youtube.com/watch?v=dQw4w9WgXcQ")
+print(transcript["data"])
+
+profile = client.tiktok.channel_details(url="https://tiktok.com/@nba")
+posts = client.reddit.subreddit_posts(url="https://reddit.com/r/programming", limit=25)
+ads = client.google_ad_library.company_ads(advertiser="nike.com")
+```
+
+## Async
+
+```python
+from captapi import AsyncCaptapi
+
+async with AsyncCaptapi() as client:
+    result = await client.instagram.channel_details(url="https://instagram.com/nba")
+```
+
+## Error handling
+
+Every failed request raises — nothing fails silently:
+
+```python
+from captapi import Captapi, CaptapiError
+
+try:
+    client.instagram.channel_details(url="https://instagram.com/whoever")
+except CaptapiError as err:
+    print(err.status_code, err.code, err.detail)
+```
+
+## Responses
+
+All methods return the standard Captapi envelope as a `dict`:
+
+```json
+{ "success": true, "data": { ... } }
+```
+
+## Links
+
+- [Documentation](https://captapi.com/docs)
+- [Get an API key (100 free credits)](https://captapi.com/dashboard/api-keys)
+- TypeScript SDK: [`npm install @captapi/sdk`](https://www.npmjs.com/package/@captapi/sdk)
+- MCP server for AI agents: [`@captapi/mcp`](https://www.npmjs.com/package/@captapi/mcp)
+- CLI: [`@captapi/cli`](https://www.npmjs.com/package/@captapi/cli)

{captapi-0.2.0 → captapi-0.3.0}/captapi/__init__.py

@@ -1,21 +1,21 @@
-"""Official Python SDK for the Captapi social media API.
-
-Usage:
-    from captapi import Captapi
-
-    client = Captapi(api_key="YOUR_KEY")  # or set CAPTAPI_API_KEY
-    result = client.youtube.transcript(url="https://youtube.com/watch?v=...")
-    print(result["data"])
-
-Async:
-    from captapi import AsyncCaptapi
-
-    async with AsyncCaptapi() as client:
-        result = await client.tiktok.profile(url="https://tiktok.com/@user")
-"""
-
-from ._generated import AsyncCaptapi, Captapi
-from ._transport import DEFAULT_BASE_URL, CaptapiError
-
-__version__ = "0.2.0"
-__all__ = ["Captapi", "AsyncCaptapi", "CaptapiError", "DEFAULT_BASE_URL", "__version__"]
+"""Official Python SDK for the Captapi social media API.
+
+Usage:
+    from captapi import Captapi
+
+    client = Captapi(api_key="YOUR_KEY")  # or set CAPTAPI_API_KEY
+    result = client.youtube.transcript(url="https://youtube.com/watch?v=...")
+    print(result["data"])
+
+Async:
+    from captapi import AsyncCaptapi
+
+    async with AsyncCaptapi() as client:
+        result = await client.tiktok.profile(url="https://tiktok.com/@user")
+"""
+
+from ._generated import AsyncCaptapi, Captapi
+from ._transport import DEFAULT_BASE_URL, CaptapiError
+
+__version__ = "0.3.0"
+__all__ = ["Captapi", "AsyncCaptapi", "CaptapiError", "DEFAULT_BASE_URL", "__version__"]