Hreflang Tag Generator API

POST https://api.findutils.com/api/tools/hreflang-tag-generator/execute

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.

Open the tool Try it

Request body

application/json

variants

array optional

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 optional

Several page groups: array of { base_url?, variants: [...] }. Each group is one page and its translations.
format

string optional

Which output to fill. "all" fills html, http_headers, and xml_sitemap; a single format leaves the others empty. Default "all". One of all · html · http · xml. 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/"
    }
  ]
}

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/"
      }
    ]
  }'

const response = await fetch('https://api.findutils.com/api/tools/hreflang-tag-generator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"variants":[{"language":"en","region":"US","url":"https://example.com/en-us/","x_default":true},{"language":"de","url":"https://example.com/de/"}]}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/hreflang-tag-generator/execute",
    json={"variants":[{"language":"en","region":"US","url":"https://example.com/en-us/","x_default":True},{"language":"de","url":"https://example.com/de/"}]},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/hreflang-tag-generator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"variants":[{"language":"en","region":"US","url":"https://example.com/en-us/","x_default":true},{"language":"de","url":"https://example.com/de/"}]}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call hreflang_tag_generator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: hreflang-tag-generator
MCP name: hreflang_tag_generator
Category: SEO
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More SEO tools

More to explore