{
  "openapi": "3.0.3",
  "info": {
    "title": "SEO Markup and Content Generator API",
    "version": "1.5.1",
    "description": "Meta tags, robots.txt and sitemap, schema.org JSON-LD, keyword density, hashtags and social captions. Generate the markup and copy around a page: title and meta tags with Open Graph and Twitter cards, robots.txt and sitemap.xml, schema.org JSON-LD for common types, keyword density of a text, hashtags from a topic and platform-length social captions. These work on the text you send; they do not crawl a site, fetch a page or return search rankings. Nothing you send is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "SEO & Web Markup",
      "description": "Meta tags, robots.txt and sitemap, schema.org JSON-LD, keyword density, hashtags and social captions."
    }
  ],
  "paths": {
    "/v1/seo/meta-tags": {
      "post": {
        "summary": "Generate title, description, Open Graph and Twitter Card meta tags as HTML",
        "operationId": "seoMetaTags",
        "description": "Generate title, description, Open Graph and Twitter Card meta tags as HTML. Send JSON with title, description (required); optional: url, image, siteName, type, twitterCard. Returns JSON with html, tags. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1
                  },
                  "url": {
                    "type": "string"
                  },
                  "image": {
                    "type": "string"
                  },
                  "siteName": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  },
                  "twitterCard": {
                    "type": "string",
                    "enum": [
                      "summary",
                      "summary_large_image"
                    ]
                  }
                },
                "required": [
                  "title",
                  "description"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "Merge PDF files online",
                "description": "Combine several PDFs into one file in your browser. Nothing is uploaded.",
                "url": "https://www.freedailypro.com/merge-pdf",
                "siteName": "FreeDailyPro",
                "twitterCard": "summary_large_image"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "html": {
                      "type": "string",
                      "description": "The tags as HTML, one per line: title, description, Open Graph and Twitter Card",
                      "example": "<title>Merge PDF files online</title>\n<meta name=\"description\" content=\"Combine several PDFs into one file.\" />"
                    },
                    "tags": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      },
                      "description": "The same tags as name/value pairs (values are plain text, not HTML-escaped)",
                      "example": {
                        "title": "Merge PDF files online",
                        "description": "Combine several PDFs into one file.",
                        "og:title": "Merge PDF files online",
                        "twitter:card": "summary"
                      }
                    }
                  },
                  "required": [
                    "html",
                    "tags"
                  ]
                },
                "example": {
                  "html": "<title>Merge PDF files online</title>\n<meta name=\"description\" content=\"Combine several PDFs into one file in your browser. Nothing is uploaded.\" />\n<meta property=\"og:url\" content=\"https://www.freedailypro.com/merge-pdf\" />\n<meta property=\"og:title\" content=\"Merge PDF files online\" />\n<meta propert...",
                  "tags": {
                    "title": "Merge PDF files online",
                    "description": "Combine several PDFs into one file in your browser. Nothing is uploaded.",
                    "og:url": "https://www.freedailypro.com/merge-pdf",
                    "og:title": "Merge PDF files online",
                    "og:description": "Combine several PDFs into one file in your browser. Nothing is uploaded.",
                    "og:type": "website",
                    "og:site_name": "FreeDailyPro",
                    "twitter:card": "summary_large_image",
                    "twitter:title": "Merge PDF files online",
                    "twitter:description": "Combine several PDFs into one file in your browser. Nothing is uploaded."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}. Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/seo/keyword-density": {
      "post": {
        "summary": "Count how often a keyword appears in text and return its density percentage",
        "operationId": "seoKeywordDensity",
        "description": "Count how often a keyword appears in text and return its density percentage. Send JSON with text, keyword (required); optional: caseSensitive. Returns JSON with totalWords, keywordCount, densityPercent, occurrences (inside result). Limits: keyword: up to 500 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The text to analyse, in any language. Words are runs of letters and numbers in any script (accents, Cyrillic, Arabic ...); Japanese, Chinese, Korean and Thai text written without spaces is split with a word segmenter."
                  },
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "description": "The word or phrase to count (up to 500 characters). A phrase must appear as the same whole words in a row. Matching is by whole word, accent-sensitive ('cafe' does not match 'café') and case-insensitive unless caseSensitive is true. A keyword with no letters or numbers is a 400."
                  },
                  "caseSensitive": {
                    "description": "true: 'PDF' and 'pdf' are different. Default false.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "PDF tools make work easier. Merge a PDF, split a PDF, compress a PDF.",
                "keyword": "pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "totalWords": {
                          "type": "integer",
                          "description": "Words in the text after HTML entities are decoded",
                          "example": 14
                        },
                        "keywordCount": {
                          "type": "integer",
                          "description": "How many times the keyword (or phrase) appears as whole words",
                          "example": 4
                        },
                        "densityPercent": {
                          "type": "number",
                          "description": "Share of the words covered by the keyword, 0 to 100, 2 decimals",
                          "example": 28.57
                        },
                        "occurrences": {
                          "type": "array",
                          "items": {
                            "type": "integer"
                          },
                          "description": "Zero-based word positions where each match starts",
                          "example": [
                            0,
                            7,
                            10,
                            13
                          ]
                        }
                      },
                      "required": [
                        "totalWords",
                        "keywordCount",
                        "densityPercent",
                        "occurrences"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "totalWords": 14,
                    "keywordCount": 4,
                    "densityPercent": 28.57,
                    "occurrences": [
                      0,
                      7,
                      10,
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}. Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/seo/hashtags": {
      "post": {
        "summary": "Extract hashtags from text or generate them from keywords",
        "operationId": "seoHashtags",
        "description": "Extract hashtags from text or generate them from keywords. Send JSON with action (required); optional: text, keywords, max. Returns JSON: a list. Limits: max: at most 50, at least 1. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "extract",
                      "generate"
                    ],
                    "description": "extract finds #hashtags already in 'text'; generate builds hashtags from 'keywords' (or from the main words of 'text' if no keywords are sent)."
                  },
                  "text": {
                    "description": "Required for 'extract' (a missing or blank text is a 400): the text to read #hashtags from, in any language (#日本語, #café). A hashtag must contain a letter; #2024 alone is not one. Results are lower-cased and de-duplicated. For 'generate' it is only used to build hashtags from its most frequent words when no keywords are sent.",
                    "type": "string"
                  },
                  "keywords": {
                    "description": "Words or phrases to turn into hashtags, for example ['coffee shop', 'grand opening'].",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "max": {
                    "description": "Maximum hashtags to return (default 30, or 10 when built from text).",
                    "type": "number",
                    "minimum": 1,
                    "maximum": 50
                  }
                },
                "required": [
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "action": "generate",
                "keywords": [
                  "pdf tools",
                  "productivity"
                ],
                "max": 6
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A hashtag starting with #"
                      },
                      "description": "extract: the hashtags found, lower-cased and de-duplicated; generate: the hashtags built",
                      "example": [
                        "#PdfTools",
                        "#Productivity"
                      ]
                    },
                    "note": {
                      "type": "string",
                      "description": "Present only when generate built the hashtags from the text because no keywords were sent"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": [
                    "#PdfTools",
                    "#Productivity"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}. Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/seo/schema": {
      "post": {
        "summary": "Build schema.org JSON-LD for an Article, FAQ page or Organization",
        "operationId": "seoSchema",
        "description": "Builds a JSON-LD block you can paste into a page's <script type=\"application/ld+json\">. Types: 'article' (required: headline; optional: description, author, publisher, datePublished, dateModified, image, url, keywords, articleSection, inLanguage), 'faq' (required: items, each with a question and an answer) and 'organization' (required: name; optional: legalName, alternateName, description, url, logo, email, telephone, foundingDate, sameAs, address, contactPoint). Required fields are checked: a missing or empty one returns 400 naming the exact field (for example 'data.items[1].answer' is required). Dates must be ISO 8601, web addresses must start with http:// or https://, and emails and phone numbers are format-checked. author and publisher accept a name or an object (name, url, logo). Nothing is invented: only what you send is output. Fields that are not supported for the type are not dropped silently, they are listed in 'warnings' together with fields Google recommends for rich results. This builds markup only; it does not validate it against Google's Rich Results test. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "article",
                      "faq",
                      "organization"
                    ],
                    "description": "Which schema.org type to build."
                  },
                  "data": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "The fields for that type. article: headline (required), description, author, publisher, datePublished, dateModified, image, url, keywords, articleSection, inLanguage. faq: items (required), a list of {question, answer}. organization: name (required), legalName, alternateName, description, url, logo, email, telephone, foundingDate, sameAs, address, contactPoint."
                  }
                },
                "required": [
                  "type",
                  "data"
                ],
                "additionalProperties": false
              },
              "example": {
                "type": "article",
                "data": {
                  "headline": "How to brew pour-over coffee",
                  "author": "Maria Lopez",
                  "publisher": {
                    "name": "Harbor Coffee Co.",
                    "logo": "https://example.com/logo.png"
                  },
                  "datePublished": "2026-10-01",
                  "dateModified": "2026-10-20",
                  "image": "https://example.com/pour-over.jpg",
                  "url": "https://example.com/pour-over"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "@context": {
                          "type": "string",
                          "description": "Always https://schema.org"
                        },
                        "@type": {
                          "type": "string",
                          "description": "Article, FAQPage or Organization"
                        }
                      },
                      "required": [
                        "@context",
                        "@type"
                      ],
                      "description": "The JSON-LD object, ready to place in a script tag of type application/ld+json. More properties follow the type; see the example.",
                      "example": {
                        "@context": "https://schema.org",
                        "@type": "Article",
                        "headline": "How to brew pour-over coffee"
                      }
                    },
                    "warnings": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A recommended field that is missing, or an input field that was not used"
                      },
                      "description": "Plain-words notes; empty when there is nothing to say",
                      "example": [
                        "Google recommends these for Article rich results and they were not provided: image."
                      ]
                    }
                  },
                  "required": [
                    "result",
                    "warnings"
                  ]
                },
                "example": {
                  "result": {
                    "@context": "https://schema.org",
                    "@type": "Article",
                    "headline": "How to brew pour-over coffee",
                    "author": {
                      "@type": "Person",
                      "name": "Maria Lopez"
                    },
                    "publisher": {
                      "@type": "Organization",
                      "name": "Harbor Coffee Co.",
                      "logo": "https://example.com/logo.png"
                    },
                    "datePublished": "2026-10-01",
                    "dateModified": "2026-10-20",
                    "image": "https://example.com/pour-over.jpg",
                    "mainEntityOfPage": {
                      "@type": "WebPage",
                      "@id": "https://example.com/pour-over"
                    },
                    "url": "https://example.com/pour-over"
                  },
                  "warnings": []
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}. Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/seo/robots-sitemap": {
      "post": {
        "summary": "Generate a robots.txt and sitemap.xml for a domain from a list of page paths",
        "operationId": "seoRobotsSitemap",
        "description": "Generate a robots.txt and sitemap.xml for a domain from a list of page paths. Send JSON with domain, pages (required). Returns JSON with robotsTxt, sitemapXml (inside result). Limits: pages: up to 500 items. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The site address, http:// or https:// with a host, for example https://example.com (a path prefix such as https://example.com/blog is allowed). No username/password, ?query or #fragment. javascript:, ftp: and every other scheme is a 400."
                  },
                  "pages": {
                    "minItems": 1,
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "1 to 500 pages: paths such as /about (a missing leading slash is added), or full URLs on the same site. Empty entries, other hosts, credentials in a URL and protocol-relative // entries are a 400; duplicates are removed; spaces and non-ASCII characters are percent-encoded; & < > \" ' are XML-escaped in sitemap.xml."
                  }
                },
                "required": [
                  "domain",
                  "pages"
                ],
                "additionalProperties": false
              },
              "example": {
                "domain": "https://example.com",
                "pages": [
                  "/",
                  "/about",
                  "/pricing"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "robotsTxt": {
                          "type": "string",
                          "description": "The robots.txt text",
                          "example": "User-agent: *\nAllow: /\n\nSitemap: https://example.com/sitemap.xml"
                        },
                        "sitemapXml": {
                          "type": "string",
                          "description": "The sitemap.xml text (every URL XML-escaped)",
                          "example": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">...</urlset>"
                        }
                      },
                      "required": [
                        "robotsTxt",
                        "sitemapXml"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "robotsTxt": "User-agent: *\nAllow: /\nDisallow: /admin/\nDisallow: /private/\n\nSitemap: https://example.com/sitemap.xml",
                    "sitemapXml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n  <url>\n    <loc>https://example.com/</loc>\n    <lastmod>2026-10-30</lastmod>\n  </url>\n  <url>\n    <loc>https://example.com/about</loc>\n    <lastmod>2026-10-30</lastmod>\n  </url>\n  <url>\n    <loc>http..."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}. Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/seo/caption-generator": {
      "post": {
        "summary": "Write social media captions and topic-based hashtags (template based)",
        "operationId": "seoCaptionGenerator",
        "description": "Writes three captions for a topic, a platform and a tone from fixed templates (not an AI model). Hashtags are built from the words of YOUR topic (stop words removed: 'Grand opening of our new coffee shop' gives #grandopening #coffeeshop #shop #coffee #opening) followed by a small fixed set for the platform (instagram: #instagood, tiktok: #fyp; x and linkedin have none). Hashtag counts: instagram up to 5 from the topic, tiktok 3, linkedin 3, x 2. Tones differ in structure and voice, not just emoji: fun (exclamations, a hook question, emoji), professional (plain update/overview/key-point sentences, no emoji), bold (short imperative lines such as 'Make it happen.' and 'No excuses.'), genz (lowercase slang; on linkedin it falls back to professional because slang reads badly there). Instagram and LinkedIn captions use line breaks and a call to action; X captions are one line within 280 characters including hashtags; TikTok captions are one short line. The topic is placed as a standalone phrase (heading, after a colon, or as its own sentence) so any wording stays grammatical, and its first letter is capitalised unless it looks like a brand (iPhone). Nothing is said about the topic beyond your words. 'result' holds the three captions (each ends with the hashtags) and 'hashtags' lists the tags used. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "topic": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "What the post is about, in your own words and in any language or script (Japanese, Arabic, accented Latin, emoji are all fine), for example 'Grand opening of our new coffee shop' or '日本のコーヒー ☕'. Up to 200 characters; it must contain at least one letter or number. The hashtags are built from these words."
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "instagram",
                      "tiktok",
                      "x",
                      "linkedin"
                    ],
                    "description": "instagram, tiktok, x or linkedin: sets length, line breaks, call to action and how many hashtags."
                  },
                  "tone": {
                    "description": "fun (default), professional, bold or genz. Each tone writes with a different sentence structure and voice, not just different emoji.",
                    "type": "string",
                    "enum": [
                      "fun",
                      "professional",
                      "bold",
                      "genz"
                    ]
                  }
                },
                "required": [
                  "topic",
                  "platform"
                ],
                "additionalProperties": false
              },
              "example": {
                "topic": "Grand opening of our new coffee shop",
                "platform": "instagram",
                "tone": "fun"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One caption, hashtags included"
                      },
                      "description": "Three captions, one per style",
                      "example": [
                        "Grand opening of our new coffee shop! #grandopening #coffeeshop"
                      ]
                    },
                    "hashtags": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A hashtag"
                      },
                      "description": "The hashtags used in the captions",
                      "example": [
                        "#grandopening",
                        "#coffeeshop"
                      ]
                    }
                  },
                  "required": [
                    "result",
                    "hashtags"
                  ]
                },
                "example": {
                  "result": [
                    "Grand opening of our new coffee shop! 🎉\nTag a friend who needs to see this.\n\n#grandopening #coffeeshop #shop #coffee #opening #instagood",
                    "Ready for this?\nGrand opening of our new coffee shop. ✨\nTag a friend who needs to see this.\n\n#grandopening #coffeeshop #shop #coffee #opening #instagood",
                    "Pure good vibes: grand opening of our new coffee shop 😄\nTag a friend who needs to see this.\n\n#grandopening #coffeeshop #shop #coffee #opening #instagood"
                  ],
                  "hashtags": [
                    "#grandopening",
                    "#coffeeshop",
                    "#shop",
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}. Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}