Sign in

v14

OpenAPI 3.1.02026-08-03122113375.9 KB
search

Hierarchy by product

Search within a specific type node under a game and set.

Use this for focused views like:

  • cards-only in a set
  • products-only in a set
  • any browse page scoped to game + set + type

Behavior:

  • Resolves {game}, {set}, and {type} slugs in the hierarchy.
  • Merges hierarchy facets with request-body filters.
  • Returns standard search results within that narrowed scope.

Failure behavior:

  • Returns 404 when no matching type exists for the selected game/set path.
post/search/hierarchy/{game}/{set}/{type}

Path parameters

gamestring required

The slug of the game to retrieve results for

Example:pokemon

The slug of the game to retrieve results for

setstring required

The slug of the set to retrieve results for

Example:base-set

The slug of the set to retrieve results for

typestring required

The slug of the type to retrieve results for

Example:card

The slug of the type to retrieve results for

Request body

querystring

One or more free text search terms

filtersobject[]
fromnumber nullable

Offset for pagination

sizenumber

Number of results to return

Response

Results for the matching type

totalnumber required
facetsobject required