Public Discovery API V1
Anonymous JSON discovery for AttentionWatch’s permanent AI Product directory and live public signals.
Overview
The base URL is https://attentionwatch.com/api/v1/discovery. The API exposes explicit public fields for Products, Launches, categories, Offers, Trending, Attention Market rankings, and Daily Champions.
curl "https://attentionwatch.com/api/v1/discovery/products?query=customer%20support"{
"apiVersion": "v1",
"data": [
{
"name": "Example AI",
"slug": "example-ai",
"tagline": "An illustrative public Product result."
}
],
"pagination": { "nextCursor": null },
"meta": { "generatedAt": "2026-09-22T12:00:00.000Z" }
}Authentication
No API key, account, or OAuth flow is required. The API accepts public, read-only GET and HEAD requests and never exposes founder, ownership, moderation, financial-ledger, or private analytics data.
Endpoints
All routes below are relative to the Public Discovery API base URL.
/api/v1/discovery/productsSearch AttentionWatch’s permanent AI Product directory.
/api/v1/discovery/products/{slug}Get one published Product profile.
/api/v1/discovery/products/{slug}/similarFind related and alternative AI Products.
/api/v1/discovery/products/{slug}/launchesRead a Product’s approved Launch history.
/api/v1/discovery/categoriesBrowse the public Product taxonomy.
/api/v1/discovery/launchesDiscover recently approved Launches.
/api/v1/discovery/trendingRead organic verified-attention Trending results.
/api/v1/discovery/offersRead currently active public Offers.
/api/v1/discovery/marketRead current or historical paid Attention Market rankings.
/api/v1/discovery/championsRead finalized Daily Champions.
Pagination
- List endpoints return opaque signed cursors.
- Pass
pagination.nextCursorunchanged ascursoron the next request. - Cursors are filter-specific and cannot be reused across different queries.
- Clients should store and transmit cursors, never parse or construct them.
curl "https://attentionwatch.com/api/v1/discovery/products?cursor=<nextCursor>"Rate Limits
Rate-limited requests return HTTP 429 with a Retry-Afterheader. Product data is cached for five minutes, Trending for fifteen seconds, and the current Attention Market for at most five seconds.
Signals
Organic Trending
Trending uses verified organic visits over the rolling 24-hour window. It does not affect Attention Market rank.
Paid Attention Market
Attention Market is paid competitive visibility ranked through Promotion Credits. It is separate from organic Trending.
Errors
| Code | Meaning |
|---|---|
INVALID_REQUEST | Request parameters failed validation. |
INVALID_CURSOR | The signed cursor is invalid or does not match the filters. |
NOT_FOUND | The requested public resource was not found. |
RATE_LIMITED | The trusted client identity exceeded its limit. |
INTERNAL_ERROR | The request could not be completed safely. |
{
"error": {
"code": "INVALID_REQUEST",
"message": "query must be 200 characters or fewer",
"requestId": "req_example"
}
}OpenAPI
Use this guide as the human-readable API reference, or inspect the machine-readable OpenAPI 3.1 document directly.