Overview
This node interacts with the Gyazo API to retrieve images from a specified collection. Specifically, the "Get Collection Images" operation fetches a paginated list of images contained within a given Gyazo collection. This is useful for workflows that need to process or analyze images grouped in collections on Gyazo, such as automating image management, generating reports, or integrating Gyazo images into other systems.
Practical examples:
- Automatically retrieving all images from a project-specific collection for backup or further processing.
- Displaying thumbnails or metadata of images from a collection inside a dashboard.
- Triggering downstream actions based on new images added to a particular collection.
Properties
| Name | Meaning |
|---|---|
| Collection | The target collection to retrieve images from. Can be specified by its 32-character hexadecimal ID or by a full URL in the format https://gyazo.com/collections/{id}. |
| Options | Additional optional settings: - Pagination: Controls which page of results to fetch and how many images per page (max 100). Includes: • Page (number): The page number to retrieve (default 1). • Per Page (number): Number of images per page (default 20, max 100). |
Output
The output is a JSON object containing the response from the Gyazo API endpoint that lists images in the specified collection. It includes an array of image objects with their metadata such as image IDs, URLs, timestamps, and other relevant details provided by Gyazo.
No binary data is output by this operation; it strictly returns JSON-formatted metadata about the images.
Dependencies
- Requires an API key credential for authenticating requests to the Gyazo API.
- The node uses the Gyazo API base URL
https://api.gyazo.com. - Pagination parameters are supported to control the volume of data returned.
Troubleshooting
Invalid Collection ID or URL:
If the collection identifier does not match the expected 32-character hexadecimal string or the URL formathttps://gyazo.com/collections/{id}, the node will throw an error indicating invalid format. Ensure the collection ID or URL is correctly specified.API Authentication Errors:
If the API key credential is missing, invalid, or expired, requests will fail. Verify that the correct API authentication token is configured in n8n credentials.Pagination Limits:
The maximum number of images per page is 100. Setting a higher value may cause errors or unexpected behavior.Network or API Errors:
General HTTP errors from the Gyazo API (e.g., rate limiting, server errors) will be surfaced as node errors. Check network connectivity and API status if issues persist.