Search a seller's listings
curl --request POST \
--url https://api.managem.co.uk/listings/seller/{id} \
--header 'Content-Type: application/json' \
--data '
{
"query": "charizard",
"from": 0,
"size": 20
}
'import requests
url = "https://api.managem.co.uk/listings/seller/{id}"
payload = {
"query": "charizard",
"from": 0,
"size": 20
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({query: 'charizard', from: 0, size: 20})
};
fetch('https://api.managem.co.uk/listings/seller/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.managem.co.uk/listings/seller/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'charizard',
'from' => 0,
'size' => 20
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.managem.co.uk/listings/seller/{id}"
payload := strings.NewReader("{\n \"query\": \"charizard\",\n \"from\": 0,\n \"size\": 20\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.managem.co.uk/listings/seller/{id}")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"charizard\",\n \"from\": 0,\n \"size\": 20\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.managem.co.uk/listings/seller/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"charizard\",\n \"from\": 0,\n \"size\": 20\n}"
response = http.request(request)
puts response.read_body{
"total": 1,
"hits": [
{
"id": "lst_987",
"sellerId": "sel_123",
"condition": "LP",
"price": 4500,
"quantity": 1,
"available": 1,
"language": "English",
"variants": [
"Holo"
],
"createdAt": "2026-03-02T12:00:00.000Z",
"updatedAt": "2026-03-02T12:00:00.000Z",
"item": {
"urn": "urn:managem:pokemon:card/base2/4-charizard",
"type": "card",
"game": "Pokemon",
"title": "Charizard",
"name": "Charizard",
"rarity": "Rare",
"number": "4",
"set": {
"name": "Jungle",
"urn": "urn:managem:pokemon:set/base2",
"counts": {},
"references": []
},
"series": {
"name": "Base",
"urn": "urn:managem:pokemon:series/base"
},
"images": [
{
"urn": "urn:managem:pokemon:image/base2-4",
"orientation": "portrait",
"url": "https://assets.managem.co.uk/images/base2-4.png"
}
],
"alternatives": [],
"metadata": [],
"slug": "/pokemon/card/base2/4-charizard"
},
"seller": {
"id": "usr_222",
"username": "vintagecards",
"avatar": "https://assets.managem.co.uk/avatars/usr_222.png",
"reviews": 87,
"rating": 4.7,
"score": 4.6,
"sales": 302,
"purchases": 41
},
"locked": false,
"attachments": []
}
],
"facets": {
"Condition": {
"LP": 1
}
}
}Listings
Search a seller's listings
Search listings that belong to a specific seller.
Use this endpoint for seller storefront pages, seller profile inventory tabs, and seller-specific search experiences.
Seller targeting:
- The
idpath parameter accepts either a user ID or a username. - Returns
404when the seller cannot be found.
Search behavior:
- Applies your query text/facets plus an enforced filter for that seller.
- Returns only listings with available stock (
available > 0). - Enriches hits with seller profile, listing lock status, and attachment URLs.
Performance:
- Uses short-lived body-signature caching for repeated seller searches.
POST
/
listings
/
seller
/
{id}
Search a seller's listings
curl --request POST \
--url https://api.managem.co.uk/listings/seller/{id} \
--header 'Content-Type: application/json' \
--data '
{
"query": "charizard",
"from": 0,
"size": 20
}
'import requests
url = "https://api.managem.co.uk/listings/seller/{id}"
payload = {
"query": "charizard",
"from": 0,
"size": 20
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({query: 'charizard', from: 0, size: 20})
};
fetch('https://api.managem.co.uk/listings/seller/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.managem.co.uk/listings/seller/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'charizard',
'from' => 0,
'size' => 20
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.managem.co.uk/listings/seller/{id}"
payload := strings.NewReader("{\n \"query\": \"charizard\",\n \"from\": 0,\n \"size\": 20\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.managem.co.uk/listings/seller/{id}")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"charizard\",\n \"from\": 0,\n \"size\": 20\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.managem.co.uk/listings/seller/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"charizard\",\n \"from\": 0,\n \"size\": 20\n}"
response = http.request(request)
puts response.read_body{
"total": 1,
"hits": [
{
"id": "lst_987",
"sellerId": "sel_123",
"condition": "LP",
"price": 4500,
"quantity": 1,
"available": 1,
"language": "English",
"variants": [
"Holo"
],
"createdAt": "2026-03-02T12:00:00.000Z",
"updatedAt": "2026-03-02T12:00:00.000Z",
"item": {
"urn": "urn:managem:pokemon:card/base2/4-charizard",
"type": "card",
"game": "Pokemon",
"title": "Charizard",
"name": "Charizard",
"rarity": "Rare",
"number": "4",
"set": {
"name": "Jungle",
"urn": "urn:managem:pokemon:set/base2",
"counts": {},
"references": []
},
"series": {
"name": "Base",
"urn": "urn:managem:pokemon:series/base"
},
"images": [
{
"urn": "urn:managem:pokemon:image/base2-4",
"orientation": "portrait",
"url": "https://assets.managem.co.uk/images/base2-4.png"
}
],
"alternatives": [],
"metadata": [],
"slug": "/pokemon/card/base2/4-charizard"
},
"seller": {
"id": "usr_222",
"username": "vintagecards",
"avatar": "https://assets.managem.co.uk/avatars/usr_222.png",
"reviews": 87,
"rating": 4.7,
"score": 4.6,
"sales": 302,
"purchases": 41
},
"locked": false,
"attachments": []
}
],
"facets": {
"Condition": {
"LP": 1
}
}
}Path Parameters
User ID or username of the seller
Minimum string length:
1Body
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