Developer Portal

API & Developer Tools

Access the AaaS Knowledge Index programmatically. Export data in multiple formats, integrate via REST API, manage API keys, and configure webhooks for real-time updates.

API Reference

Base URL

https://aaas.blog/api

Authentication

x-api-key: aaas_your_key_here

Pass your API key in the x-api-key header. Anonymous access is rate-limited to 20 requests/day per IP.

Available Endpoints

Method	Endpoint	Params	Description
GET	/api/entities	?type=tool&limit=50&channel=ai-tools	List and filter entities
GET	/api/entity/:type/:slug		Get a single entity by type and slug
GET	/api/search	?q=langchain&type=tool	Full-text search across all entities
GET	/api/leaderboard/:category	?limit=25	Leaderboard rankings by category
GET	/api/trending	?limit=10	Trending entities by recent activity
GET	/api/export/entities	?format=json&type=model&fields=name,provider,composite	Export entities in JSON, CSV, or JSONL
GET	/api/export/leaderboard	?format=csv&category=all	Export leaderboard data
GET	/api/export/changelog	?format=json&since=2026-01-01&type=tool	Export entity change history
POST	/api/submit		Submit a new entity for review
GET	/api/entity/:type/:slug/changelog		Get changelog for a specific entity
GET	/api/entity/:type/:slug/similar	?limit=5	Find similar entities
GET	/api/feed		RSS feed of all changes
GET	/api/openapi		OpenAPI 3.0 spec (machine-readable)
POST	/api/webhooks		Register a webhook endpoint
GET	/api/developer/api-keys		List your API keys (masked)
POST	/api/developer/api-keys		Generate a new API key
DELETE	/api/developer/api-keys		Revoke an API key

Export Tools

Download bulk data from the Knowledge Index. Use JSONL format for LLM fine-tuning and ML pipelines.

Entities (JSON)

All entities as JSON array

JSON

Entities (CSV)

All entities as CSV spreadsheet

CSV

Entities (JSONL)

All entities as newline-delimited JSON (for LLM/ML pipelines)

JSONL

Leaderboard (JSON)

Full leaderboard with scores and rankings

JSON

Leaderboard (CSV)

Leaderboard as CSV spreadsheet

CSV

Changelog (JSON)

Entity change history with diffs

JSON

Changelog (CSV)

Change history as CSV spreadsheet

CSV

Custom Export

Filter by type and select specific fields:

GET /api/export/entities?format=jsonl&type=model&fields=name,provider,composite,adoption

Available fields: slug, type, name, provider, description, category, version, pricingModel, license, url, tags, capabilities, composite, adoption, quality, freshness, citations, engagement, addedDate, lastUpdated

Code Examples

GET/api/entities

List all entities, optionally filtering by type. Returns paginated results sorted by composite score.

curl -X GET "https://aaas.blog/api/entities?type=tool&limit=10" \
  -H "x-api-key: aaas_your_key_here"

GET/api/search

Full-text search across all entity types. Returns matching entities ranked by relevance.

curl -X GET "https://aaas.blog/api/search?q=langchain&type=tool" \
  -H "x-api-key: aaas_your_key_here"

POST/api/submit

Submit a new entity for review. Requires authentication. The entity will be reviewed before appearing in the index.

curl -X POST "https://aaas.blog/api/submit" \
  -H "x-api-key: aaas_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "tool",
  "name": "My Tool",
  "provider": "Acme Corp",
  "description": "A great AI tool for building agents",
  "category": "ai-tools",
  "url": "https://example.com",
  "tags": [
    "ai",
    "agents",
    "automation"
  ]
}'

GET/api/export/entities

Export all entities in JSONL format for ML pipelines. Filter by type and select specific fields.

curl -X GET "https://aaas.blog/api/export/entities?format=jsonl&type=model&fields=name%2Cprovider%2Ccomposite" \
  -H "x-api-key: aaas_your_key_here"

POST/api/webhooks

curl -X POST "https://aaas.blog/api/webhooks" \
  -H "x-api-key: aaas_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://your-app.com/webhooks/aaas",
  "events": [
    "entity.created",
    "entity.updated"
  ]
}'

POST/api/developer/api-keys

Generate a new API key. Requires authentication with an existing key. Max 5 active keys per account.

curl -X POST "https://aaas.blog/api/developer/api-keys" \
  -H "x-api-key: aaas_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "production-key"
}'

API Key Management

Register for API Key

Your API Keys

Webhook Registration

Register a webhook to receive real-time POST notifications when entities change. Your endpoint must accept HTTPS POST requests and respond with a 2xx status.

Webhook Payload Example

{ "event": "entity.updated", "timestamp": "2026-03-12T14:30:00Z", "entity": { "type": "tool", "slug": "langchain", "name": "LangChain" }, "changes": [ { "field": "version", "old": "0.1.0", "new": "0.2.0" } ] }

Rate Limits & Quotas

Tier	Limit	Window	Auth
Anonymous	20	per day (UTC)	IP-based
Authenticated	100	per day (UTC)	x-api-key header
Enterprise	Custom	Custom	Contact us

Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 87

X-RateLimit-Reset: 1741996799

The Reset value is a Unix epoch timestamp for end-of-day UTC when the counter resets.

Key Limits

Maximum 5 active API keys per account
Keys can be revoked at any time via the management panel or API
Rate limit resets daily at 00:00 UTC
Export endpoints count toward your daily rate limit
Contact hello@aaas.name for enterprise limits