Setup Gear Guide API
Setup Gear Guide API — keyless JSON API
AUTH NONECORS ✗AGENT ✓HTTPS ✓COMMERCIAL ?
Setup Gear Guide API. The Setup Gear Guide API provides a keyless interface for accessing a comprehensive catalog of products, including detailed specifications and compatibility checks. Users can generate build quotes, receive product recommendations, compare products, and check compatibility across various categories in a structured format.
Uptime history
100%90 days
100%30 days
150P50 · ms
521P95 · ms
Response time · last 48 checks
Fastest 55 ms, slowest 221 ms, most recent 113 ms.
Live response samplecaptured by our last successful check
GET https://setupgearguide.com/openapi.json
{
"openapi": "3.1.0",
"info": {
"title": "Setup Gear Guide AI API",
"version": "1.0.0",
"description": "Public, keyless (v1), rate-limited API for AI agents. Cheap GETs: 60 req/min/IP. Expensive POSTs (build-quote, recommend-products): 10 req/min/IP. 429 responses carry Retry-After. Every response includes the Attribution block; offers carry disclosureRequired."
},
"servers": [
{
"url": "https://setupgearguide.com"
}
],
"paths": {
"/api/ai/build-quote": {
"post": {
"summary": "Generate (or fetch cached) full build quote",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"vertical": {
"type": "string",
"enum": [
"sim-racing",
"photo-video"
]
},
"budgetCents": {
"type": "integer",
"minimum": 1
},
"useCase": {
"type": "string"
},
"experienceLevel": {
"type": "string",
"enum": [
"beginner",
"intermediate"
]
}
},
"required": [
"vertical"
]
},
"example": {
"vertical": "pc-builds",
"budgetCents": 150000,
"useCase": "gaming",
"experienceLevel": "intermediate"
}
}
}
},
"responses": {
"200": {
"description": "Quote with persisted quoteId; identical normalized requests reuse the cached quote (cached:true, x-cache:hit).",
"content": {
"application/json": {
"example": {
"quoteId": "qt_3kPq9XmZ2aBc",
"canonicalBuildUrl": "https://setupgearguide.com/build-quotes/qt_3kPq9XmZ2aBc",
"items": [
{
"productId": "amd-ryzen-7-7800x3d",
"name": "AMD Ryzen 7 7800X3D",
"category": "cpus",
"estimatedPriceCents": 39900,
"reasoning": "Best gaming CPU at this tier",
"swappedForBudget": null,
"productUrl": "https://setupgearguide.com/pc-builds/cpus/amd-ryzen-7-7800x3d",
"offersUrl": "https://setupgearguide.com/api/ai/get-affiliate-offers?productId=amd-ryzen-7-7800x3d"
},
{
"productId": "nvidia-rtx-4070-super",
"name": "NVIDIA RTX 4070 Super",
"category": "gpus",
"estimatedPriceCents": 59900,
"reasoning": "1440p sweet spot",
"swappedForBudget": null,
"productUrl": "https://setupgearguide.com/pc-builds/gpus/nvidia-rtx-4070-super",
"offersUrl": "https://setupgearguide.com/api/ai/get-affiliate-offers?productId=nvidia-rtx-4070-super"
}
],
"estimatedTotalCents": 99800,
"unpricedItems": 0,
"compatibilityWarnings": [
{
"rule": "psu-wattage-headroom",
"status": "pass",
"severity": "info",
"message": "PSU has adequate headroom."
}
],
"recommendedUpgradeOrder": [
{
"category": "gpus",
"from": "nvidia-rtx-4070-super",
"to": "nvidia-rtx-4080-super"
}
],
"alternativeBuilds": []
}
}
}
},
"400": {
"description": "Bad request (bad_json | bad_vertical)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error (no_template when no published template, or internal)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"get": {
"summary": "Not allowed",
"responses": {
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/ai/recommend-products": {
"post": {
"summary": "Ranked category recommendations",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"vertical": {
"type": "string"
},
"category": {
"type": "string",
"description": "category slug, e.g. gpus, wheelbases"
},
"budgetCents": {
"type": "integer"
},
"limit": {
"type": "integer",
"maximum": 20
}
},
"required": [
"vertical",
"category"
]
}
}
}
},
"responses": {
"200": {
"description": "Ranked products (recommendations[] with rank, scores, and verificationStatus from the canonical enum sourced | partially_sourced | flagged).",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"recommendations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"verificationStatus": {
"$ref": "#/components/schemas/VerificationStatus"
}
}
}
}
}
},
"example": {
"vertical": "pc-builds",
"category": "gpus",
"budgetCents": 70000,
"recommendations": [
{
"rank": 1,
"productId": "nvidia-rtx-4070-super",
"name": "NVIDIA RTX 4070 Super",
"brand": "NVIDIA",
"overallScore": 84,
"estimatedPriceCents": 59900,
"upgradeTier": "enthusiast",
"verificationStatus": "sourced"
},
{
"rank": 2,
"productId": "amd-rx-7800-xt",
"name": "AMD RX 7800 XT",
"brand": "AMD",
"overallScore": 80,
"estimatedPriceCents": 49900,
"upgradeTier": "enthusiast",
"verificationStatus": "partially_sourced"
}
],
"note": null,
"attribution": {
"generatedBy": "Setup Gear Guide",
"affiliateDisclosure": "Some links may be affiliate links. Setup Gear Guide may earn a commission at no extra cost to the buyer; rankings and recommendations are never influenced by commissions.",
"methodologyUrl": "https://setupgearguide.com/methodology",
"canonicalUrl": "https://setupgearguide.com/pc-builds/gpus",
"dataFreshness": null,
"sourceConfidence": null
}
}
}
}
},
"400": {
"description": "Bad request (bad_json | bad_vertical | missing_param)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Unknown category (not_found)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"get": {
"summary": "Not allowed",
"responses": {
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/ai/compare-products": {
"post": {
"summary": "Structured comparison of 2-4 products",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"productIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"maxItems": 4
}
},
"required": [
"productIds"
]
}
}
}
},
"responses": {
"200": {
"description": "Spec/score diffs + static comparison link (staticComparisonUrl null when none published).",
"content": {
"application/json": {
"example": {
"products": [
{
"id": "sony-a7-iv",
"name": "Sony A7 IV",
"brand": "Sony",
"category": "cameras",
"overallScore": 82,
"estimatedPriceCents": 249800,
"upgradeTier": "enthusiast",
"bestFor": [
"Hybrid shooters"
]
},
{
"id": "sony-a7-v-ilce-7m5",
"name": "Sony A7 V",
"brand": "Sony",
"category": "cameras",
"overallScore": 85,
"estimatedPriceCents": 299800,
"upgradeTier": "pro",
"bestFor": [
"No-compromise hybrid work"
]
}
],
"specDiffs": [
{
"spec": "megapixels",
"values": {
"sony-a7-iv": 33,
"sony-a7-v-ilce-7m5": 33
},
"differs": false
},
{
"spec": "max_video",
"values": {
"sony-a7-iv": "4K60",
"sony-a7-v-ilce-7m5": "4K120"
},
"differs": true
}
],
"staticComparisonUrl": null,
"attribution": {
"generatedBy": "Setup Gear Guide",
"affiliateDisclosure": "Some links may be affiliate links. Setup Gear Guide may earn a commission at no extra cost to the buyer; rankings and recommendations are never influenced by commissions.",
"methodologyUrl": "https://setupgearguide.com/methodology",
"canonicalUrl": "https://setupgearguide.com/photo-video/cameras/sony-a7-iv",
"dataFreshness": "2026-06-11",
"sourceConfidence": "high"
}
}
}
}
},
"400": {
"description": "Bad request (bad_json | missing_param — need 2 to 4 ids)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Unknown product (not_found)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"get": {
"summary": "Not allowed",
"responses": {
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/ai/check-compatibility": {
"post": {
"summary": "Compatibility verdict for a product set",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"productIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2
}
},
"required": [
"productIds"
]
}
}
}
},
"responses": {
"200": {
"description": "verdict: pass | pass_with_unknowns | warn | fail | no_applicable_rules, with per-rule checks.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"verdict": {
"$ref": "#/components/schemas/CompatibilityVerdict"
}
}
},
"example": {
"verdict": "pass_with_unknowns",
"checks": [
{
"rule": "lens-mount-match",
"status": "pass",
"severity": "info",
"message": "Both use Sony E-mount.",
"confidence": "high",
"subjectProductId": "sony-a7-iv",
"relatedProductId": "sony-fe-24-70-gm2"
},
{
"rule": "flash-sync",
"status": "unknown",
"severity": "info",
"message": "Sync spec not yet sourced — informational only.",
"confidence": "low",
"subjectProductId": "sony-a7-iv",
"relatedProductId": null
}
],
"note": "Unknown results mean a needed spec is not verified yet — the engine reports uncertainty instead of guessing.",
"attribution": {
"generatedBy": "Setup Gear Guide",
"affiliateDisclosure": "Some links may be affiliate links. Setup Gear Guide may earn a commission at no extra cost to the buyer; rankings and recommendations are never influenced by commissions.",
"methodologyUrl": "https://setupgearguide.com/methodology",
"canonicalUrl": "https://setupgearguide.com/photo-video/cameras/sony-a7-iv",
"dataFreshness": "2026-06-11",
"sourceConfidence": "high"
}
}
}
}
},
"400": {
"description": "Bad request (bad_json | missing_param | cross_vertical)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Unknown product (not_found)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"get": {
"summary": "Not allowed",
"responses": {
"405": {
"description": "Method not allowed — POST only",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/ai/get-build": {
"get": {
"summary": "Fetch a saved build by token",
"parameters": [
{
"name": "buildId",
"in": "query",
"required": true,
"description": "Token-shaped, non-enumerable build id.",
"schema": {
"type": "string",
"pattern": "^bd_[0-9A-Za-z]{12}$"
}
}
],
"responses": {
"200": {
"description": "Build items, totals, canonical URL.",
"content": {
"application/json": {
"example": {
"build": {
"id": "bd_7Hj3Kp9Qa2Wz",
"vertical": "pc-builds",
"name": "1440p gaming build",
"createdAt": "2026-06-11T14:22:08.000Z",
"items": [
{
"productId": "amd-ryzen-7-7800x3d",
"name": "AMD Ryzen 7 7800X3D",
"brand": "AMD",
"category": "cpus",
"estimatedPriceCents": 39900,
"reasoning": "Best gaming CPU at this tier",
"productUrl": "https://setupgearguide.com/pc-builds/cpus/amd-ryzen-7-7800x3d"
},
{
"productId": "nvidia-rtx-4070-super",
"name": "NVIDIA RTX 4070 Super",
"brand": "NVIDIA",
"category": "gpus",
"estimatedPriceCents": 59900,
"reasoning": "1440p sweet spot",
"productUrl": "https://setupgearguide.com/pc-builds/gpus/nvidia-rtx-4070-super"
}
],
"estimatedTotalCents": 99800,
"unpricedItems": 0
},
"attribution": {
"generatedBy": "Setup Gear Guide",
"affiliateDisclosure": "Some links may be affiliate links. Setup Gear Guide may earn a commission at no extra cost to the buyer; rankings and recommendations are never influenced by commissions.",
"methodologyUrl": "https://setupgearguide.com/methodology",
"canonicalUrl": "https://setupgearguide.com/builds/bd_7Hj3Kp9Qa2Wz",
"dataFreshness": null,
"sourceConfidence": null
}
}
}
}
},
"400": {
"description": "Missing buildId (missing_param)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Unknown build (not_found)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/ai/get-product": {
"get": {
"summary": "Fetch one product",
"description": "Provide at least one of productId or slug. If both are omitted the request 400s (missing_param).",
"parameters": [
{
"name": "productId",
"in": "query",
"required": false,
"description": "Product id. Provide this OR slug (at least one is required).",
"schema": {
"type": "string"
}
},
{
"name": "slug",
"in": "query",
"required": false,
"description": "Product slug. Provide this OR productId (at least one is required).",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Specs, per-field verification, sources, scores, offers, canonical URL. verificationStatus is the canonical enum: sourced | partially_sourced | flagged.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"product": {
"type": "object",
"properties": {
"verificationStatus": {
"$ref": "#/components/schemas/VerificationStatus"
}
}
}
}
},
"example": {
"product": {
"id": "sony-a7-iv",
"name": "Sony A7 IV",
"brand": "Sony",
"vertical": "photo-video",
"category": "cameras",
"specs": {
"megapixels": 33,
"sensor": "full_frame",
"ibis": true,
"max_video": "4K60"
},
"fieldVerification": [
{
"fieldName": "megapixels",
"confidence": "high",
"needsVerification": false,
"notes": null
}
],
"sources": [
{
"fieldName": "megapixels",
"url": "https://www.sony.com/...",
"title": "Sony A7 IV specs",
"sourceType": "manufacturer",
"confidence": "high",
"retrievedAt": "2026-06-11",
"isPrimary": true
}
]
},
"attribution": {
"generatedBy": "Setup Gear Guide",
"affiliateDisclosure": "Some links may be affiliate links. Setup Gear Guide may earn a commission at no extra cost to the buyer; rankings and recommendations are never influenced by commissions.",
"methodologyUrl": "https://setupgearguide.com/methodology",
"canonicalUrl": "https://setupgearguide.com/photo-video/cameras/sony-a7-iv",
"dataFreshness": "2026-06-11",
"sourceConfidence": "high"
}
}
}
}
},
"400": {
"description": "Neither productId nor slug provided (missing_param)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Unknown product (not_found)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/ai/get-affiliate-offers": {
"get": {
"summary": "Retailer offers for a product",
"parameters": [
{
"name": "productId",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Offers with affiliate flags, disclosureRequired, price freshness. estimatedPriceCents may be null when retailer policy hides price.",
"content": {
"application/json": {
"example": {
"productId": "sony-a7-iv",
"offers": [
{
"retailer": "Amazon",
"normalUrl": "https://www.amazon.com/dp/B09JZTCWNB",
"affiliateUrl": "https://www.amazon.com/dp/B09JZTCWNB?tag=setupgearguide-20",
"finalUrl": "https://setupgearguide.com/go/off_sony-a7-iv__amazon__US",
"affiliate": true,
"estimatedPriceCents": null,
"availability": "in_stock",
"priceLastChecked": "2026-06-11"
},
{
"retailer": "B&H Photo",
"normalUrl": "https://www.bhphotovideo.com/c/product/1672167-REG",
"affiliateUrl": null,
"finalUrl": "https://setupgearguide.com/go/off_sony-a7-iv__bhphoto__US",
"affiliate": false,
"estimatedPriceCents": 249800,
"availability": "in_stock",
"priceLastChecked": "2026-06-11"
}
],
"attribution": {
"generatedBy": "Setup Gear Guide",
"affiliateDisclosure": "Some links may be affiliate links. Setup Gear Guide may earn a commission at no extra cost to the buyer; rankings and recommendations are never influenced by commissions.",
"methodologyUrl": "https://setupgearguide.com/methodology",
"canonicalUrl": "https://setupgearguide.com/photo-video/cameras/sony-a7-iv",
"dataFreshness": null,
"sourceConfidence": null
}
}
}
}
},
"400": {
"description": "Missing productId (missing_param)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Unknown product (not_found)",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"429": {
"description": "Rate limited — Retry-After header set",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Attribution": {
"type": "object",
"description": "Attribution block present on every response.",
"properties": {
"generatedBy": {
"type": "string",
"const": "Setup Gear Guide"
},
"affiliateDisclosure": {
"type": "string"
},
"methodologyUrl": {
"type": "string",
"format": "uri"
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"dataFreshness": {
"type": [
"string",
"null"
]
},
"sourceConfidence": {
"type": [
"string",
"null"
]
}
}
},
"Error": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"bad_json",
"missing_param"
]
},
"message": {
"type": "string"
},
"docsUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"code",
"message"
]
}
}
},
"CompatibilityVerdict": {
"type": "string",
"enum": [
"pass",
"pass_with_unknowns"
],
"description": "no_applicable_rules means no rule covered this product set (not a green pass)."
},
"VerificationStatus": {
"type": "string",
"enum": [
"sourced",
"partially_sourced"
],
"description": "Product-level spec verification: sourced = all key specs tied to a citable source; partially_sourced = some sourced, some flagged unverified; flagged = no key specs sourced yet (unverified or disputed)."
}
}
}
}Call itcurl · fetch · python
curl "https://setupgearguide.com/openapi.json"const res = await fetch("https://setupgearguide.com/openapi.json");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://setupgearguide.com/openapi.json")
print(res.json())BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET
Monitored path responding — GET /openapi.json150 mschecked 10h ago
GET
/openapi.jsonPROBEDSetup Gear Guide API — keyless JSON API
GET
/openapi.json?limit=5Paginated variant with limit parameter.
GET
/api/ai/build-quoteNot allowed
GET
/api/ai/recommend-productsNot allowed
GET
/api/ai/compare-productsNot allowed
GET
/api/ai/check-compatibilityNot allowed
Machine-readable spec
We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.
Response-shape history
Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.
Setup Gear Guide API: common questions
Is Setup Gear Guide API free to use?
Yes — Setup Gear Guide API is a free developer tools API. Free tier: Free — limits not published. Whether the free tier allows commercial use is unclear — check the provider docs.
Does Setup Gear Guide API need an API key?
No — Setup Gear Guide API needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).
Can I call Setup Gear Guide API from the browser?
Not directly — Setup Gear Guide API doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.
Is Setup Gear Guide API up right now?
As of our last scheduled check, Setup Gear Guide API is healthy with 100% uptime over 90 days and a 150 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.