API Documentation

Authentication

Pass your API key in the Authorization header as a Bearer token (or the x-api-key header). Keys look like ns_…. Treat them like a password — never expose them in client-side code.

Authorization: Bearer ns_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Get latest opportunities

Returns the current top opportunities ranked by signal strength.

Query parameters

• limit — optional, number of results (default 10, max 50).

Example request

curl https://nichesonar.com/api/v1/opportunities?limit=10 \
  -H "Authorization: Bearer ns_your_key_here"

Example response

{
  "object": "list",
  "count": 10,
  "latest_week": "2026-05",
  "data": [
    {
      "problem": "Teams struggle to monitor LLM costs across providers",
      "keyword": "llm-cost-monitoring",
      "mentions": 14,
      "source_diversity": 3,
      "affected_audience": "AI engineering teams",
      "sources": ["hackernews", "github"],
      "signal_strength": 412,
      "week": "2026-05",
      "last_updated": "2026-05-29T08:00:00.000Z"
    }
  ]
}

Rate limits

Premium accounts can make up to 1,000 requests per day, shared across all keys on the account. The window resets at 00:00 UTC. Every response includes the current usage in headers:

• X-RateLimit-Limit — your daily cap.
• X-RateLimit-Remaining — calls left today.

Exceeding the cap returns 429 until the window resets.

Errors

• 401 — missing, invalid, or revoked key.
• 403 — the key’s account is not on an active Premium plan (e.g. canceled, past due, or still in trial).
• 429 — daily rate limit reached; retry after the 00:00 UTC reset.