Developer Documentation

Entyrax API

Motor semântico de decisão para hardware. Graph estruturado, recomendação com reasoning, entity resolution e dados temporais — prontos para agentes de IA.

Solicitar API key Ver planos AI Manifest

Quick start

Endpoints públicos funcionam sem autenticação. Para acesso completo, inclua o header:

X-Entyrax-API-Key: entx_dev_sua_chave_aqui

X-Api-Key continua aceito como alias de compatibilidade.

GPU por slug

curl https://www.entyrax.com/api/gpus/geforce-rtx-4060.json

Build recommendation para uma CPU

curl https://www.entyrax.com/api/recommend/build/ryzen-5-5600.json \
  -H "X-Entyrax-API-Key: entx_dev_sua_chave"

Graph de compatibilidade CPU-GPU

curl https://www.entyrax.com/api/graph/cpu-gpu/gpus-for-cpu/ryzen-5-5600.json \
  -H "X-Entyrax-API-Key: entx_dev_sua_chave"

Índice do grafo

curl https://www.entyrax.com/api/graph/index.json

Endpoints — visão geral

Endpoint	Descrição	Free	Developer	Business
/robots.txt, /llms.txt	Discoverability para crawlers e agentes	✓	✓	✓
/ai-manifest.json	Capabilities, endpoints e schemas do Entyrax	✓	✓	✓
/api/status.json	Status, contagens e última atualização	✓	✓	✓
/api/gpus/index.json	Índice resumido de todas as GPUs	✓	✓	✓
/api/cpus/index.json	Índice resumido de todos os CPUs	✓	✓	✓
/api/graph/index.json	Stats e schema do grafo de relações	✓	✓	✓
/html/gpus/, /html/cpus/	Páginas HTML com specs, benchmarks e relações	✓	✓	✓
/api/gpus/{slug}.json	Entidade GPU completa com specs e confidence	—	✓	✓
/api/cpus/{slug}.json	Entidade CPU completa com benchmarks e scoring	—	✓	✓
/api/graph/cpu-gpu/, /api/graph/gpu-cpu/	Grafo de compatibilidade e pareamento CPU-GPU	—	✓	✓
/api/recommend/build/{cpu}.json	Melhor GPU por CPU com reasoning completo	—	✓	✓
/api/recommend/compare-builds/*	Comparação CPU A vs CPU B com GPUs compartilhadas	—	—	✓
Bulk, enrichment, market intelligence	Acesso massivo, normalização e dados temporais	—	—	✓

Estrutura de resposta — GPU

{
  "name": "GeForce RTX 4060",
  "slug": "geforce-rtx-4060",
  "brand": "NVIDIA",
  "vram_gb": 8,
  "avg_fps_1080p": 86,
  "avg_price_brl": 1999,
  "value_score": 6.6,
  "ai_summary": "GPU de entrada NVIDIA Ada Lovelace...",
  "_meta": {
    "avg_fps_1080p": { "confidence": 0.92, "source": "techpowerup.com" },
    "avg_price_brl": { "confidence": 0.88, "source": "kabum.com.br" }
  }
}

Estrutura de resposta — Build Recommendation

{
  "cpu_slug": "ryzen-5-5600",
  "resolution": "1440p",
  "recommendation": {
    "slug": "radeon-rx-7800-xt",
    "name": "Radeon RX 7800 XT",
    "reasoning": "Melhor equilíbrio com o Ryzen 5 5600 em 1440p..."
  },
  "rejected_options": [...],
  "decision_path": [...]
}

Rate limits

Plano	Discovery	Graph	Recommend	Entidades
Free	120/min	40/min	20/min	—
Developer	300/min	120/min	60/min	200/min
Business	1000/min	500/min	200/min	1000/min

Autenticação

Inclua o header em todas as requisições autenticadas:

X-Entyrax-API-Key: entx_dev_xxxxxxxxxxxxxxxx

X-Api-Key tambem e aceito como alias de compatibilidade.

Chaves Developer começam com entx_dev_. Chaves Business começam com entx_biz_.

Solicitar API key gratuita Comparar planos