gocreative-agent-api 0.1.0

Pay-per-call social profile enrichment for AI agents. Instagram, TikTok, X. Powered by x402 + USDC on Base.

gocreative-agent-api

Pay-per-call social profile enrichment for AI agents. Instagram, TikTok, X — one Python client, one wallet, one unified schema. Powered by x402 on Base.

Install

pip install gocreative-agent-api

30-second example

import os
from gocreative_agent_api import GoCreativeClient

client = GoCreativeClient(wallet_private_key=os.environ["MY_WALLET_KEY"])

# Single profiles — $0.05 each
ig  = client.enrich.instagram("nasa")
tt  = client.enrich.tiktok("tiktok")
x   = client.enrich.x("elonmusk")

print(ig["followers"], ig["business_category"])
# 104410161 Government Agencies

# Hashtag search — up to 30 results, $0.05
posts = client.search.instagram_hashtag("realestate")
print(len(posts["posts"]), "posts")

# Recent tweets — up to 30, $0.05
tweets = client.posts.x("nasa")
print(tweets["tweets"][0]["text"])

Every call costs $0.05 USDC, pulled automatically from the wallet you pass in. The SDK handles the HTTP 402 → sign → retry dance under the hood — your code never sees it.

Why

You're building an AI agent that needs to know "is this Instagram handle a real business with engagement?" or "what's trending on TikTok for #fitness?" — the existing options are:

• Scrape it yourself: maintain proxies, handle bans, build parsers for 3 platforms.
• Sign up for 5 different SaaS APIs: 5 different auth schemes, 5 invoices.
• Use this: one wallet, one client, three platforms, sub-cent gas.

Configuration

Constructor arg	Env var	Default
wallet_private_key	GOCREATIVE_WALLET_KEY	required
base_url	–	https://api.gocreativeai.com/v1
max_payment_usd	–	1.00 (per-call safety cap)
timeout	–	60.0 seconds

Endpoints

Method	Cost	Returns
client.enrich.instagram(username)	$0.05	followers, bio, verified, business category, profile pic
client.enrich.tiktok(username)	$0.05	followers, bio, verified, post count
client.enrich.x(username)	$0.05	followers, bio, verified, post count
client.search.instagram_hashtag(tag)	$0.05	up to 30 top posts (caption, likes, comments)
client.search.tiktok_hashtag(tag)	$0.05	up to 30 top videos (plays, likes, comments)
client.posts.x(username)	$0.05	up to 30 recent tweets (text, likes, retweets, views)

Cost control

• max_payment_usd=0.10 will refuse any 402 asking more than 10¢
• Server-side responses cache for 24h, so repeat calls for the same handle return instantly (and the server still bills $0.05 — that's the deal)

License

MIT