# ViralSpy Developer Docs

- [Build with ViralSpy](/docs): Search, classify, and analyze TikTok creative intelligence through a secure REST API and a native MCP server.
- [API quickstart](/docs/quickstart): Create a key and make your first ViralSpy API request in curl, JavaScript, Python, PHP, or Go.
- [Authentication and API keys](/docs/authentication): Safely create, scope, rotate, and revoke organisation-bound ViralSpy credentials.
- [Limits and fair use](/docs/rate-limits): Understand burst controls, organisation limits, search fair use, and analyst allowances.
- [Errors and retries](/docs/errors): Work with ViralSpy problem details, idempotency, and safe retry behavior.
- REST API
  - [REST API overview](/docs/api): The stable resource model, versioning, pagination, and analyst streaming contract.
  - Reference
    - Videos
      - [Search videos](/docs/api/reference/videos/searchVideos)
      - [Get a video](/docs/api/reference/videos/getVideo)
      - [Find videos with similar hooks](/docs/api/reference/videos/findSimilarHooks)
      - [List a ranked creative feed](/docs/api/reference/videos/listFeed)
    - Creators
      - [Search creators](/docs/api/reference/creators/searchCreators)
      - [Get a creator by immutable TikTok UID](/docs/api/reference/creators/getCreator)
      - [List a creator's videos](/docs/api/reference/creators/listCreatorVideos)
    - Advertisers
      - [Search advertisers](/docs/api/reference/advertisers/searchAdvertisers)
      - [Get a canonical advertiser](/docs/api/reference/advertisers/getAdvertiser)
      - [List an advertiser's videos](/docs/api/reference/advertisers/listAdvertiserVideos)
    - Trends
      - [List trend reports](/docs/api/reference/trends/listTrends)
      - [Get a trend report](/docs/api/reference/trends/getTrend)
    - Analyst
      - [Request an evidence-backed ViralSpy analyst answer](/docs/api/reference/analyst/createAgentAnswer)
      - [Get analyst request status or result](/docs/api/reference/analyst/getAgentAnswer)
    - Usage
      - [Get organisation usage](/docs/api/reference/usage/getUsage)
- MCP server
  - [ViralSpy MCP](/docs/mcp): Give Claude, Codex, and other MCP clients structured access to ViralSpy research tools.
  - [Connect your MCP client](/docs/mcp/installation): Copy commands for Codex and Claude Code, or configure any Streamable HTTP client.
  - [MCP tools](/docs/mcp/tools): Tool selection, identifiers, quotas, and inputs for all ViralSpy MCP operations.
  - [Resources and prompts](/docs/mcp/resources-prompts): Reference material and reusable research templates exposed by the ViralSpy MCP server.
- Guides
  - [Build a research workflow](/docs/guides/agent): Combine deterministic search with the ViralSpy analyst without wasting quota or losing provenance.
- [Security model](/docs/security): Credential isolation, least privilege, abuse protection, safe streaming, and operational requirements.