curl --request POST \
--url https://api.managem.co.uk/search \
--header 'Content-Type: application/json' \
--data '
{
"query": "pokemon",
"size": 2
}
'{
"total": 4217,
"hits": [
{
"urn": "urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283",
"type": "product",
"game": "Pokemon",
"title": "Miscellaneous: Pokemon Stacking Tin: Paradox Pokemon",
"name": "Pokemon Stacking Tin: Paradox Pokemon",
"classification": "BOX",
"count": 1,
"description": "Stack 'Em High! Choose a tin with powerful Pokemon from Paldea or Kitakami.",
"images": [
{
"urn": "urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283/image/0",
"orientation": "portrait",
"url": "https://images.managem.co.uk/urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283/image/0"
}
],
"series": {
"name": "Miscellaneous",
"urn": "urn:managem:pokemon:series/miscellaneous"
},
"set": {
"name": "Miscellaneous",
"urn": "urn:managem:pokemon:set/miscellaneous",
"counts": {
"printed": 0,
"total": 0
},
"symbol": {
"url": "https://images.managem.co.uk/7722e2a1-df84-41ff-9c0f-41b82b144500"
},
"references": []
},
"available": 0,
"quantity": 0,
"slug": "pokemon/product/miscellaneous/pokemon-stacking-tin-paradox-pokemon-a4cf2283"
}
],
"facets": {
"Game": {
"Pokemon": 4203,
"Magic: The Gathering": 14
},
"Product Type": {
"card": 2589,
"product": 1628
},
"Set": {
"151": 63,
"Miscellaneous": 564,
"Pokemon GO": 125
},
"Availability": {
"In Stock": 120
},
"Price": {
"Under £1": 118,
"£1-£10": 2,
"£10-£20": 0,
"£20-£50": 0,
"£50-£100": 0,
"Over £100": 1
}
}
}Cards & sealed products
Full-text faceted search
This is the main marketplace search endpoint.
Use it for:
- global search bars
- category and filter pages
- any browse/results screen where users need discoverability
Behavior:
- Accepts free-text query, facet filters, sorting, and paging input.
- Returns matching items plus facet aggregations so the UI can render filter chips and counts.
Good to know:
- Results are cached briefly (~30s) for identical request bodies.
- Different JSON bodies generate different cache keys.
POST
/
search
curl --request POST \
--url https://api.managem.co.uk/search \
--header 'Content-Type: application/json' \
--data '
{
"query": "pokemon",
"size": 2
}
'{
"total": 4217,
"hits": [
{
"urn": "urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283",
"type": "product",
"game": "Pokemon",
"title": "Miscellaneous: Pokemon Stacking Tin: Paradox Pokemon",
"name": "Pokemon Stacking Tin: Paradox Pokemon",
"classification": "BOX",
"count": 1,
"description": "Stack 'Em High! Choose a tin with powerful Pokemon from Paldea or Kitakami.",
"images": [
{
"urn": "urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283/image/0",
"orientation": "portrait",
"url": "https://images.managem.co.uk/urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283/image/0"
}
],
"series": {
"name": "Miscellaneous",
"urn": "urn:managem:pokemon:series/miscellaneous"
},
"set": {
"name": "Miscellaneous",
"urn": "urn:managem:pokemon:set/miscellaneous",
"counts": {
"printed": 0,
"total": 0
},
"symbol": {
"url": "https://images.managem.co.uk/7722e2a1-df84-41ff-9c0f-41b82b144500"
},
"references": []
},
"available": 0,
"quantity": 0,
"slug": "pokemon/product/miscellaneous/pokemon-stacking-tin-paradox-pokemon-a4cf2283"
}
],
"facets": {
"Game": {
"Pokemon": 4203,
"Magic: The Gathering": 14
},
"Product Type": {
"card": 2589,
"product": 1628
},
"Set": {
"151": 63,
"Miscellaneous": 564,
"Pokemon GO": 125
},
"Availability": {
"In Stock": 120
},
"Price": {
"Under £1": 118,
"£1-£10": 2,
"£10-£20": 0,
"£20-£50": 0,
"£50-£100": 0,
"Over £100": 1
}
}
}Body
application/json
A search query includes a free text query property, refinements in the form of facets, pagination controls and optional sorting.
One or more free text search terms
Show child attributes
Show child attributes
Facets to refine the search results. Values are case-sensitive unless noted otherwise.
Show child attributes
Show child attributes
Offset for pagination
Number of results to return
Required range:
1 <= x <= 50Sort results by field and order
Show child attributes
Show child attributes