Factory402 API Endpoints

Real-time intelligence for the built world. Pay per request with API credits — no subscriptions, no commitments.

How It Works

1. Get an API key — Create one below or via POST /api/keys
2. Buy credit packs — Load your key with credits via Stripe checkout
3. Make requests — Pass your key as Authorization: Bearer f402_live_...

Every paid request deducts credits from your balance. Free demo endpoint requires no key. Legacy x402 payment headers also accepted.

Credit Packs

Buy once, use anytime. Credits never expire.

Starter

50 credits

$50

Try a few endpoints. Enough for 5 company profiles or 8 risk scores.

$1.00 per credit

Popular

Growth

110 credits (100 + 10 bonus)

$100

Best value for regular users. 10% bonus credits included.

$0.91 per credit

Scale

300 credits (250 + 50 bonus)

$250

For teams running multiple analyses. 20% bonus credits.

$0.83 per credit

Enterprise

600 credits (500 + 100 bonus)

$500

High-volume intelligence. Dedicated support and SLA available.

$0.83 per credit

Endpoint Pricing

Prices shown in credits. Each credit ≈ $0.83–$1.00 depending on your pack.

ID	Method	Path	Description	Credits
osint.demo.v1	GET	/api/osint/demo	Free demo endpoint — returns sample intelligence data to preview output format.	Free
osint.market_signals.v1	GET	/api/osint/market-signals	Emerging trends, anomalies, and sentiment shifts.	6
osint.risk_score.v1	GET	/api/osint/risk-score	Numeric risk score with full explanation and confidence interval.	8
osint.company_profile.v1	GET	/api/osint/company-profile	Structured company profile including ownership, leadership, sector, and risk flags.	10
osint.competitor_dossier.v1	GET	/api/osint/competitor-dossier	Competitor landscape, positioning, and strategy signals.	12
osint.supply_chain_map.v1	GET	/api/osint/supply-chain-map	Upstream/downstream supply chain entities with geography and risk markers.	15
product.dossier_download.v1	GET	/api/products/dossier/:id	Download full intelligence dossier by ID.	20
workflow.risk_analysis.v1	POST	/api/workflows/risk-analysis	Structured risk assessment workflow with scenario modeling.	35
workflow.corporate_intel.v1	POST	/api/workflows/corporate-intel	Multi-agent corporate intelligence workflow.	40
workflow.market_mapping.v1	POST	/api/workflows/market-mapping	Market map, key players, and competitive dynamics.	45
workflow.operational_forecast.v1	POST	/api/workflows/operational-forecast	Operational forecast with scenario analysis.	50

Quick Start

1. Create an API key

curl -X POST https://api.factory402.com/api/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","name":"Your Name"}'

2. Check your balance

curl https://api.factory402.com/api/credits \
  -H "Authorization: Bearer f402_live_YOUR_KEY"

3. Hit a paid endpoint

curl "https://api.factory402.com/api/osint/risk-score?query=Acme+Corp" \
  -H "Authorization: Bearer f402_live_YOUR_KEY"

4. View usage

curl https://api.factory402.com/api/usage \
  -H "Authorization: Bearer f402_live_YOUR_KEY"