Gumroad hub

Gumroad Creator Posts API

Every post title, slug and date a Gumroad creator's profile lists.

GET /v1/gumroad/creator/posts

1 credit Failed requests are free

About this endpoint

GET /v1/gumroad/creator/posts takes creator and answers { data, meta } with data.lookupStatus, data.creator, data.posts and data.truncated. Each post has id, name, slug and publishedAt, newest first.

This is the list the profile itself exposes, not a paged feed. It can lag behind a post's own recent-posts list, so a brand new post can appear on the post route before it appears here. truncated is true when the profile listed more posts than the endpoint returns; the cap is 500. A profile with no posts is a valid found answer with an empty posts array. To read one post in full, pass a slug to the post route. To read comments, use the post id with the post comments route.

Gumroad Creator Posts API FAQ

Is this list paged?

No. It returns the posts the profile exposes in one answer and sets truncated when there were more than the cap. Use the slug with the post route for one post, and the post id with the comments route.

What does each row contain?

id, name, slug and publishedAt. name is the post title. Use slug for a URL and id for the comments route.

Can a creator have no posts?

Yes. A found profile with no posts returns an empty posts array and truncated false. That is a normal answer.

Why is truncated true?

The profile listed more posts than the endpoint returns. The cap is 500, so use the profile's own sections when you need every post beyond that.

Why is a new post missing from the list?

The profile's own posts list can lag behind the recent-posts list on a post. A brand new post can appear on the post route before it appears here, so check the post route when you need the newest one.

How many credits does a creator-posts request 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.