Metadata-Version: 2.4
Name: gocreative
Version: 0.1.0
Summary: Official Python SDK for GoCreative AI — pay-per-call APIs for AI agents (enrich, lookup, scrape, search). Bring your own API key or use the free demo tier.
Author-email: Colin Hughes <contact@gocreativeai.com>
License: MIT
Project-URL: Homepage, https://api.gocreativeai.com
Project-URL: Documentation, https://api.gocreativeai.com/llms.txt
Project-URL: Pricing, https://api.gocreativeai.com/pricing
Keywords: gocreative,ai-agents,api,scraping,enrichment,github,amazon,tiktok,instagram,x402,mcp,llm-tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Dynamic: license-file

# gocreative

Official Python SDK for the **GoCreative AI** pay-per-call API for AI agents.
~145 endpoints covering social enrichment (Instagram / TikTok / X / LinkedIn / GitHub),
data lookups (WHOIS, DNS, IP, npm, PyPI, Wikipedia, crypto), and product scrapers
(Amazon, eBay, Reddit, Product Hunt).

## Install

```bash
pip install gocreative
```

## 30-second quickstart

```python
from gocreative import Client

# With a paid API key (recommended):
gc = Client(api_key="gck_your_key_here")

# Or with no key — free demo tier, 5 calls/day per IP:
gc = Client()

print(gc.enrich.company("anthropic.com"))
print(gc.lookup.github_user("torvalds"))
print(gc.scrape.amazon("B08N5WRWNW"))
print(gc.search.tiktok_hashtag("ai"))
print(gc.lookup.wikipedia("LLM"))
```

The client reads `GOCREATIVE_API_KEY` from the environment if you don't pass one.

## Endpoint groups

| Group | Method examples |
|---|---|
| `client.enrich.*` | `company`, `instagram`, `tiktok`, `x`, `linkedin`, `github` |
| `client.lookup.*` | `github_user`, `whois`, `dns`, `npm`, `pypi`, `wikipedia`, `ip`, `crypto` |
| `client.scrape.*` | `amazon`, `ebay`, `reddit`, `producthunt` |
| `client.search.*` | `tiktok_hashtag`, `instagram_hashtag` |

For any endpoint not wrapped above:

```python
gc.get("/v1/lookup/hn/top")
```

## Get an API key

Get a paid `gck_...` key at <https://api.gocreativeai.com/pricing>.

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

## License

MIT
