GET
/
v3
/
listings
/
external_id
/
{external_id}
{
  "listing_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "external_id": "<string>",
  "listing_type": "long_tail_collection",
  "show_in_breadcrumbs": true,
  "show_in_quicklinks": true,
  "image_urls": [
    "<string>"
  ],
  "title": "<string>",
  "slug": "<string>",
  "ancestors": [
    {
      "listing_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_id": "<string>",
      "listing_type": "long_tail_collection",
      "show_in_breadcrumbs": true,
      "show_in_quicklinks": true,
      "image_urls": [
        "<string>"
      ],
      "title": "<string>",
      "slug": "<string>"
    }
  ],
  "siblings": [
    {
      "listing_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_id": "<string>",
      "listing_type": "long_tail_collection",
      "show_in_breadcrumbs": true,
      "show_in_quicklinks": true,
      "image_urls": [
        "<string>"
      ],
      "title": "<string>",
      "slug": "<string>"
    }
  ],
  "children": [
    {
      "listing_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_id": "<string>",
      "listing_type": "long_tail_collection",
      "show_in_breadcrumbs": true,
      "show_in_quicklinks": true,
      "image_urls": [
        "<string>"
      ],
      "title": "<string>",
      "slug": "<string>"
    }
  ]
}

Authorizations

​
api_key
string
query
required

Path Parameters

​
external_id
string | null
required

Query Parameters

​
merchant
string
required
​
market
string
required
​
locale
string
required
​
listing_id
string | null
​
session_id
string
default:

Response

200
application/json
Successful Response
​
listing_id
string
required

Depict ID of the listing.

​
listing_type
enum<string>
required
Available options:
long_tail_collection,
campaign,
category,
smart_pick,
style,
brand
​
show_in_breadcrumbs
boolean
required

Show or hide this listing in navigation breadcrumbs.

​
show_in_quicklinks
boolean
required

Show or hide this listing in quicklinks.

​
image_urls
string[]
required

List of image URLs for the listing.

​
title
string
required
​
ancestors
object[]
required

Ordered list of ancestors of the listing, useful for navigation breadcrumbs. The first element is the root listing.

Represents a product listing, e.g. a category or a collection.

​
siblings
object[]
required

Siblings of the listing, i.e. listings that share the same parent, INCLUDING the listing itself. Sortet by title.

Represents a product listing, e.g. a category or a collection.

​
children
object[]
required

Children of the listing, i.e. listings that have the listing as their parent. Sorted by title.

Represents a product listing, e.g. a category or a collection.

​
external_id
string | null

ID of the listing in the merchant PIM, CMS or similar.

​
slug
string | null

Was this page helpful?