Yourtext.Guru icon

Yourtext.Guru

Yourtext.Guru is an advanced SEO content optimization tool designed to help writers and marketers create high-performing content.
Join our community

Actions28

Overview

The "Get Many" operation for the "Guide" resource in this node allows users to retrieve a list of guides from the Yourtext.Guru platform. This operation is useful for fetching multiple SEO content optimization guides based on various filtering criteria such as project ID, language, group ID, status, and whether the guide was created via API.

Typical use cases include:

  • Listing all guides associated with a specific project or group.
  • Filtering guides by language or status to manage or analyze subsets of content.
  • Retrieving only guides created through the API for automation workflows.

For example, a content manager could use this operation to fetch all "ready" guides in English within a particular project to review them before publishing.

Properties

Name Meaning
Project ID Optional string to filter guides belonging to a specific project.
Last ID Number indicating the last guide ID received; used for pagination to get the next set of guides (default is 0).
Additional Fields A collection of optional filters:
- Language: Filter guides by language. Options include many locales such as English (US, UK, Australia, etc.), French, German, Spanish, Italian, Polish, Portuguese, Romanian, Dutch.
- API Only: Whether to get only guides created by API (Yes or No).
- Group ID: Filter guides by a specific group ID.
- Status: Filter guides by their status. Options are All, Error, In Progress, Ready, and Waiting.

Output

The output JSON contains an array of guide objects retrieved from the Yourtext.Guru API. Each guide object includes details about the guide such as its ID, status, language, associated project or group IDs, and other metadata relevant to SEO content optimization.

This node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating requests to the Yourtext.Guru API.
  • The node makes HTTP GET requests to the endpoint /guides with query parameters based on the input properties.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Empty results: If no guides are returned, verify that the filtering parameters (Project ID, Group ID, Language, Status) are correct and that guides exist matching those filters.
  • Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Pagination issues: Use the Last ID property properly to paginate through large sets of guides. Starting with 0 fetches from the beginning.
  • Invalid parameter values: Make sure option values like language codes and status strings match the allowed options exactly.

Links and References

Discussion