Skip to main content
GET
/
v3
/
listings
Get Listings
curl --request GET \
  --url 'https://api.example.com/v3/listings?api_key='
[
  {
    "listing_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "listing_type": "long_tail_collection",
    "show_in_breadcrumbs": true,
    "show_in_quicklinks": true,
    "image_urls": [
      "<string>"
    ],
    "title": "<string>",
    "children": "<array>",
    "external_id": "<string>",
    "slug": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.depict.ai/llms.txt

Use this file to discover all available pages before exploring further.

This page does not apply to installs made in 2025 or later of the Depict Shopify apps

Authorizations

​
api_key
string
query
required

Query Parameters

​
merchant
string
required
​
market
string
required
​
locale
string
required
​
types
enum<string>[]
Available options:
long_tail_collection,
campaign,
category,
smart_pick,
style,
brand

Response

Successful Response

​
listing_id
string<uuid>
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
​
children
Children · array
required
​
external_id
string | null

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

​
slug
string | null