Skip to content
Revadike edited this page Oct 16, 2026 · 1 revision

POST /tagdata/tagapp

Applies, updates, or removes the authenticated user's tag on a Steam app.

Rate limits

No known rate limit

Request

Authenticated: Yes

Method: POST

Host: store.steampowered.com

Path: /tagdata/tagapp

Form Data:

Name Type Required Description
appid number Yes The Steam AppID
sessionid string Yes The value of the sessionid cookie
tag string Yes The tag name
tagid number No The tag ID. Sent when applying an existing tag instead of a new name.
weight number No The weight of the user's tag vote
withdraw number No When 1, removes the tag (or report) instead of applying it
reporttype number No The report action: 2 reports the tag, -1 bans the tag (developer/staff only)
applytochildren number No When 1, also applies the action to child DLC of the app
unban number No When 1, unbans the tag instead of banning it

Response

200 OK

Name Type Description
tagid number The tag ID
name string The name of the tag
weight number The weight of the user's tag vote
withdraw number 1 when the tag was withdrawn (removed) instead of applied
reported number 1 when the tag was reported
is_reported number 1 when the current user has reported the tag
browseable boolean Whether enough items have the tag for it to be browsable
count number The number of items with the tag

404 Not Found

The response body is null when required fields are missing or the AppID is invalid.

Example

POST https://store.steampowered.com/tagdata/tagapp { appid: 0, tag: "zzztest", sessionid: "a0b1c2d3e4f5g6h7i8j9klmn" }
null

Clone this wiki locally