# Upspring Public API

Base URL: https://public-api.upspring.ai

A read-only REST API for competitive ad intelligence. Query live ads, analyze advertisers, and explore the creative landscape with coarse modelled scale grades for spend, traffic, and sales.

Authentication: Bearer token (upk_...) required for API endpoints.

Public documentation:
- GET /v1/docs/ui - visual, interactive API reference (no key required)

Authenticated documentation:
- GET /v1/docs - markdown endpoint reference (requires API key)
- GET /v1/openapi.json - OpenAPI 3.1 spec (requires API key)

Main endpoint families:
- /v1/ads - query and retrieve ads with descriptors, media, and similarity
- /v1/advertisers - list, retrieve, and compare advertisers with enrichment data
- /v1/taxonomy - verticals and categories

For full product context and integration guides:
https://www.upspring.ai/llms.txt