Getting Started
Project tour, glossary, and first-bid walkthrough. Start here.
nowyourlink Docs
Build-in-the-open architecture for the daily homepage-link auction.
Public REST API
Section titled “Public REST API”Base URL: https://nowyourlink.com. The read endpoints listed below are free and require no account, API key, or bearer token. Responses are JSON.
| Operation | Live endpoint | Result |
|---|---|---|
| Current Spotlight | GET /api/v1/spotlight | Current settled Spotlight |
| Archive | GET /api/v1/spotlights?limit=1 | Paginated settled days |
| Synthetic example | GET /api/v1/sandbox | Example without a purchase |
curl --fail https://nowyourlink.com/api/v1/spotlightcurl --fail 'https://nowyourlink.com/api/v1/spotlights?limit=1'OpenAPI specification · Full API reference · Plain Markdown reference · Prices and limits
The shared public budget allows a burst of 120 requests and refills at two per
second. Exhaustion returns 429 with Retry-After. Metrics cost EUR 1 per
purchase; advertiser operations require an OAuth grant. These are separate from
the free read endpoints and are marked in OpenAPI.
MCP servers and their matching cards
Section titled “MCP servers and their matching cards”| Server | Purpose | Tools | Server card |
|---|---|---|---|
| https://nowyourlink.com/mcp | Public Spotlight and synthetic sandbox | 5 | Product card |
| https://docs.nowyourlink.com/mcp | Read and search documentation | 2 | Documentation card |
| https://api.nowyourlink.com/mcp | Advertiser operations with OAuth | Scoped | Advertiser card |
Send JSON-RPC initialize, then tools/list, to the selected server over HTTP
POST. Compare the returned tools with that server’s card: the product card does
not describe the documentation or advertiser server.
Where to go next
Section titled “Where to go next”Sub-Systems
Design specs and process diagrams for sub-systems 01–13.
Operations
Runbooks, on-call, deploys, Stripe replay.
Decisions
The decision log that anchors every spec.