Shopify API — Smart

naftiko: 1.0.0-alpha2
info:
  label: Shopify  API — Smart
  description: 'Shopify  API — Smart. 42 operations. Lead operation: Shopify Retrieves A List Of Smart Collections. Self-contained
    Naftiko capability covering one Shopify business surface.'
  tags:
  - Shopify
  - Smart
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SHOPIFY_API_KEY: SHOPIFY_API_KEY
capability:
  consumes:
  - type: http
    namespace: shopify-smart
    baseUri: ''
    description: Shopify  API — Smart business capability. Self-contained, no shared references.
    resources:
    - name: admin-api-2020-01-smart_collections.json
      path: /admin/api/2020-01/smart_collections.json
      operations:
      - name: deprecated202001getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: deprecated202001createsmartcollections
        method: POST
        description: Shopify Creates A New Smart Collection Using The Specified Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-01-smart_collections-count.json
      path: /admin/api/2020-01/smart_collections/count.json
      operations:
      - name: deprecated202001getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-01-smart_collections-smart_collection_id}.json
      path: /admin/api/2020-01/smart_collections/{smart_collection_id}.json
      operations:
      - name: deprecated202001getsmartcollectionsparamsmartcollectionid
        method: GET
        description: Shopify Retrieves A Single Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: deprecated202001updatesmartcollectionsparamsmartcollectionid
        method: PUT
        description: Shopify Updates An Existing Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202001deletesmartcollectionsparamsmartcollectionid
        method: DELETE
        description: Shopify Removes A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
    - name: admin-api-2020-01-smart_collections-smart_collection_id-order.json
      path: /admin/api/2020-01/smart_collections/{smart_collection_id}/order.json
      operations:
      - name: deprecated202001updatesmartcollectionsparamsmartcollectionidorder
        method: PUT
        description: Shopify Updates The Ordering Type Of Products In A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: products
          in: query
          type: string
          description: An array of product IDs, in the order that you want them to appear at the top of the collection. When
            products is specified but empty, any previously sorted pro
        - name: sort_order
          in: query
          type: string
          description: The type of sorting to apply. Valid values are listed in the Properties section above.
        - name: products[]
          in: query
          type: integer
          description: products[]
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-04-smart_collections.json
      path: /admin/api/2020-04/smart_collections.json
      operations:
      - name: deprecated202004getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: deprecated202004createsmartcollections
        method: POST
        description: Shopify Creates A New Smart Collection Using The Specified Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-04-smart_collections-count.json
      path: /admin/api/2020-04/smart_collections/count.json
      operations:
      - name: deprecated202004getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-04-smart_collections-smart_collection_id}.json
      path: /admin/api/2020-04/smart_collections/{smart_collection_id}.json
      operations:
      - name: deprecated202004getsmartcollectionsparamsmartcollectionid
        method: GET
        description: Shopify Retrieves A Single Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: deprecated202004updatesmartcollectionsparamsmartcollectionid
        method: PUT
        description: Shopify Updates An Existing Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202004deletesmartcollectionsparamsmartcollectionid
        method: DELETE
        description: Shopify Removes A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
    - name: admin-api-2020-04-smart_collections-smart_collection_id-order.json
      path: /admin/api/2020-04/smart_collections/{smart_collection_id}/order.json
      operations:
      - name: deprecated202004updatesmartcollectionsparamsmartcollectionidorder
        method: PUT
        description: Shopify Updates The Ordering Type Of Products In A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: products
          in: query
          type: string
          description: An array of product IDs, in the order that you want them to appear at the top of the collection. When
            products is specified but empty, any previously sorted pro
        - name: sort_order
          in: query
          type: string
          description: The type of sorting to apply. Valid values are listed in the Properties section above.
        - name: products[]
          in: query
          type: integer
          description: products[]
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-07-smart_collections.json
      path: /admin/api/2020-07/smart_collections.json
      operations:
      - name: deprecated202007getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: deprecated202007createsmartcollections
        method: POST
        description: Shopify Creates A New Smart Collection Using The Specified Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-07-smart_collections-count.json
      path: /admin/api/2020-07/smart_collections/count.json
      operations:
      - name: deprecated202007getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-07-smart_collections-smart_collection_id}.json
      path: /admin/api/2020-07/smart_collections/{smart_collection_id}.json
      operations:
      - name: deprecated202007getsmartcollectionsparamsmartcollectionid
        method: GET
        description: Shopify Retrieves A Single Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: deprecated202007updatesmartcollectionsparamsmartcollectionid
        method: PUT
        description: Shopify Updates An Existing Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202007deletesmartcollectionsparamsmartcollectionid
        method: DELETE
        description: Shopify Removes A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
    - name: admin-api-2020-07-smart_collections-smart_collection_id-order.json
      path: /admin/api/2020-07/smart_collections/{smart_collection_id}/order.json
      operations:
      - name: deprecated202007updatesmartcollectionsparamsmartcollectionidorder
        method: PUT
        description: Shopify Updates The Ordering Type Of Products In A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: products
          in: query
          type: string
          description: An array of product IDs, in the order that you want them to appear at the top of the collection. When
            products is specified but empty, any previously sorted pro
        - name: sort_order
          in: query
          type: string
          description: The type of sorting to apply. Valid values are listed in the Properties section above.
        - name: products[]
          in: query
          type: integer
          description: products[]
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-10-smart_collections.json
      path: /admin/api/2020-10/smart_collections.json
      operations:
      - name: getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: createsmartcollections
        method: POST
        description: Shopify Creates A New Smart Collection Using The Specified Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-10-smart_collections-count.json
      path: /admin/api/2020-10/smart_collections/count.json
      operations:
      - name: getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-10-smart_collections-smart_collection_id}.json
      path: /admin/api/2020-10/smart_collections/{smart_collection_id}.json
      operations:
      - name: getsmartcollectionsparamsmartcollectionid
        method: GET
        description: Shopify Retrieves A Single Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
      - name: updatesmartcollectionsparamsmartcollectionid
        method: PUT
        description: Shopify Updates An Existing Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deletesmartcollectionsparamsmartcollectionid
        method: DELETE
        description: Shopify Removes A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
    - name: admin-api-2020-10-smart_collections-smart_collection_id-order.json
      path: /admin/api/2020-10/smart_collections/{smart_collection_id}/order.json
      operations:
      - name: updatesmartcollectionsparamsmartcollectionidorder
        method: PUT
        description: Shopify Updates The Ordering Type Of Products In A Smart Collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: smart_collection_id
          in: path
          type: string
          description: smart_collection_id
          required: true
        - name: products
          in: query
          type: string
          description: An array of product IDs, in the order that you want them to appear at the top of the collection. When
            products is specified but empty, any previously sorted pro
        - name: sort_order
          in: query
          type: string
          description: The type of sorting to apply. Valid values are listed in the Properties section above.
        - name: products[]
          in: query
          type: integer
          description: products[]
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2021-01-smart_collections.json
      path: /admin/api/2021-01/smart_collections.json
      operations:
      - name: deprecated202101getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:

# --- truncated at 32 KB (92 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/shopify/refs/heads/main/capabilities/shopify-smart.yaml