Stan Store hub

Stan Store Creators API

A paginated directory of creator handles and profile URLs, with a stable cursor.

GET /v1/stan-store/creators

1 credit Failed requests are free

About this endpoint

GET /v1/stan-store/creators returns creators[] with handle, profileUrl and productPageCount, plus page.hasMore and page.nextCursor.

Optional filters are prefix (case-insensitive handle start), hasProducts (true or false) and limit (1 to 1000, default 100). The cursor stays bound to the filters it was issued with: change prefix or hasProducts and start again without a cursor. With prefix or hasProducts, a page can hold no creators while page.hasMore is true; keep following nextCursor. Each page is one request and one credit. productPageCount counts the creator's product-page URLs. It is null when a page boundary splits the creator's block and the count is incomplete; a null count never matches hasProducts=false.

Stan Store Creators API FAQ

How do I page through the directory?

Read page.nextCursor while page.hasMore is true and send it back as the cursor query parameter. Keep the same prefix and hasProducts filters. When page.hasMore is false, page.nextCursor is null and the directory has no more pages.

Why can a filtered 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.

What do prefix and hasProducts filter?

prefix matches the start of the handle, case-insensitively, for example Al. hasProducts=true returns only creators with at least one product page. Both are optional.

What does productPageCount count?

It counts the creator's product-page URLs. A null value means a page boundary split the creator's block, so the count is incomplete; it is not zero. Use the creator route for the authoritative store list.

How many credits does a directory page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.