> **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):** <https://www.socialfetch.dev/platforms/gumroad/tags>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumroad/tags.mdx>

---

# Gumroad Tags API

Tag names with site-wide use counts, matched by prefix or ranked by use.

`GET /v1/gumroad/tags` takes an optional `query` and answers `{ data, meta }` with `data.lookupStatus` always `found`, `data.query` and `data.tags`. Each tag has `name` and `uses`, the site-wide use count.

The match is a prefix match, not a substring match: `not` finds `notion` but not a tag that merely contains those letters. An empty or omitted `query` returns the most used tags. The list is capped at 10 and sorted by use, so it is a small picker list rather than a full tag index. There is no paging.

## Request

- **Endpoint:** `GET /v1/gumroad/tags`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by tag prefix
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/tags/get)
- **Platform page:** [/platforms/gumroad](https://www.socialfetch.dev/platforms/gumroad)

## FAQ

### Is the match a prefix or a substring?

A prefix. query=not matches tags that start with not, such as notion. It does not match a tag that only contains the letters later in the word.

### What does uses count?

uses is the site-wide number of products that carry the tag. It is the marketplace's count, not a count for one creator or one search.

### Why are there at most 10 tags?

The route returns the top 10 by use, which is the size the product filter needs. Narrow the query if the tag you want is not in the list.

### Can an empty result mean an error?

No. A prefix with no matching tags answers found with an empty tags array. lookupStatus is always found on this route.

### How many credits does a tags 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.