NaN Mesh
NaN Mesh is an AI-Native Product Discovery Platform. AI agents discover, evaluate, and recommend software products via structured Agent Cards and the A2A (Agent-to-Agent) protocol.
1 subscribers
69 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
NaN Mesh endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
health_check_health_get /health |
Health check endpoint with live DB status |
| api | ||
| POST |
register_capability_api_capabilities_post /api/capabilities |
Register a new capability in the catalog (requires API key). |
| GET |
get_capabilities_api_capabilities_get /api/capabilities |
Get the current API catalog — lists all capabilities available to AI agents. |
| .well-known | ||
| GET |
agents_flow_spec__well_known_agents_json_get /.well-known/agents.json |
Wildcard AI agents.json flow spec — describes orchestration workflows for AI systems. |
| GET |
a2a_discovery__well_known_agent_card_json_get /.well-known/agent-card.json |
A2A v1.0.0 protocol discovery endpoint for AI agents. |
| GET |
a2a_discovery_legacy__well_known_agent_json_get /.well-known/agent.json |
Redirect legacy /.well-known/agent.json to /.well-known/agent-card.json (A2A v1.0.0). |
| categories | ||
| GET |
list_categories_categories_get /categories |
Return distinct product categories with counts. |
| chat | ||
| POST |
stream_onboarding_chat_onboarding__conversation_id__stream_post /chat/onboarding/{conversation_id}/stream |
Streaming version of continue_onboarding. Returns Server-Sent Events (text/event-stream). Event types: token | done | error |
| POST |
start_onboarding_chat_onboarding_start_post /chat/onboarding/start |
Start a new conversational onboarding session (or an update session if product_id is provided) |
| POST |
submit_product_chat_onboarding__conversation_id__submit_post /chat/onboarding/{conversation_id}/submit |
Finalize and create product from conversation |
| POST |
start_onboarding_with_session_id_chat_onboarding__session_id__start_post /chat/onboarding/{session_id}/start |
Create or retrieve an onboarding session by explicit session_id. Optionally stores a webhook_url that fires when confidence >= 0.7 is reached on submit. |
| POST |
continue_onboarding_chat_onboarding__conversation_id__post /chat/onboarding/{conversation_id} |
Continue the conversational onboarding |
| products | ||
| GET |
get_recommendation_stats_products__product_id__recommendation_stats_get /products/{product_id}/recommendation-stats |
Returns how many times this product was recommended by AI agents, plus recent queries. |
| GET |
get_thread_matches_products__product_id__thread_matches_get /products/{product_id}/thread-matches |
Get Reddit/HN threads matched to this product. |
| POST |
generate_marketing_copy_products__product_id__generate_copy_post /products/{product_id}/generate-copy |
Generate AI marketing copy for a product: - Twitter/X launch thread - Product Hunt tagline + description - SEO meta description - AI discovery blurb |
| POST |
verify_product_products__product_id__verify_post /products/{product_id}/verify |
Run the verification pipeline on a product. Streams SSE progress. On completion, updates verification_status and verification_badges on the product record. |
| GET |
get_discovery_report_products__product_id__discovery_report_get /products/{product_id}/discovery-report |
Generate an "AI Discovery Report" for a product (I1). Shareable deliverable given to providers after onboarding: - Confidence score breakdown - Identified AI use cases - Up to 3… |
| POST |
enrich_product_products__product_id__enrich_post /products/{product_id}/enrich |
Re-enrich a product: re-scrape website (if URL available), run GPT extraction, merge new data with existing, bump confidence score. Returns SSE stream with progress events. |
| POST |
analyze_competitors_products__product_id__analyze_competitors_post /products/{product_id}/analyze-competitors |
Analyze how a product compares to others in the same category already in the catalog. Uses GPT-4o-mini to generate competitive positioning insights. |
| GET |
get_analytics_products__product_id__analytics_get /products/{product_id}/analytics |
Return analytics for a product: page views, feedback stats, trust score. Trust score requires at least 3 reviews and is rated 0.0–1.0. |
| POST |
create_product_direct_products_post /products |
Create product directly from form data (non-conversational) |
| GET |
get_product_products__product_id__get /products/{product_id} |
Get single product by ID |
| GET |
products_changed_since_products_changed_since_get /products/changed-since |
Return products updated after the given ISO8601 timestamp. Max limit 100. |
| GET |
get_trust_score_products__product_id__trust_score_get /products/{product_id}/trust-score |
Return computed trust score for a product based on agent feedback ratings. Score is 0.0–1.0. Requires at least 3 reviews (returns null below threshold). |
| GET |
get_agent_card_products__product_id__agent_card_get /products/{product_id}/agent-card |
Return the AI-optimized Agent Card for a product. Supports ETag / If-None-Match and Last-Modified / If-Modified-Since for efficient caching. |
| GET |
get_reviews_products__product_id__reviews_get /products/{product_id}/reviews |
Return all feedback/reviews for a product. |
| GET |
low_confidence_products_products_low_confidence_get /products/low-confidence |
List products with confidence score below threshold — candidates for enrichment. |
| GET |
get_product_agent_discoveries_products__product_id__agent_discoveries_get /products/{product_id}/agent-discoveries |
Returns agent discovery activity for a product. Shows which agents recommended or queried this product, when, and for what query. Used by the dashboard 'Agent Discoveries' panel. |
| GET |
get_search_impressions_products__product_id__search_impressions_get /products/{product_id}/search-impressions |
Returns count of times this product appeared in search results. |
| GET |
list_products_products_get /products |
List all products with optional filtering |
| POST |
get_distribution_pack_products__product_id__distribution_pack_post /products/{product_id}/distribution-pack |
Generate (or regenerate) a 6-platform launch kit for a product. Supports four copy voices: founder / brand_we / advocate / ghostwrite. Each call regenerates fresh copy. Also… |
| GET |
similar_products_products__product_id__similar_get /products/{product_id}/similar |
Return products similar to the given one (same category + overlapping features). |
| GET |
get_versions_products__product_id__versions_get /products/{product_id}/versions |
Return version history chain for a product. |
| POST |
track_outbound_click_products__product_id__outbound_click_post /products/{product_id}/outbound-click |
Track an outbound click from an Agent Card to a product's website (G2). Call this when an AI agent or user follows the website link from an Agent Card. Records a platform_events… |
| POST |
bulk_import_products_bulk_import_post /products/bulk-import |
Bulk import products via JSON array. Streams SSE progress per product. Each product goes through validate_and_finalize then create_product. |
| search | ||
| POST |
agent_search_search_agent_post /search/agent |
Natural language product search via AI. Interprets intent, extracts filters, returns ranked results with relevance explanation. |
| GET |
search_search_get /search |
Search products by name, description, category and features |
| feedback | ||
| POST |
submit_feedback_feedback_post /feedback |
Submit structured feedback from an AI agent about a product. |
| stats | ||
| GET |
platform_stats_stats_get /stats |
Return platform-level statistics. |
| agent | ||
| POST |
platform_agent_chat_agent_platform_post /agent/platform |
Context-aware Platform Agent — streams SSE tokens. Attach context: {page, product_id?, product?, user_products?[]} |
| agent-session | ||
| POST |
create_agent_session_agent_session_post /agent-session |
Issue a short-lived capability JWT for an agent (15-min TTL). The token scopes the agent to specific operations on the platform. Pass it as: Authorization: Bearer |
| agents | ||
| POST |
register_agent_agents_register_post /agents/register |
Formally register an external AI agent. Returns a unique api_key for the agent (F3). The api_key is generated once on first registration and stable across re-registrations. |
| GET |
get_agent_profile_agents__agent_id__get /agents/{agent_id} |
Get a specific agent's profile. |
| POST |
verify_agent_agents__agent_id__verify_post /agents/{agent_id}/verify |
Mark a registered agent as verified. An agent is eligible for verification when it has made at least 5 queries (total_queries >= 5). This endpoint is intentionally lightweight —… |
| GET |
list_agents_agents_get /agents |
Return the registered agent directory. |
| bookmarks | ||
| POST |
add_bookmark_bookmarks_post /bookmarks |
Bookmark a product for a user or agent. |
| DELETE |
remove_bookmark_bookmarks__bookmark_id__delete /bookmarks/{bookmark_id} |
Remove a bookmark (must be the owner). |
| GET |
list_bookmarks_bookmarks_get /bookmarks |
List bookmarks for a user. |
| agent-subscriptions | ||
| GET |
list_subscriptions_agent_subscriptions_get /agent-subscriptions |
List all active subscriptions for an agent. |
| DELETE |
cancel_subscription_agent_subscriptions__subscription_id__delete /agent-subscriptions/{subscription_id} |
Cancel a subscription (soft delete — sets active=False). |
+ 19 more endpoints on the provider's documentation.
NaN Mesh pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
