followersya · Developer Portal
Social-media growth services commerce API for AI agents and integrations. Catalog discovery is open; ordering flows use OAuth 2.0 client credentials.
client_id / client_secret pair.curl -s https://api.followersya.com/oauth/token \ -d grant_type=client_credentials \ -d scope='catalog:read orders:read' \ -u "$CLIENT_ID:$CLIENT_SECRET"
curl -s https://api.followersya.com/mcp \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_services","arguments":{"query":"seguidores instagram"}}}'No credentials needed to browse: the public catalog search works anonymously (below).
OAuth 2.0 client_credentials only — there is no end-user login flow for agents. Metadata:
| Scope | Allows |
|---|---|
catalog:read | Search services, read details & prices |
orders:read | Look up order status by number, fetch Bitcoin payment instructions |
orders:create-link | Generate signed checkout links that preload a customer's cart |
orders:create | Create real orders with an autonomous Bitcoin invoice (BTCPay) |
Endpoint: https://api.followersya.com/mcp — Streamable HTTP with JSON responses. Server card: /.well-known/mcp/server-card.json.
| Tool | Scope | Purpose |
|---|---|---|
search_services | catalog:read | Find services by free-text query |
get_service_details | catalog:read | Tiers, pricing, delivery estimates |
list_payment_methods | catalog:read | Accepted payment rails |
get_order_status | orders:read | Status by order number |
create_checkout_link | orders:create-link | Signed cart-preloading link for a human customer |
create_order | orders:create | Autonomous order + Bitcoin invoice |
get_payment_instructions | orders:read | On-chain address + Lightning bolt11 for an invoice |
Rate limit ≈240 tool calls/hour per client.
Public WooCommerce Store API for catalog search:
curl -s "https://followersya.com/wp-json/wc/store/v1/products?search=tiktok%20followers&per_page=10"
OpenAPI 3.1: https://followersya.com/openapi.json. Versioned alias: /wp-json/nova/v1/public-services. Returns names, permalinks and prices. Prices render in USD server-side; localized storefront pages show visitor currency.
create_checkout_link returns an HMAC-signed URL on this site (?nova_agent=…). Opening it preloads the customer's WooCommerce cart — the customer keeps a normal human checkout. Agents never handle customer passwords or pay on someone's behalf without that tool's contract.
The live API doubles as a sandbox for read-only work: credential pairs with catalog:read are issued freely and nothing can be charged with them. Write scopes (orders:create*) are reviewed before issuance. Bitcoin (on-chain + Lightning via BTCPay) is the recommended rail for autonomous payment.
Questions: info@followersya.com