- Home
- API Docs
For developers
glowDOLLARS Partner API
The glowDOLLARS Partner API serves catalog data for the paysites you follow — scenes, models, and site info — so you can build promo pages, tubes, and stats tools on top of your affiliate account. This page documents the public surface; the full machine-readable spec is an OpenAPI 3.1 document.
Machine-readable spec: /openapi.json. Manage keys in the dashboard.
Authentication
Create an API key in the dashboard (Dashboard → API) once your partner application is approved — keys use the gdp_… prefix and the plaintext is shown exactly once. Send it as a bearer token. The API is server-side only: requests carrying an Origin header (browsers) are rejected.
curl https://glowdollars.com/api/v1/scenes?limit=10 \
-H "Authorization: Bearer gdp_live_YOUR_KEY"Endpoints
| Method | Path | Auth | What it does |
|---|---|---|---|
| GET | /api/health | None | Liveness check — returns { status: "ok" } |
| GET | /api/v1/scenes | API key | List published scenes for your followed sites (site/limit/offset params) |
| GET | /api/v1/scenes/{id} | API key | Scene detail — poster, trailer, gallery zip, models |
| GET | /api/v1/models/{id} | API key | Model profile with scene count |
| GET | /api/v1/sites | API key | The paysites you follow (id, name, slug, brand color) |
| GET / POST | /api/v1/keys | Session | List or create API keys (managed in the dashboard) |
| DELETE | /api/v1/keys/{id} | Session | Revoke an API key |
List responses use the envelope { "data": [...], "meta": { "limit", "has_more" } } and paginate with limit (1–100) + offset.
Rate limits
- 30 requests per minute per API key
- 2,000 requests per day per partner (raisable by arrangement)
- 120 requests per minute per IP before authentication
Exceeding a limit returns 429 with a Retry-After header (seconds). Every catalog response carries RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset (RFC 9349) so you can self-throttle in real time.
Errors
All API errors are RFC 7807 problem JSON (application/problem+json) with a stable machine-readable code and a human explanation. Unknown /api/* paths return the same shape with a 404.
{
"type": "https://glowdollars.com/api/errors/rate_limited",
"title": "Rate limit exceeded",
"status": 429,
"code": "rate_limited",
"detail": "Per-key rate limit reached. Retry after the cooldown.",
"retry_after": 30,
"scope": "key"
}For AI agents
Key program facts are published as plain text and markdown so you can read them without a browser: /llms.txt (profile + when to use), /llms-full.txt (full profile), and /commission.md (commission structure). Sending Accept: text/markdown to this documentation page, the FAQ, blog posts, help articles, legal pages, and site pages returns a markdown variant of the same content.