GET
/
v3
/
listings
/
{listing_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>"
    }
  ],
  "content_blocks": [
    {
      "span_columns": 123,
      "span_rows": 123,
      "position": "left",
      "row": 123,
      "content": {
        "type": "image",
        "url": "<string>",
        "link": "<string>"
      }
    }
  ]
}

Path Parameters

listing_id
string | null
required

Query Parameters

merchant
string
required
market
string
required
locale
string
required
external_id
string | null
session_id
string
default:

Response

200 - application/json
listing_id
string
required

Depict ID of the listing.

external_id
string | null

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

listing_type
enum<string>
required
Available options:
long_tail_collection,
campaign,
category,
smart_pick,
style,
brand,
look
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
slug
string | null
ancestors
object[]
required

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

siblings
object[]
required

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

children
object[]
required

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

content_blocks
object[]
required

List of content blocks to be displayed on the listing page. If none no content blocks should be displayed.