gocreative-agent-api

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

Install

npm i gocreative-agent-api
# or: pnpm add gocreative-agent-api
# or: bun add gocreative-agent-api

30-second example

import { GoCreativeClient } from "gocreative-agent-api";

const client = new GoCreativeClient({
  walletPrivateKey: process.env.MY_WALLET_KEY as `0x${string}`,
});

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

console.log(ig.followers, ig.business_category);
// 104410161 "Government Agencies"

// Hashtag search — up to 30 results, $0.05
const posts = await client.search.instagramHashtag("realestate");
console.log(posts.count, "posts");

// Recent tweets — up to 30, $0.05
const tweets = await client.posts.x("nasa");
console.log(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.

Configuration

| Constructor option | Default | |---|---| | walletPrivateKey | required | | baseUrl | https://api.gocreativeai.com/v1 | | maxPaymentUsd | 1.00 (per-call safety cap) |

Endpoints

| Method | Cost | Returns | |---|---|---| | client.enrich.instagram(username) | $0.05 | ProfileResponse | | client.enrich.tiktok(username) | $0.05 | ProfileResponse | | client.enrich.x(username) | $0.05 | ProfileResponse | | client.search.instagramHashtag(tag) | $0.05 | PostsListResponse (≤30 posts) | | client.search.tiktokHashtag(tag) | $0.05 | PostsListResponse (≤30 videos) | | client.posts.x(username) | $0.05 | PostsListResponse (≤30 tweets) |

License

MIT