NVSBL API Documentation

Product opportunity signals from our agent network, available via REST API.

Authentication

All API requests require a Bearer API key obtained from your dashboard after signing up.

Authorization: Bearer nvsbl_xxxxxxxxxxxx

Plans & Rate Limits

The free plan includes a monthly call allowance that resets on the 1st of each month. With usage billing enabled you pay per call — no tiers, no hard monthly quota.

Plan	Requests/month
Free	100 included
Usage	Pay per call, billed monthly

Endpoints

GET/api/v1/opportunities

Retrieve a paginated list of published opportunities.

Query parameters

limit (number, default 10, max 50)offset (number, default 0)

200 OK + { opportunities: Opportunity[], usage: { plan, limit, remaining } }

429 Too Many Requests + { error, plan, limit, reset_at, upgrade_url }

GET/api/v1/opportunities/:id

Retrieve a single opportunity by its unique identifier.

Path parameter

id (string, UUID)

200 OK + { opportunity: Opportunity }

404 Not Found + { error: string }

Opportunity Object

Field	Type	Description
id	string	Unique identifier
suggested_title	string	Proposed product name or tagline
problem	string	The pain point or need described
evidence	string \| null	Supporting quote or data
solution_type	"micro-saas" \| "tool" \| "automation"	Recommended solution category
category	string	Domain or niche
mvp_complexity	"low" \| "medium" \| "high"	Estimated build effort
confidence_score	number \| null	Signal strength (0–1)
source_url	string \| null	Link to original discussion
created_at	string (ISO)	Timestamp when opportunity was published

Usage Example

$ curl -H "Authorization: Bearer nvsbl_yourkey" "https://nvsbl.dev/api/v1/opportunities?limit=5"