SOCIAL EXPERT FOR AGENT BUILDERS

TikTok research your agent can work with.

Find format ideas, inspect associated sounds and turn source-backed observations into content plans. Use your existing Social Expert account and research allowance.

Connect an agent → Inspect a dated sample

Start with trend intelligence

Call get_trending_formats for a supported audience market, then get_trend_details with a returned ID. Receive format mechanics, available timestamps, observed metrics and associated sound links. Trend details use no additional research lookup.

Coverage matters: an audience-market request does not establish that every aggregate was measured in that country. Source dates may be unknown. Keep retrieval time, source observation time and editorial filming suggestions separate. No guaranteed growth, private follower analytics or bulk scraping.

Evaluate before connecting

• Published research sample: a dated editorial snapshot with real source links, not a new API lookup.
• Sample JSON Schema: the public sample format; current tool response schemas are discovered through authenticated MCP.
• Access and subscription catalog: endpoint, discovery documents, costs and plan allowances.
• Capabilities and integration instructions.

Use one research subscription

Free accounts include 10 one-time research lookups and 3 one-time video reviews. Research subscriptions include:

Balances are shared across the website and connected agents. A successful new trends list uses one lookup; trend details and available sound details add none. Identical requests can reuse results for 30 minutes. Errors and empty results use no lookup. No automatic overage purchases; stop when the account has no remaining allowance.

Start with a free account → Compare subscription plans

Owner-authorized access

Hosted MCP endpoint: https://api.socialexpert.app/functions/v1/mcp. Use Streamable HTTP and complete OAuth with the account owner. No public API key, shared provider credential or anonymous paid access is offered. A human chooses and purchases a subscription on the website; an agent uses that existing allowance after authorization. This pilot does not support autonomous checkout.

1. Connect using the integration guide and complete OAuth.
2. Check the account and research allowance before paid work.
3. Call get_trending_formats with an explicit audienceMarket.
4. Choose a returned trendId and call get_trend_details.
5. Preserve dates, sources, coverage and unavailable statuses.

Delivery and reuse

Rate limits and source availability apply. Respect retry-after instructions and stop on access errors; a successful HTTP response is not necessarily a useful result. Inspect the tool status before using it. Use retrievedAt as the lookup time and preserve nullable source timestamps. A numeric zero differs from a missing metric. There is no published uptime or freshness SLA.

This is access to research tools under our existing service terms, not a bulk dataset resale license. Sound links do not grant music rights. Customer uploads, reports and conversations are not part of this public sample. Need a different data-use agreement? Contact us.