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 "Create Guide" operation in the Yourtext.Guru node allows users to create a new SEO content guide based on a query string. This guide helps content creators and marketers optimize their content for search engines by generating recommendations tailored to the specified language, project, and optionally group context.

Typical use cases include:

  • Automatically generating SEO guides for new content topics.
  • Integrating guide creation into content workflows to ensure SEO best practices.
  • Managing multiple projects and groups with targeted guides per language or search engine type.

For example, a user can input a query like "best Italian restaurants in New York," select English (United States) as the language, and create a guide that provides SEO insights and keyword suggestions relevant to that topic.

Properties

Name Meaning
Language The language for the guide. Options include various regional variants of Dutch, English, French, German, Italian, Polish, Portuguese, Romanian, and Spanish. Default is English (United States).
Query The search query or topic used to generate the guide.
Additional Fields A collection of optional fields:
- Project ID Optional ID of the project to associate the guide with.
- Type of Guide The type of guide to create; options are "Google" (default) or "Bing".
- Group ID Optional ID of the group to associate the guide with.

Output

The node outputs JSON data representing the newly created guide object returned from the Yourtext.Guru API. This typically includes details such as the guide's unique identifier, associated project/group IDs, language, type, and other metadata related to the SEO guide.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Yourtext.Guru service.
  • The node makes HTTP POST requests to the Yourtext.Guru API endpoint /guides.
  • Proper configuration of the API key credential in n8n is necessary for successful execution.

Troubleshooting

  • Missing or invalid API key: The node will fail if the API key credential is not set or incorrect. Ensure the API key is valid and configured in n8n credentials.
  • Invalid or empty query: The query property is required. Providing an empty or invalid query may cause the API to reject the request.
  • Incorrect language code: Selecting a language code not supported by the API could result in errors or unexpected behavior.
  • Project or group IDs do not exist: If provided, these IDs must correspond to existing entities in Yourtext.Guru; otherwise, the API may return errors.
  • Network issues: Connectivity problems between n8n and the Yourtext.Guru API endpoint can cause timeouts or failures.

To resolve errors, verify all required parameters, check API key validity, and confirm network connectivity.

Links and References

Discussion