{"openapi":"3.1.0","info":{"title":"Abercrombie & Fitch API (Bowmark)","version":"186fdf3b86f9","description":"Abercrombie & Fitch's own storefront — product search, product detail, size/store stock, store locator, current deals and gift card balance.\n\nEvery function Bowmark has for Abercrombie & Fitch (abercrombie.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/abercrombie/getProduct":{"post":{"operationId":"getProduct","summary":"Reads one Abercrombie & Fitch product in full, the way its own product page does — pass the product `url` or the bare `id` from the end of one.","description":"Reads one Abercrombie & Fitch product in full, the way its own product page does — pass the product `url` or the bare `id` from the end of one. Returns the name, the site's fabric label and fit copy, the long description, the current price RANGE across that colourway's size SKUs with the pre-markdown `listPrice` range and an `onSale` flag derived from the split, the schema.org availability, star rating and review count, the full image set, the product's breadcrumb trail, EVERY colourway of the same style (each with its own id and URL, the requested one marked `selected`), and the size tiles the page asks a shopper to pick — one group per dimension the site names itself (\"Waist\" and \"Length\" on jeans, \"Size\" on a tee), each option carrying the site's own `available` mark. **Size availability is per COLOURWAY, not per store**: it says the tile cannot be bought online right now, and is not an inventory count — store-level stock is this provider's separate `checkStock`. **`skus` is the per-size answer**: one row per size with its own `available`, `quantity`, `price` and `listPrice`. Read it for a waist-and-length combination — the `sizes` tiles light a value if ANY size with it is in stock, so lit \"32\" and lit \"30\" do not mean 32x30 is. Pass the `url` of a search card unchanged: its `?seq=` opens the colour the card showed, and the returned `id` is the id of that COLOURWAY, which can differ from the id in the url. A product id the page does not carry THROWS rather than returning an empty product, and a 200 that has lost its inline catalog THROWS too — a re-skin must never reach a caller as a product with no colours.\n\nCalls `bowmark.providers.abercrombie.getProduct`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<abercrombieProduct>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/abercrombieProductQuery","description":"TypeScript: `abercrombieProductQuery`"}},"required":["query"],"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/abercrombie/findStores":{"post":{"operationId":"findStores","summary":"Finds physical Abercrombie/abercrombie kids stores near a location, the way the site's own \"Find Your Store\" locator does.","description":"Finds physical Abercrombie/abercrombie kids stores near a location, the way the site's own \"Find Your Store\" locator does. Pass EITHER `zip` (a 5-digit US zip) OR `city`+`state` (the two-letter abbreviation) — never both. Returns each store's name, street address, city/state/zip, phone, exact coordinates and its currently published weekly hours (Sunday-first, `open`/`close` both null on a day the store is closed). `brand` filters to `\"adult\"` (Abercrombie & Fitch) or `\"kids\"` (abercrombie kids); default `\"both\"`. `radiusMiles` (default 25, site ceiling 500) and `maxItems` (default 10, site ceiling 50) bound the search the same way the site's own widget does. **Geocoding is OURS, not the site's**: the site's own search endpoint takes only latitude/longitude (or a bare country), so this function resolves `zip`/`city`+`state` to a point with a keyless third-party geocoder before calling it — a city with multiple zips is resolved to their centroid, not to whichever zip a lookup happens to list first. An empty result is a genuine \"nothing within radius\", never an error.\n\nCalls `bowmark.providers.abercrombie.findStores`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<abercrombieStore[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/abercrombieStoreQuery","description":"TypeScript: `abercrombieStoreQuery`"}},"required":["query"],"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/abercrombie/checkStock":{"post":{"operationId":"checkStock","summary":"Answers whether ONE size of ONE colourway is buyable RIGHT NOW — online, and at the stores near a place you name.","description":"Answers whether ONE size of ONE colourway is buyable RIGHT NOW — online, and at the stores near a place you name. Identify the product with `url` or `id`, then the size with either `size` (the site's own label, e.g. \"32 X Regular\" or \"M\"), or `sizePrimary`+`sizeSecondary`, or a `sku` you already hold. Add `zip` OR `city`+`state` to also get per-store stock; omit all three and `stores` comes back `null` — \"you did not ask\", which is deliberately distinct from `[]`, \"asked, and no store nearby carries it\". Returns the resolved `sku`, the size and its dimension names, the online answer (`inStockOnline`, a real `onlineQuantity` — the site publishes counts like 305, not a flag — the site's own `onlineStatus` word, `preorderEligible`, price/listPrice/onSale), whether the colourway is eligible for the site's find-in-store and pick-up-in-store journeys at all, and one row per nearby store carrying that store's full record plus its `inventoryStatus`, `availableQuantity`, `inStock` and the date it expects the item. **`inStock` is the strict question and is NOT `status !== \"Unavailable\"`**: the site's commonest store answer is `Backorderable` with quantity 0, which means \"we will order it for you\", not \"it is on the shelf\" — so `inStock` is true only for `Available` WITH a quantity above zero. **An ambiguous size THROWS rather than guessing**: \"26\" names three lengths on a jean, and answering for one of them would be a wrong answer on a 200. A `sku` is looked up across the whole style and answers for the colourway it really belongs to, not the one in the url. This is the per-SIZE, per-STORE question; `getProduct` answers the different one of what sizes and colours a style comes in.\n\nCalls `bowmark.providers.abercrombie.checkStock`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<abercrombieStock>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/abercrombieStockQuery","description":"TypeScript: `abercrombieStockQuery`"}},"required":["query"],"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/abercrombie/search":{"post":{"operationId":"search","summary":"Searches or browses Abercrombie's live catalog the way the site's own search bar and category navigation do.","description":"Searches or browses Abercrombie's live catalog the way the site's own search bar and category navigation do. Pass EITHER `query` (free text, e.g. \"wide leg jeans\") OR `category` (a category/collection — the site's own URL for it, or the bare slug at the end of one, e.g. \"womens-bottoms-classic-jeans-jeans\") — never both. Returns each result's name, url and current `price`, plus `listPrice`/`onSale` when the card itself shows a markdown, in the site's own default order (best-match for a text search, curated for a category) — never re-sorted. **`thumbnail` is `null` on most rows past the first screen**: the grid lazy-loads images client-side and the server-rendered page carries only a placeholder there, which this function reports honestly rather than guessing a URL. `maxItems` (default 24, ceiling 90) caps the rows; this reads the FIRST page only, same as `findStores` does not walk every radius. A `category` slug the site does not recognize THROWS the same way a bad product id does on `getProduct` — it is not a valid \"zero results\".\n\nCalls `bowmark.providers.abercrombie.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<abercrombieSearchResult[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/abercrombieSearchQuery","description":"TypeScript: `abercrombieSearchQuery`"}},"required":["query"],"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}}},"abercrombieProductQuery":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"}},"additionalProperties":true},"abercrombieSearchQuery":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"maxItems":{"type":"number"},"start":{"type":"number"}},"additionalProperties":true},"abercrombieStockQuery":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"},"size":{"type":"string"},"sizePrimary":{"type":"string"},"sizeSecondary":{"type":"string"},"sku":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"radiusMiles":{"type":"number"},"maxStores":{"type":"number"},"brand":{"anyOf":[{"const":"adult"},{"const":"kids"},{"const":"both"}]}},"additionalProperties":true},"abercrombieStoreQuery":{"type":"object","properties":{"zip":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"radiusMiles":{"type":"number"},"maxItems":{"type":"number"},"brand":{"anyOf":[{"const":"adult"},{"const":"kids"},{"const":"both"}]}},"additionalProperties":true}}}}