Overview
This node integrates with the Gyazo API to perform image-related operations, specifically including searching images based on a query. The "Search" operation under the "Image" resource allows users to find images stored in their Gyazo account that match a given search term.
Common scenarios where this node is beneficial include:
- Automating retrieval of specific images from a large collection by keyword or tag.
- Integrating image search into workflows for content management or social media automation.
- Filtering images dynamically based on user input or other workflow data.
For example, a marketing team could use this node to automatically find and retrieve all images related to a campaign keyword, then process or share them further downstream.
Properties
| Name | Meaning |
|---|---|
| Query | The search query string used to find matching images in Gyazo. |
| Options | Additional optional parameters: |
| Pagination - Page | The page number of results to retrieve (default 1). |
| Pagination - Per Page | Number of results per page, maximum 100 (default 20). |
Output
The output is a JSON object containing the search results returned by the Gyazo API. This typically includes an array of image metadata objects matching the search query, such as image IDs, URLs, thumbnails, titles, descriptions, and timestamps.
No binary data is output by this operation; it only returns JSON metadata about the images found.
Dependencies
- Requires an API key credential for authenticating requests to the Gyazo API.
- The node uses the Gyazo REST API endpoint
https://api.gyazo.com/api/searchfor searching images. - No additional external dependencies beyond the configured API authentication are needed.
Troubleshooting
- Invalid Query Parameter: If the query string is empty or malformed, the API may return an error or no results. Ensure the "Query" property is set correctly.
- Pagination Limits: Requesting a page number or results per page outside allowed ranges may cause errors or unexpected results. Keep "Per Page" at or below 100.
- Authentication Errors: Missing or invalid API credentials will result in authorization failures. Verify the API key is correctly configured.
- API Rate Limits: Excessive requests may be throttled by Gyazo. Implement retry logic or reduce request frequency if encountering rate limit errors.
Links and References
- Gyazo API Documentation – Official API docs for endpoints and parameters.
- Gyazo Image Search Endpoint – Details on the search API used by this node.