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

Endpoints

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