Metadata-Version: 2.4
Name: gocreative-tiktok-search
Version: 0.1.0
Summary: Narrow-focus TikTok hashtag search via the GoCreative AI API.
Author-email: Colin Hughes <contact@gocreativeai.com>
License: MIT
Project-URL: Homepage, https://api.gocreativeai.com
Project-URL: Pricing, https://api.gocreativeai.com/pricing
Keywords: tiktok,tiktok-search,hashtag,social-media,trending,gocreative,ai-agents
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Dynamic: license-file

# gocreative-tiktok-search

Tiny single-purpose Python helper that searches TikTok by hashtag and returns recent videos/creators via the GoCreative AI pay-per-call API. Bring your own gck_ API key or use the free demo tier (5/day per IP). For full multi-endpoint coverage install the unified `gocreative` package.

## Install

```bash
pip install gocreative-tiktok-search
```

## 30-second quickstart

```python
from gocreative_tiktok_search import tiktok_hashtag

# Free demo tier (no key needed, 5 calls/day per IP):
print(tiktok_hashtag('ai'))

# Or with a paid API key:
print(tiktok_hashtag('ai', api_key="gck_your_key_here"))
```

You can also set `GOCREATIVE_API_KEY=gck_...` in your environment.

## Need more endpoints?

This package wraps just **one** GoCreative endpoint. For the full SDK with
enrich / lookup / scrape / search across 145+ endpoints, install:

```bash
pip install gocreative
```

Powered by **GoCreative AI** — free tier 5 calls/day, paid plans at
<https://api.gocreativeai.com/pricing>.

## License

MIT
