Retrieve product listings that are published to your app. Note: As of version 2019-07, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/2020-07/product_listings.json

https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#index-2020-07

Access Token Required: API Key

Query Params

product_idsstring

A comma-separated list of product ids

limitstring

Amount of results (default: 50, maximum: 1000)

collection_idstring

Filter by products belonging to a particular collection

updated_at_minstring

Filter by products last updated after a certain date and time (formatted in ISO 8601)

handlestring

Filter by product handle

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/2020-07/product_listings.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET