# Famous V1 API

**Canonical:** https://apis.io/apis/famous/famous-v1-api/  
**Provider:** Famous — https://apis.io/providers/famous/  
**Base URL:** https://api.teespring.com/  
**Documentation:** https://api.teespring.com/docs

Famous V1 API is one of 3 APIs that [Famous](https://apis.io/providers/famous/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include v1. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

Operations about v1s

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/users/me/saved-addresses` | — |
| GET | `/v1/users/me/saved-cards` | — |
| GET | `/v1/users/me` | — |
| GET | `/v1/search-suggestions/trending` | — |
| GET | `/v1/rush-prices/{campaign_region_name}` | — |
| GET | `/v1/recommenders/{recommender_id}/campaigns` | Paginated collection of campaigns produced by a recommender |
| GET | `/v1/categories/{slug}/campaigns` | All campaigns in a category |
| GET | `/v1/categories/{slug}` | — |
| GET | `/v1/campaigns/{slug}` | — |
| POST | `/v1/auth-tokens` | Logs in a user and returns an OAuth token |

## Machine-readable artifacts (11)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/openapi/famous-v1-api-openapi.yml
- **Documentation** — https://api.teespring.com/docs
- **APIReference** — https://api.teespring.com/docs
- **GettingStarted** — https://api.teespring.com/docs
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/authentication/famous-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/conventions/famous-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/errors/famous-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/data-model/famous-data-model.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/rate-limits/famous-rate-limits.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/conformance/famous-conformance.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/famous/refs/heads/main/lifecycle/famous-lifecycle.yml

## Other Famous APIs (2)

- [Famous Internal API](https://apis.io/apis/famous/famous-internal-api/)
- [Famous Seller API](https://apis.io/apis/famous/famous-seller-api/)

## Tags

v1

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/famous/famous-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/famous/.