Shopify API — Listings

naftiko: 1.0.0-alpha2
info:
  label: Shopify  API — Listings
  description: 'Shopify  API — Listings. 9 operations. Lead operation: Shopify Retrieve Collection Listings That Are Published
    To Your App. Self-contained Naftiko capability covering one Shopify business surface.'
  tags:
  - Shopify
  - Listings
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SHOPIFY_API_KEY: SHOPIFY_API_KEY
capability:
  consumes:
  - type: http
    namespace: shopify-listings
    baseUri: ''
    description: Shopify  API — Listings business capability. Self-contained, no shared references.
    resources:
    - name: admin-api-2020-01-collection_listings.json
      path: /admin/api/2020-01/collection_listings.json
      operations:
      - name: deprecated202001getcollectionlistings
        method: GET
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: Amount of results
    - name: admin-api-2020-01-product_listings.json
      path: /admin/api/2020-01/product_listings.json
      operations:
      - name: deprecated202001getproductlistings
        method: GET
        description: Shopify Retrieve Product Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: product_ids
          in: query
          type: string
          description: A comma-separated list of product ids
        - name: limit
          in: query
          type: string
          description: Amount of results
        - name: collection_id
          in: query
          type: string
          description: Filter by products belonging to a particular collection
        - name: updated_at_min
          in: query
          type: string
          description: Filter by products last updated after a certain date and time (formatted in ISO 8601)
        - name: handle
          in: query
          type: string
          description: Filter by product handle
    - name: admin-api-2020-04-collection_listings.json
      path: /admin/api/2020-04/collection_listings.json
      operations:
      - name: deprecated202004getcollectionlistings
        method: GET
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: Amount of results
    - name: admin-api-2020-04-product_listings.json
      path: /admin/api/2020-04/product_listings.json
      operations:
      - name: deprecated202004getproductlistings
        method: GET
        description: Shopify Retrieve Product Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: product_ids
          in: query
          type: string
          description: A comma-separated list of product ids
        - name: limit
          in: query
          type: string
          description: Amount of results
        - name: collection_id
          in: query
          type: string
          description: Filter by products belonging to a particular collection
        - name: updated_at_min
          in: query
          type: string
          description: Filter by products last updated after a certain date and time (formatted in ISO 8601)
        - name: handle
          in: query
          type: string
          description: Filter by product handle
    - name: admin-api-2020-07-collection_listings.json
      path: /admin/api/2020-07/collection_listings.json
      operations:
      - name: deprecated202007getcollectionlistings
        method: GET
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: Amount of results
    - name: admin-api-2020-07-product_listings.json
      path: /admin/api/2020-07/product_listings.json
      operations:
      - name: deprecated202007getproductlistings
        method: GET
        description: Shopify Retrieve Product Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: product_ids
          in: query
          type: string
          description: A comma-separated list of product ids
        - name: limit
          in: query
          type: string
          description: Amount of results
        - name: collection_id
          in: query
          type: string
          description: Filter by products belonging to a particular collection
        - name: updated_at_min
          in: query
          type: string
          description: Filter by products last updated after a certain date and time (formatted in ISO 8601)
        - name: handle
          in: query
          type: string
          description: Filter by product handle
    - name: admin-api-2020-10-collection_listings.json
      path: /admin/api/2020-10/collection_listings.json
      operations:
      - name: getcollectionlistings
        method: GET
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: Amount of results
    - name: admin-api-2021-01-collection_listings.json
      path: /admin/api/2021-01/collection_listings.json
      operations:
      - name: deprecated202101getcollectionlistings
        method: GET
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: Amount of results
    - name: admin-api-unstable-collection_listings.json
      path: /admin/api/unstable/collection_listings.json
      operations:
      - name: deprecatedunstablegetcollectionlistings
        method: GET
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: Amount of results
  exposes:
  - type: rest
    namespace: shopify-listings-rest
    port: 8080
    description: REST adapter for Shopify  API — Listings. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/admin/api/2020-01/collection-listings-json
      name: admin-api-2020-01-collection-listings-json
      description: REST surface for admin-api-2020-01-collection_listings.json.
      operations:
      - method: GET
        name: deprecated202001getcollectionlistings
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        call: shopify-listings.deprecated202001getcollectionlistings
        with:
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-01/product-listings-json
      name: admin-api-2020-01-product-listings-json
      description: REST surface for admin-api-2020-01-product_listings.json.
      operations:
      - method: GET
        name: deprecated202001getproductlistings
        description: Shopify Retrieve Product Listings That Are Published To Your App
        call: shopify-listings.deprecated202001getproductlistings
        with:
          product_ids: rest.product_ids
          limit: rest.limit
          collection_id: rest.collection_id
          updated_at_min: rest.updated_at_min
          handle: rest.handle
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-04/collection-listings-json
      name: admin-api-2020-04-collection-listings-json
      description: REST surface for admin-api-2020-04-collection_listings.json.
      operations:
      - method: GET
        name: deprecated202004getcollectionlistings
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        call: shopify-listings.deprecated202004getcollectionlistings
        with:
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-04/product-listings-json
      name: admin-api-2020-04-product-listings-json
      description: REST surface for admin-api-2020-04-product_listings.json.
      operations:
      - method: GET
        name: deprecated202004getproductlistings
        description: Shopify Retrieve Product Listings That Are Published To Your App
        call: shopify-listings.deprecated202004getproductlistings
        with:
          product_ids: rest.product_ids
          limit: rest.limit
          collection_id: rest.collection_id
          updated_at_min: rest.updated_at_min
          handle: rest.handle
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-07/collection-listings-json
      name: admin-api-2020-07-collection-listings-json
      description: REST surface for admin-api-2020-07-collection_listings.json.
      operations:
      - method: GET
        name: deprecated202007getcollectionlistings
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        call: shopify-listings.deprecated202007getcollectionlistings
        with:
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-07/product-listings-json
      name: admin-api-2020-07-product-listings-json
      description: REST surface for admin-api-2020-07-product_listings.json.
      operations:
      - method: GET
        name: deprecated202007getproductlistings
        description: Shopify Retrieve Product Listings That Are Published To Your App
        call: shopify-listings.deprecated202007getproductlistings
        with:
          product_ids: rest.product_ids
          limit: rest.limit
          collection_id: rest.collection_id
          updated_at_min: rest.updated_at_min
          handle: rest.handle
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-10/collection-listings-json
      name: admin-api-2020-10-collection-listings-json
      description: REST surface for admin-api-2020-10-collection_listings.json.
      operations:
      - method: GET
        name: getcollectionlistings
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        call: shopify-listings.getcollectionlistings
        with:
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2021-01/collection-listings-json
      name: admin-api-2021-01-collection-listings-json
      description: REST surface for admin-api-2021-01-collection_listings.json.
      operations:
      - method: GET
        name: deprecated202101getcollectionlistings
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        call: shopify-listings.deprecated202101getcollectionlistings
        with:
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/unstable/collection-listings-json
      name: admin-api-unstable-collection-listings-json
      description: REST surface for admin-api-unstable-collection_listings.json.
      operations:
      - method: GET
        name: deprecatedunstablegetcollectionlistings
        description: Shopify Retrieve Collection Listings That Are Published To Your App
        call: shopify-listings.deprecatedunstablegetcollectionlistings
        with:
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: shopify-listings-mcp
    port: 9090
    transport: http
    description: MCP adapter for Shopify  API — Listings. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: shopify-retrieve-collection-listings-that
      description: Shopify Retrieve Collection Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202001getcollectionlistings
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-product-listings-that
      description: Shopify Retrieve Product Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202001getproductlistings
      with:
        product_ids: tools.product_ids
        limit: tools.limit
        collection_id: tools.collection_id
        updated_at_min: tools.updated_at_min
        handle: tools.handle
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-collection-listings-that-2
      description: Shopify Retrieve Collection Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202004getcollectionlistings
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-product-listings-that-2
      description: Shopify Retrieve Product Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202004getproductlistings
      with:
        product_ids: tools.product_ids
        limit: tools.limit
        collection_id: tools.collection_id
        updated_at_min: tools.updated_at_min
        handle: tools.handle
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-collection-listings-that-3
      description: Shopify Retrieve Collection Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202007getcollectionlistings
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-product-listings-that-3
      description: Shopify Retrieve Product Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202007getproductlistings
      with:
        product_ids: tools.product_ids
        limit: tools.limit
        collection_id: tools.collection_id
        updated_at_min: tools.updated_at_min
        handle: tools.handle
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-collection-listings-that-4
      description: Shopify Retrieve Collection Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.getcollectionlistings
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-collection-listings-that-5
      description: Shopify Retrieve Collection Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecated202101getcollectionlistings
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieve-collection-listings-that-6
      description: Shopify Retrieve Collection Listings That Are Published To Your App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-listings.deprecatedunstablegetcollectionlistings
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.