SWEN.AI API — Developer Docs

Read-only REST API — news, AI model catalog, intelligence ranking, tools and tutorials.

Base URL

https://swen.ia.br/api/v1

Authentication

All endpoints work without a key at a low anonymous rate limit (10 requests/minute per IP), so you can try the API before requesting a key. For a higher limit (30 requests/minute), get a free key instantly below — no approval wait. Send it as a Bearer token:

Authorization: Bearer sk_swen_...

Keys are scoped per resource (news, models, tools, tutorials).

Get an API key

Need a higher limit or a negotiated partnership? Contact contato@swen.ia.br.

Endpoints

Method	Path	Description
`GET`	`/api/v1/news`	List news articles (summary + canonical link, no full body).
`GET`	`/api/v1/news/{slug}`	Single news article by slug.
`GET`	`/api/v1/models`	AI model catalog: pricing, context window, speed.
`GET`	`/api/v1/models/{slug}`	Single model by slug.
`GET`	`/api/v1/rankings/intelligence`	Intelligence ranking — Artificial Analysis Intelligence Index, deduplicated by model family. Identical ordering to swen.ia.br/ranking and the iOS app.
`GET`	`/api/v1/tools`	AI tools directory: pricing, ratings, categories.
`GET`	`/api/v1/tutorials`	Tutorials and guides directory.

Example

curl https://swen.ia.br/api/v1/rankings/intelligence?limit=10 \
  -H "Authorization: Bearer sk_swen_..."

{
  "data": [
    { "rank": 1, "slug": "anthropic-claude-fable-5", "name": "Claude Fable 5", "vendor": "Anthropic", "score": 59.9, "url": "https://swen.ia.br/benchmark/anthropic-claude-fable-5" },
    { "rank": 2, "slug": "openai-gpt-5-6-sol-max", "name": "GPT-5.6 Sol (max)", "vendor": "OpenAI", "score": 58.9, "url": "https://swen.ia.br/benchmark/openai-gpt-5-6-sol-max" }
  ],
  "meta": { "count": 2, "source": "Artificial Analysis Intelligence Index", "updatedAt": "2026-07-17T14:30:00.000Z" }
}

Rate limits

Anonymous (no key): 10 requests/minute per IP.
Self-serve key (instant, below): 30 requests/minute.
Negotiated partnership: higher limits on request.

Exceeding the limit returns 429 with a Retry-After header.

MCP Server (for AI agents)

SWEN.AI runs a public Model Context Protocol server exposing the same 4 data sources as callable tools — for Claude, ChatGPT, Cursor and any MCP-compatible agent. No API key required (IP rate limited).

https://swen.ia.br/api/mcp

Available tools: search_news, get_news_article, list_ai_models, get_model, get_intelligence_ranking, search_tools, list_tutorials.

Attribution

Intelligence ranking data is sourced from Artificial Analysis. If you display this data publicly, please credit SWEN.AI and link back to swen.ia.br.

Contract stability

All field names are English and versioned under /v1. We will never silently rename or remove a field within v1 — breaking changes ship as /v2.

SWEN.AI Public API