{"openapi":"3.1.0","info":{"title":"iBUYPOWER API (Bowmark)","version":"e833508f87ff","description":"Gaming and workstation PCs from iBUYPOWER — the base configurators with their current starting prices, every component option on one with its exact price difference, the RDY prebuilts that ship as built with their stock counts and Time Spy scores, the Chimera gaming laptops with their real per-model display/CPU/GPU and stock, and the site's own measured 3DMark and per-game FPS for any CPU+GPU pair it has benchmarked.\n\nEvery function Bowmark has for iBUYPOWER (ibuypower.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/ibuypower/listSystems":{"post":{"operationId":"listSystems","summary":"Lists every base configurator iBUYPOWER currently sells — AMD and Intel — with its slug, name, current starting price and stock CPU/GPU/memory/storage lines.","description":"Lists every base configurator iBUYPOWER currently sells — AMD and Intel — with its slug, name, current starting price and stock CPU/GPU/memory/storage lines. Takes nothing. The slug it returns is what getSystem takes. THROWS rather than returning [] when the builder answers without its payload or lists nothing, because iBUYPOWER always sells these and an empty array would read as a catalogue that had emptied.\n\nCalls `bowmark.providers.ibuypower.listSystems`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<IbuypowerSystem[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/ibuypower/listPrebuilts":{"post":{"operationId":"listPrebuilts","summary":"Lists the RDY prebuilts — the fixed-configuration, ships-as-built SKUs, a different product line from the builder's configurators — with price, struck-through list price, the site's own one-line spec ","description":"Lists the RDY prebuilts — the fixed-configuration, ships-as-built SKUs, a different product line from the builder's configurators — with price, struck-through list price, the site's own one-line spec summary, CPU brand, unit stock count and iBUYPOWER's own 3DMark Time Spy scores. Takes nothing. Returns SOLD-OUT models too, flagged `inStock: false` and `stockCount: 0`, so a caller asking whether a machine exists is never told no when the true answer is 'yes, sold out'; filter on `inStock` for the ship-now set. `discontinued` marks models still buyable while stock lasts. THROWS rather than returning [] when the page answers without its payload or names nothing.\n\nCalls `bowmark.providers.ibuypower.listPrebuilts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<IbuypowerPrebuilt[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/ibuypower/listLaptops":{"post":{"operationId":"listLaptops","summary":"Lists every Chimera gaming laptop — iBUYPOWER's only laptop line, and a fixed-configuration product like the RDY prebuilts rather than a configurator you assemble — with its real per-model display, pr","description":"Lists every Chimera gaming laptop — iBUYPOWER's only laptop line, and a fixed-configuration product like the RDY prebuilts rather than a configurator you assemble — with its real per-model display, processor, video card, memory, storage and OS, its price and struck-through list price, unit stock count and iBUYPOWER's own 3DMark Time Spy scores. Takes nothing. The specs come from each row's own component map, NOT from the site's `Spec` blurb: that blurb is stale 2019 boilerplate repeated byte-for-byte on all 8 models (it claims a GTX 1660 Ti on a machine whose Time Spy GPU score is 24,000), so a caller reading the page's own summary line would be misled on every row. Returns SOLD-OUT models too, flagged `inStock: false` — half the line was sold out when measured, so dropping them would hide half the catalogue; filter on `inStock` for the ship-now set. THROWS rather than returning [] when the page answers without its payload or names nothing.\n\nCalls `bowmark.providers.ibuypower.listLaptops`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<IbuypowerLaptop[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/ibuypower/getSystem":{"post":{"operationId":"getSystem","summary":"Reads one base system's full configurator: every component category (Processor, Video Card, Memory, Storage, Cooling, Case, Power Supply and the rest), each option with its exact label and signed pric","description":"Reads one base system's full configurator: every component category (Processor, Video Card, Memory, Storage, Cooling, Case, Power Supply and the rest), each option with its exact label and signed price difference versus the default, plus the stock CPU/GPU 3DMark names. Promotional and expedite rows are dropped. A build total is `base.startingPriceValue` plus the chosen options' `priceDifference` — the site's own pricing endpoint answers with the price as an image, so that sum is the only route to it, and it matches the configurator's displayed total exactly. THROWS on an unknown slug, naming the current ones.\n\nCalls `bowmark.providers.ibuypower.getSystem`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<IbuypowerCatalog>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","description":"TypeScript: `string`"}},"required":["slug"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/ibuypower/getBenchmark":{"post":{"operationId":"getBenchmark","summary":"Returns iBUYPOWER's own measured 3DMark Time Spy scores and per-game FPS at 1080p / 1440p / 4K-medium / 4K-ultra for a CPU+GPU pair.","description":"Returns iBUYPOWER's own measured 3DMark Time Spy scores and per-game FPS at 1080p / 1440p / 4K-medium / 4K-ultra for a CPU+GPU pair. Both arguments are `benchName` values off a Processor or Video Card option from getSystem, not free text. Returns NULL when the site has not benchmarked that pair — an ordinary fact about a combination, not a failure; fall back to the Time Spy score of a pair it does have.\n\nCalls `bowmark.providers.ibuypower.getBenchmark`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<IbuypowerBenchmark | null>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cpuBench":{"type":"string","description":"TypeScript: `string`"},"gpuBench":{"type":"string","description":"TypeScript: `string`"}},"required":["cpuBench","gpuBench"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/ibuypower/recommendGamingPc":{"post":{"operationId":"recommendGamingPc","summary":"Recommends buildable PCs at or under budget_max, drawn from BOTH product lines — in-stock RDY prebuilts (their own listed Time Spy score) and base configurators at their stock loadout (priced from get","description":"Recommends buildable PCs at or under budget_max, drawn from BOTH product lines — in-stock RDY prebuilts (their own listed Time Spy score) and base configurators at their stock loadout (priced from getSystem, benchmarked from getBenchmark for the cheapest ~5 affordable ones) — ranked by 3DMark Time Spy score per dollar, best first. `use_case` is accepted but does not change the ranking: iBUYPOWER publishes only one axis of measured performance, and every recommendation is already ranked on it. THROWS when nothing in stock or buildable fits the budget. `warnings` names any configurator that stopped resolving mid-call; it is empty on a healthy call.\n\nCalls `bowmark.providers.ibuypower.recommendGamingPc`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ recommendations: IbuypowerRecommendation[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/IbuypowerRecommendArgs","description":"TypeScript: `IbuypowerRecommendArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"IbuypowerRecommendArgs":{"type":"object","properties":{"budget_max":{"type":"number"},"use_case":{"type":"string"}},"required":["budget_max"],"additionalProperties":true}}}}