Generate hreflang annotations for multilingual pages and return them as HTML <link> tags, an HTTP Link header, and an XML sitemap block, plus validation issues (invalid URL, language, or region code, duplicate language-region pairs, missing x-default). Pass one page group as variants, or several as groups.
This page documents the HTTP endpoint POST /api/tools/hreflang-tag-generator/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/hreflang-tag-generator/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
curl -X POST https://api.findutils.com/api/tools/hreflang-tag-generator/execute \
-H "Content-Type: application/json" \
-d '{
"variants": [
{
"language": "en",
"region": "US",
"url": "https://example.com/en-us/",
"x_default": true
},
{
"language": "de",
"url": "https://example.com/de/"
}
]
}' Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/hreflang-tag-generator Input schema
| Argument | Type | Required | Description |
|---|---|---|---|
| variants | array | no | Shortcut for a single page group: array of { language, region?, url, x_default? }. language is an ISO 639-1 code (en, de, tr); region is an ISO 3166-1 alpha-2 code (US, GB). |
| groups | array | no | Several page groups: array of { base_url?, variants: [...] }. Each group is one page and its translations. |
| format | string (all | html | http | xml) | no | Which output to fill. "all" fills html, http_headers, and xml_sitemap; a single format leaves the others empty. Default "all". Default: "all". |
Example arguments (verified)
{
"variants": [
{
"language": "en",
"region": "US",
"url": "https://example.com/en-us/",
"x_default": true
},
{
"language": "de",
"url": "https://example.com/de/"
}
]
} Also an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:hreflang_tag_generator after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/ More Seo tools
Bot Crawl Checker
Return which of 24 well-known crawlers (Googlebot, BingBot, GPTBot, ClaudeBot, PerplexityBot, AhrefsBot, Twitterbot and more) are allowed or
Domain Rating Checker
Return the Ahrefs Domain Rating (0-100) for up to 25 domains in one call, with a per-domain status.
Faq Schema Generator
Generate FAQPage JSON-LD structured data from question-answer pairs, and return the JSON-LD string, a ready <script> tag, the schema object,
Form To Json Schema
Returns a form schema object ({ formId, method, action, fields, submitText }) extracted from HTML form markup.
Geo Analyzer
Return a Generative Engine Optimization (GEO) report for a public web page: an overall 0-100 score, per-category scores (technical, content,
Graphql Schema Validator
Validate a GraphQL SDL schema and return errors, naming-convention warnings, and counts of types, queries, mutations, and subscriptions.
Heading Structure Analyzer
Analyze the H1-H6 heading hierarchy of an HTML document and return every heading, SEO warnings (missing or multiple H1, skipped levels, empt
Json Ld Generator
Generate JSON-LD structured data for 12 schema.org types (Article, BlogPosting, Product, Organization, LocalBusiness, Person, Event, FAQPage