DealsForge
Developer API

Query LLM API deals from your own tools.

DealsForge exposes provider, model, deal and catalog data through a simple JSON API. Use it to power internal dashboards, procurement checks, alerts or agent routing logic.

QuickstartRequest API access

Authentication

Send your key with X-API-Key or Authorization: Bearer.

Rate limits

Responses include X-RateLimit-* headers so clients can back off safely.

Production-safe

Admin, Pro and internal routes fail closed without a valid key.

Quickstart

Base URL

https://api.deals-forge.com

Auth header

X-API-Key: df_...

Fetch latest deals

curl "https://api.deals-forge.com/api/v1/deals?limit=25" \
  -H "X-API-Key: $DEALSFORGE_API_KEY"

TypeScript

const res = await fetch("https://api.deals-forge.com/api/v1/catalog/stats", {
  headers: { "Authorization": `Bearer ${process.env.DEALSFORGE_API_KEY}` },
});

if (!res.ok) throw new Error(`DealsForge API error: ${res.status}`);
const stats = await res.json();

Compare providers for one model

curl "https://api.deals-forge.com/api/compare?model=deepseek-v4-pro"

Endpoints

GET/api/v1/deals

List current deals with provider, model, price and status signals.

GET/api/v1/providers

List providers with free-tier, region and compatibility metadata.

GET/api/v1/models

List canonical models and provider-model inventory.

GET/api/v1/catalog/stats

Read catalog totals for providers, models, prices and coverage.

GET/api/deals/hot

Public hot deal feed, useful for widgets and previews.

GET/api/deals/free

Public free deal feed for no-cost API discovery.

GET/api/compare?model=deepseek-v4-pro

Public provider comparison for a model, resolved through canonical model aliases.

GET/api/compare?provider1=deepseek&provider2=openrouter

Public side-by-side provider report with catalog, pricing, context and deal heat stats.

Common deal fields

id, slug, titleprovider_name, provider_slugmodel_name, model_slugtype, status, confidence_scoreprice_per_million, quota_rpm, quota_tpdhot_score, cold_score, temperatureupdated_at, checked_at

Errors and limits

401 Missing, revoked or invalid API key.

403 Endpoint requires a Pro, business or internal key.

429 Rate limit exceeded. Read `X-RateLimit-Reset` before retrying.

5xx Temporary upstream or Worker error. Retry with backoff.