Overview

Get by Name

Looks up one tag in the store catalogue by its unique tag name (for example rock). The response is a single tag record with display names and artwork for each supported language, plus flags for whether the tag is active, public, and system-managed.

Use this when: a screen knows exactly one tag name (from a deep link, breadcrumb, or configured content) and needs its metadata before rendering a tag landing page or calling a related content endpoint. If you already have several names (filter buttons, multi-tag homepage sections), use Get Multiple Tags By Name instead to avoid extra API calls.

Security Model

API Key Authentication

Header Parameters

StoreIdstring Required

API Key provided by Tuned Global for accessing the service

Query Parameters

namestring Required

The name of the tag

Response

200

Object

Response Attributes

TagIdinteger

Stable numeric id for this tag; pass to tag-linked browse and detail endpoints

Namestring

Catalogue key for this tag; use in URLs, query params, and config lookups

Activeboolean

When false, treat the tag as unavailable and hide it from pickers and browse grids

IsPublicboolean

When false, do not show this tag to end users in the current store

IsSystemboolean

When true, the tag is platform-managed and not editable by store administrators

Imagesarray

Cover or icon images for this tag, one entry per supported language

Show child attributes

DisplayNamesarray

Human-readable tag labels for the UI, one entry per supported language

Show child attributes

Sections

Get by Name

Security Model

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Response