> ## 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.

# List the Inspiration gallery of published collections

> Returns up to 150 collections that merchants published to the shared Inspiration gallery in the last 30 days, across ALL merchants (the list does not depend on `merchant_id`, which only authorizes the caller). Read-only. Use it to browse examples. The trailing slash in the path is required.



## OpenAPI

````yaml /api-reference/openapi/lite.json get /published-collections/
openapi: 3.1.0
info:
  title: Search & Merchandising API
  version: 1.0.0
  description: >-
    REST API behind Depict: Search & Merchandising, the native Shopify app:
    onboarding, collections, boost & bury, dashboards, A/B testing and
    multi-store management. Endpoints are served under the /api/lite prefix and
    are authenticated with the Shopify session token that App Bridge issues to
    the embedded app.
servers:
  - url: /api/lite
security:
  - ShopifySessionToken: []
paths:
  /published-collections/:
    get:
      summary: List the Inspiration gallery of published collections
      description: >-
        Returns up to 150 collections that merchants published to the shared
        Inspiration gallery in the last 30 days, across ALL merchants (the list
        does not depend on `merchant_id`, which only authorizes the caller).
        Read-only. Use it to browse examples. The trailing slash in the path is
        required.
      operationId: publishedCollectionsList
      parameters:
        - schema:
            type: string
            description: Lite merchant id, e.g. `shopify-<shop id>`.
          required: true
          description: Lite merchant id, e.g. `shopify-<shop id>`.
          name: merchant_id
          in: query
        - schema:
            $ref: '#/components/schemas/PublishedCollectionsSortOrder'
          required: true
          description: >-
            `published_at`: newest first. `popular`: most likes first, newest
            breaking ties.
          name: sort_order
          in: query
      responses:
        '200':
          description: The gallery entries, in the requested order.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LitePublishedCollectionDto'
        '400':
          description: >-
            `merchant_id` or `sort_order` is missing or invalid; `detail`
            carries zod's messages.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '401':
          description: Not authenticated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '403':
          description: Authenticated, but this identity may not call the API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '404':
          description: Merchant not found for this caller.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '500':
          description: Internal error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
components:
  schemas:
    PublishedCollectionsSortOrder:
      type: string
      enum:
        - published_at
        - popular
      description: >-
        `published_at`: newest first. `popular`: most likes first, newest
        breaking ties.
    LitePublishedCollectionDto:
      type: object
      properties:
        merchant_id:
          type: string
          description: The merchant that published it.
        collection_id:
          type: string
          description: Numeric Shopify collection id.
        title:
          type: string
        handle:
          type: string
          description: Shopify collection handle.
        preview_url:
          type: string
          description: Rendered PNG preview of the collection page; empty if none.
        used_features:
          type: array
          items:
            $ref: '#/components/schemas/LiteFeatures'
        likes:
          type: integer
        published_at:
          type: string
          format: date-time
          description: UTC, without an offset suffix.
        merchant_display_name:
          type: string
        shopify_base_url:
          type: string
          description: The store's myshopify domain, without a scheme.
      required:
        - merchant_id
        - collection_id
        - title
        - handle
        - preview_url
        - used_features
        - likes
        - published_at
        - merchant_display_name
        - shopify_base_url
    Detail:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
      description: 'Every 4xx/5xx body: `{detail}`.'
    LiteFeatures:
      type: string
      enum:
        - content_block
        - product_duplicate
        - image_setting
      description: >-
        A portal feature a collection uses: content blocks, duplicated products,
        or per-product image settings.
  securitySchemes:
    ShopifySessionToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Shopify App Bridge session token of the embedded Depict: Search &
        Merchandising app. The shop in the token determines the merchant;
        merchant_id parameters must belong to that shop.

````