Ad · AttentionWatch
 
Learn More
GETNo authenticationRead only30 requests/minute600 requests/hour

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.

bash
curl "https://attentionwatch.com/api/v1/discovery/products?query=customer%20support"
Illustrative response
{
  "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.

GET
/api/v1/discovery/products

Search AttentionWatch’s permanent AI Product directory.

GET
/api/v1/discovery/products/{slug}

Get one published Product profile.

GET
/api/v1/discovery/products/{slug}/similar

Find related and alternative AI Products.

GET
/api/v1/discovery/products/{slug}/launches

Read a Product’s approved Launch history.

GET
/api/v1/discovery/categories

Browse the public Product taxonomy.

GET
/api/v1/discovery/launches

Discover recently approved Launches.

GET
/api/v1/discovery/trending

Read organic verified-attention Trending results.

GET
/api/v1/discovery/offers

Read currently active public Offers.

GET
/api/v1/discovery/market

Read current or historical paid Attention Market rankings.

GET
/api/v1/discovery/champions

Read finalized Daily Champions.

Pagination

  • List endpoints return opaque signed cursors.
  • Pass pagination.nextCursor unchanged as cursor on 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.
Next page
curl "https://attentionwatch.com/api/v1/discovery/products?cursor=<nextCursor>"

Rate Limits

30 requests/minute600 requests/hourPer trusted client identity

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

CodeMeaning
INVALID_REQUESTRequest parameters failed validation.
INVALID_CURSORThe signed cursor is invalid or does not match the filters.
NOT_FOUNDThe requested public resource was not found.
RATE_LIMITEDThe trusted client identity exceeded its limit.
INTERNAL_ERRORThe request could not be completed safely.
Sanitized error
{
  "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.

Public Discovery API – AttentionWatch