/
API Reference
REST API · v1

Nextool.ai
Developer API

Programmatic access to 300+ curated AI tools and 163+ categories. Build integrations, power discovery features, and enrich your product with live AI tool data.

API Key Auth
Secure key-based auth
Rate Limiting
Per-minute plan limits
REST + JSON
Standard HTTP interface
Usage Analytics
Request logs by key

API key required

All endpoints require a valid X-API-Key header. Contact us to get access.

Looking for MCP?

Connect Claude, Cursor, or any MCP-compatible assistant directly -- no API key needed. MCP Server docs.

Authentication

Pass your API key via the X-API-Key header on every request. Keys are prefixed with sk_ and are plan-scoped.

bash
1curl "https://bnkmsvdtubbrqtdqoukb.supabase.co/functions/v1/public-api/api/v1/tools" \
2 -H "X-API-Key: sk_your_api_key_here"
401MISSING_API_KEYNo X-API-Key header was provided
401INVALID_API_KEYKey not found or does not match stored hash
401REVOKED_API_KEYKey has been deactivated by an admin

Base URL

All endpoints are relative to this base URL. HTTPS only.

text
1https://bnkmsvdtubbrqtdqoukb.supabase.co/functions/v1/public-api/api/v1

Append endpoint paths like /tools, /categories, or /search.

Rate Limiting

Limits are enforced per API key per 60-second window. When exceeded, a 429 is returned. The remaining count resets automatically each minute.

X-RateLimit-Limit

Max requests/min for your plan

X-RateLimit-Remaining

Requests left in this window

X-RateLimit-Reset

Unix timestamp for window reset

429 Response

json
1{
2 "error": "Rate limit exceeded. Max 60 requests per minute.",
3 "code": "RATE_LIMIT_EXCEEDED"
4}

Response Format

All responses are Content-Type: application/json. List endpoints wrap results in a data array with a meta pagination object. Single-item endpoints wrap in data. Errors include error and code fields.

List response

json
1{
2 "data": [ /* array of items */ ],
3 "meta": {
4 "page": 1,
5 "per_page": 20,
6 "total": 312,
7 "total_pages": 16
8 }
9}

Error response

json
1{
2 "error": "Human-readable message",
3 "code": "MACHINE_READABLE_CODE"
4}

Endpoints

5 endpoints. All read-only (GET). Click any row to expand parameters and code examples.

Error Codes

All error responses follow the same shape with an HTTP status code, human-readable error string, and machine-readable code.

StatusLabelDescription
200OKRequest succeeded.
400Bad RequestMalformed query parameters.
401UnauthorizedMissing, invalid, or revoked API key.
404Not FoundThe requested resource does not exist.
429Too Many RequestsRate limit exceeded for your plan.
500Internal Server ErrorSomething went wrong on our end.

Quick Start

Get up and running in under 5 minutes.

1

Obtain an API key

Contact us to get provisioned with an API key. Keys are delivered via email and prefixed with sk_.

2

Make your first request

bash
1curl "https://bnkmsvdtubbrqtdqoukb.supabase.co/functions/v1/public-api/api/v1/tools?per_page=3" \
2 -H "X-API-Key: sk_your_api_key_here"
3

Build your integration

bash
1# Search and filter in one go
2curl "https://bnkmsvdtubbrqtdqoukb.supabase.co/functions/v1/public-api/api/v1/search?q=writing+assistant&limit=5" \
3 -H "X-API-Key: sk_your_api_key_here"

Plans & Limits

All plans include full access to all 5 endpoints.

Starter
Contact us
60 req / min
  • 60 requests / min
  • All 5 endpoints
  • Email support
  • Usage dashboard
ProPopular
Contact us
300 req / min
  • 300 requests / min
  • All 5 endpoints
  • Priority support
  • Usage analytics
  • Higher data freshness
Enterprise
Contact us
1,000 req / min
  • 1,000+ requests / min
  • All 5 endpoints
  • SLA guarantee
  • Dedicated support
  • Custom rate limits
  • Bulk data export

Ready to start building?

Get your API key provisioned in minutes.

Contact us