> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt). ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** --- # Stan Store API. Creator stores as JSON. Creator profiles, every listed product, booking availability and the creator directory, returned in one typed contract. Name a handle and get JSON. - Creator profiles - Products + booking - 1 credit per request Stan Store storefronts mix a creator profile, a list of products and optional booking pages. Social Fetch exposes five routes under `/v1/stan-store`: one creator profile, that creator's listed products, one product in full, that product's availability, and a creator directory. The creator route returns `profile` (`handle`, `displayName`, `bio`, `avatarUrl`, `profileUrl`, `verified`), `socials`, `paymentMethods`, `language`, `currency`, `termsText`, `storeId`, `storeName`, `sections` and `products`. `verified` is always null: Stan Store has no verification mark. The product list returns `products` and `productPageCount`. The single product route adds `price`, `descriptionLinks`, `descriptionImages`, `inventory`, `questions`, `reviews`, `course`, `meeting`, `webinar`, `upsell`, `affiliate`, `communityEnabled` and the call-to-action fields. Availability answers with `kind` (`meeting`, `webinar` or `none`), `timezone`, `startDate`, `endDate`, `slots` and `sessions`. The directory pages with `page.nextCursor`. Every route returns HTTP 200 for found and not found, so branch on `lookupStatus`. `createdAt` and `updatedAt` are null when a storefront does not supply them. ## What you can get - One creator's profile, social links, connected payment methods, store sections and every listed product. - Listed products in store order, with `productPageCount` and every description link and image kept alongside the text. - Full product detail: price and currency, inventory, checkout questions, reviews, course outline, meeting or webinar settings, upsell and affiliate terms. - Free meeting slots and upcoming webinar sessions, with `availableSeats` and `bookedSeats` when the product books sessions. - A creator directory, filterable by handle prefix and by whether a creator has product pages. - Typed `not_found` outcomes with a `reason` when the storefront distinguishes a deleted store from a handle that never existed. ## Stan Store endpoints | Endpoint | Request | Credits | Docs | | --- | --- | --- | --- | | Creator | GET /v1/stan-store/creators/{handle} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/stan-store/creators/handle/get) | | Creators | GET /v1/stan-store/creators | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/stan-store/creators/get) | | Products | GET /v1/stan-store/creators/{handle}/products | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/stan-store/creators/handle/products/get) | | Product | GET /v1/stan-store/creators/{handle}/products/{slug} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/stan-store/creators/handle/products/slug/get) | | Availability | GET /v1/stan-store/creators/{handle}/products/{slug}/availability | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/stan-store/creators/handle/products/slug/availability/get) | ## How to start 1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try all five Stan Store routes on a few stores. 2. **Pick the route.** Use `GET /v1/stan-store/creators/{handle}` for a profile, `GET /v1/stan-store/creators/{handle}/products` for the store list, `GET /v1/stan-store/creators/{handle}/products/{slug}` for one product, and add `/availability` for slots or sessions. Send `x-api-key` on every request. 3. **Branch and page.** Check `data.lookupStatus` before storing a row. For the directory, keep the same `prefix` and `hasProducts` filters and pass `page.nextCursor` back as `cursor` while `page.hasMore` is true. ## Pricing Each Stan Store route costs 1 credit per completed request. A directory page is one request, and `limit` controls how many creators that request returns, not how many credits it costs. Credits never expire on pay-as-you-go packs. `meta.creditsCharged` on every response is the billing source of truth. ## Compared with the official API Stan Store does not publish a developer API for creator storefronts. Creator and product details are public on the storefront, and booking availability is part of the same public experience. Social Fetch turns that into one JSON contract: the same field names across every creator, typed `not_found` outcomes, booking slots and sessions in one shape, and a directory endpoint for discovery. ## FAQ ### What can I get from a Stan Store creator? Call GET /v1/stan-store/creators/{handle}. A found response carries profile (handle, displayName, bio, avatarUrl, profileUrl, verified), socials, paymentMethods, language, currency, termsText, storeId, storeName, sections and products. The products array is every page the creator lists, in store order. ### How do I look up one product? Use GET /v1/stan-store/creators/{handle}/products/{slug}. The slug is the last path segment of the product page, for example the-financial-selfcare-experience--audio-series. On found, data.product carries the full record including price, inventory, questions, reviews, course, meeting, webinar, upsell and affiliate. On not_found, data.product is null. ### Does the creator directory cover every Stan Store creator? GET /v1/stan-store/creators returns one page of creators with handle, profileUrl and productPageCount, plus page.hasMore and page.nextCursor. productPageCount is the number of product-page URLs for that creator; it is null when a page boundary splits the creator's block and the count is incomplete. A null count never matches hasProducts=false. ### Why can a filtered directory page be empty? A prefix or hasProducts match can sit on a later page, so creators can be empty while page.hasMore is true. Follow page.nextCursor until the match appears or page.hasMore is false. Each page is one request and one credit. ### Does the products list include every product page that exists? No. GET /v1/stan-store/creators/{handle}/products lists the products the creator shows on the store page. A product page can exist without being shown there, and those pages are not included in products or in productPageCount. includesUnlisted is always false to make that scope explicit. If you already have a slug for one of those pages, the product route still reads it. ### Why is listed null on a product? listed is true or false when the product can be compared with the creator's listed store, and null when that comparison could not be completed. A null value is unknown, not proof that the product is unlisted. ### How do meeting slots and webinar sessions work? Call GET /v1/stan-store/creators/{handle}/products/{slug}/availability with optional timezone, startDate and endDate query parameters. The default window is the next 14 days in the requested timezone, capped by the product's booking window, and an endDate earlier than startDate is a 400. A meeting returns kind meeting and slots with start and end. A webinar returns kind webinar and sessions with start, end, timezone, availableSeats and bookedSeats. A product that takes no bookings returns kind none with empty slots and sessions. A found meeting can still have zero free slots in the requested window. ### What does lookupStatus mean on these routes? HTTP 200 means the request finished. data.lookupStatus tells you what it found. found means the creator, product or booking answer was returned. not_found means it was not. On a product availability miss, product can still be present when the product exists but its booking details do not, so check kind and the arrays as well as lookupStatus. ### When is reason deleted or never_existed? reason is set on a not_found creator when the storefront distinguishes a deactivated store from a handle that never existed. It is null when the answer does not make that distinction. Do not treat a null reason as found. ### Are createdAt and updatedAt always present? No. Product createdAt and updatedAt are ISO 8601 strings when the storefront supplies them and null otherwise. Price fields are also nullable: amount is null when no price is shown, and 0 means free. ### Whose currency is in a product price? product.price.currency is the creator's display currency, the same currency the storefront uses for that creator's prices. The creator-level currency is the same value. ### How much does the Stan Store API cost? Every Stan Store route costs 1 credit per completed request, including each page of the creator directory. Check meta.creditsCharged on every response. New accounts start with 100 free credits, and pay-as-you-go credits do not expire. ### Can I use Stan Store data from MCP or Ask AI? Yes. Every Stan Store route is available as a typed MCP tool and through Ask (POST /v1/ask) in plain English. The REST routes are the better choice for scheduled production jobs and for exact field control. ## Related - [Stan Store Creator API](https://www.socialfetch.dev/platforms/stan-store/creators-handle): Profile, socials, sections and every listed product (`GET /v1/stan-store/creators/{handle}`). - [Stan Store Product API](https://www.socialfetch.dev/platforms/stan-store/creators-handle-products-slug): One product in full, with price, reviews, questions and booking settings (`GET /v1/stan-store/creators/{handle}/products/{slug}`). - [Stan Store Availability API](https://www.socialfetch.dev/platforms/stan-store/creators-handle-products-slug-availability): Free meeting slots and webinar sessions with seat counts (`GET /v1/stan-store/creators/{handle}/products/{slug}/availability`). - [Stan Store Creators API](https://www.socialfetch.dev/platforms/stan-store/creators): The creator directory, one cursor page at a time (`GET /v1/stan-store/creators`). - [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language question about a creator, product or booking window to the matching Stan Store operation. - [Hosted MCP](https://www.socialfetch.dev/mcp): Call the same Stan Store tools from Cursor or Claude with REST credit metering.