--- title: "Search your listings" method: POST path: "/seller/listings/search" tags: ["seller-listings"] --- # Search your listings `POST /seller/listings/search` ## Request - Base URL: `https://api.managem.co.uk` - URL: `https://api.managem.co.uk/seller/listings/search` - Auth: HTTP bearer Search the authenticated seller's listings using full-text query and facets. This endpoint is optimized for seller backoffice listing management views. Search behavior: - Executes against the listings search index with seller-scoped filtering. - The API enforces seller ownership by injecting the authenticated seller facet server-side. - Additional user-provided facets are merged with seller scoping. Response enrichment: - Returns indexed listing hits plus seller-specific metadata from the primary database. - Adds: - `valid` and `hidden` flags from listing records. - `locked` status when active listing holds exist. - `attachments` array with public URLs. Authentication: - Caller must map to an existing seller account. Use this endpoint when you need filterable, paginated, relevance-aware listing search for the current seller. ## Request body - SearchQuery: A search query includes a free text query property, refinements in the form of facets, pagination controls and optional sorting. - `query` string: One or more free text search terms - `filters` object[] - `facets` object: Facets to refine the search results. Values are case-sensitive unless noted otherwise. - `Game` string[]: Game name to match, e.g. Pokemon or Magic - `Product Type` string[]: Type of product, for example "card" or "product" - `Rarity` string[]: Card rarity values - `Series` string[]: Series names - `Set` string[]: Set names - `Illustrator` string[]: Illustrator names as stored on item images - `Condition` string[]: Listing condition codes, e.g. MT, NM - `Grading` string[]: Whether the card is "Graded" or "Ungraded" - `Price` string[]: Price buckets expressed in pounds sterling (inclusive of lower bounds) - `Quantity` string[]: Quantity buckets for available stock - `Valid` string[]: Listing validity status for seller views - `Hidden` string[]: Listing visibility status for seller views - `Availability` string[]: Filter listings or items to only those that are "In Stock" - `Category` string[]: Item categories (metadata) - `from` number, nullable: Offset for pagination - `size` number: Number of results to return - `sorting` object: Sort results by field and order - `field` 'name' | 'number' | 'indexed' | 'price', required - `order` 'asc' | 'desc', required ## Response `200` Seller listings - object: Result of a listings search query - `total` number, required: Total number of results - `hits` object[], required: List of listings - `id` string, required - `sellerId` string, required - `condition` string, required: Product condition - `price` integer, required: Price in pence - `quantity` integer: Total quantity for this listings - `available` integer: Total available for this listing - `language` string, required: Languages of the card - `variants` string[]: Variants of the listed card - `comment` string, nullable: Seller's comment about the listing - `gradingProvider` string, nullable: Provider responsible for grading the card - `gradingScore` string, nullable: Score assigned to the card by the grading provider - `gradingNumber` string, nullable: Certificate or registration number issued by the grading provider - `createdAt` union, required - string - string, date-time - string, date-time - string, date-time - `updatedAt` union, required - string - string, date-time - string, date-time - string, date-time - `item` union, required - object - `urn` string, required - `type` 'card', required - `game` 'Pokemon', required - `title` string, required - `name` string, required - `rarity` string, required - `number` string, nullable - `description` string - `set` object, required - `name` string, required - `size` number - `urn` string, required - `counts` object, required - `printed` number - `total` number - `symbol` object - `url` string, required - `released` string - `references` string[], required - `series` object, required - `name` string, required - `urn` string, required - `images` object[], required - `urn` string, required - `illustrator` string - `orientation` 'portrait' | 'landscape', required - `url` string, uri, required - `alternatives` string[], required - `metadata` object[], required - `name` string, required - `value` union - string - string[] - number - number[] - `detail` union - unknown - unknown[] - … - unknown[] - … - unknown[] - … - `price` integer - `available` integer: Total available for this listing - `quantity` integer: Total quantity available - `min` object - `price` integer, nullable, required: Price of the cheapest listing in pence - `max` object - `price` integer, nullable, required: Price of the most expensive listing in pence - object - `urn` string, required - `type` 'product', required - `game` 'Pokemon', required - `title` string, required - `name` string, required - `classification` 'CARD', required - `count` number, required - `description` string - `images` object[], required - `urn` string, required - `illustrator` string - `orientation` 'portrait' | 'landscape', required - `url` string, uri, required - `series` object, required - `name` string, required - `urn` string, required - `set` object, required - `name` string, required - `size` number - `urn` string, required - `counts` object, required - `printed` number - `total` number - `symbol` object - `url` string, required - `released` string - `references` string[], required - `metadata` object[], required - `name` string, required - `value` union - string - string[] - number - number[] - `detail` union - unknown - unknown[] - … - unknown[] - … - unknown[] - … - `price` integer - `available` integer: Total available for this listing - `quantity` integer: Total quantity available - `min` object - `price` integer, nullable, required: Price of the cheapest listing in pence - `max` object - `price` integer, nullable, required: Price of the most expensive listing in pence - `seller` object, required: Seller of the listing - `id` string, required: Unique identifier for the user - `username` string, required: Public username of the user - `joined` string, date-time: ISO timestamp when the user account was created - `avatar` string, uri: URL to the user's avatar image - `cover` string, uri: URL to the user's cover image - `profile` string: Information about the user - `reviews` integer, required: Total number of reviews the user has received - `rating` number, required: Confidence-based rating between 0 and 5 - `score` number, required: Average rating between 0 and 5 - `sales` integer, required: Total number of sales the user has made - `purchases` integer, required: Total number of purchases the user has made - `locked` boolean, required: True when the listing has active item holds - `attachments` ListingAttachment[]: Image attachments for the listing - `id` string, required: Image identifier - `url` string, uri, required: Public URL for the attachment - `valid` boolean, required: True when the listing meets all requirements - `hidden` boolean, required: True when the listing is hidden from buyers - `notes` string, nullable: Private notes for the seller such as SKUs or storage locations - `reference` string, nullable: Third-party integration reference for this listing - `facets` object, required: Facets that can be applied to further refine the search results ## Other responses - `404`: Seller not found --- [API](https://skmtc.dev/managem/apis/managem-api.md) · [All operations](https://skmtc.dev/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/managem/apis/managem-api/revisions/3a4470b55521?raw)