Yourtext.Guru
Actions28
- Group Actions
- Guide Actions
- Project Actions
- SEO Txl Actions
Overview
The node integrates with the Yourtext.Guru SEO content optimization platform, specifically providing functionality to retrieve a "topical mesh" for a group within a project. A topical mesh is a thematic structure or map derived from all guides in a specified group, useful for understanding and optimizing content clusters around specific topics.
This operation is beneficial when you want to analyze or visualize the semantic relationships and topic coverage of grouped SEO guides, helping content strategists and marketers improve their content planning and SEO performance.
Practical example: You have a group of SEO guides related to a product category, and you want to fetch the topical mesh to see how well the topics are interconnected and identify gaps or opportunities for new content.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project containing the group. |
| Group ID | The unique identifier of the group whose topical mesh you want to retrieve. |
Output
The output JSON contains the topical mesh data for the specified group. This typically includes structured information about topics, their relationships, and possibly metrics or metadata relevant to SEO analysis. The exact structure depends on the Yourtext.Guru API response but generally represents the thematic connections between guides in the group.
No binary data output is involved in this operation.
Dependencies
- Requires an active Yourtext.Guru API key credential configured in n8n.
- The node makes HTTP requests to the Yourtext.Guru API endpoint at
https://yourtext.guru/api/v2. - Proper permissions and valid project/group IDs are necessary to access the topical mesh data.
Troubleshooting
- Invalid Project or Group ID: If the provided IDs do not exist or are incorrect, the API will likely return an error. Verify that the IDs are correct and correspond to existing entities in Yourtext.Guru.
- Authentication Errors: Ensure the API key credential is correctly set up and has sufficient permissions.
- Network Issues: Connectivity problems can cause request failures; check your network and proxy settings if applicable.
- API Rate Limits: Excessive requests may be throttled by the Yourtext.Guru API; consider implementing retries or delays.
Common error messages:
- Unauthorized or 401 errors indicate issues with API credentials.
- 404 errors suggest the project or group was not found.
- 400 errors may indicate malformed requests or missing required parameters.
Links and References
- Yourtext.Guru Official Website
- Yourtext.Guru API Documentation (for detailed API endpoints and response formats)