API Documentation

Base URL: https://htmlmix.pro/api/

Authentication

Auth Type: Bearer Token

All requests must include the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Error Codes

API Limits & Access

• Requests allowed: 1 per 60 seconds (applies to all endpoints).
• Quota system applies to Randomize HTML letter.
• PRO subscription required for Randomize HTML letter and User info.
• Create Redirect — no subscription required, paid from balance.

Endpoint: Randomize HTML letter

Method: POST

URL: https://htmlmix.pro/api?action=getRandomizeLetter

Request Parameters

Example Request (cURL)

curl -X POST "https://htmlmix.pro/api?action=getRandomizeLetter" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
      "source": "Your html",
      "modeMorphing": {
        "randomTableLayot": 1,
        "splitInversion": 1,
        "zeroFront": 1,
        "synonymsAI": 1
      },
      "settings": {
          "inlineStylesToClasses": 0,
          "inlineStylesToClassesProbability": 40,
          "classesToInlineStyles": 0,
          "classesToInlineStylesProbability": 40,
          "startMacros": "[%%",
          "endMacros": "%%]",
          "startSpintax": "{",
          "separatorSpintax": "|",
          "endSpintax": "}",
          "temperature": 0.6,
          "aiLanguage": "auto",
          "insertGarbageCode": 1,
          "insertGarbageCodeProbability": 15,
          "selectedGarbageTags": ["span", "strong", "em", "del", "font"],
          "garbageToLink": 1,
          "addRandomComments": 1
      },
      "additionalSettings": {
        "zeroFrontLengthCharacters": 4,
        "insertTrends": 1,
        "regionTrends": "US",
        "valueStopWords": ""
      },
      "trustLinks": {
          "insertTrustLink": 1,
          "insertTrustWiki": 1,
          "trustLinkHidden": 0,
          "insertTrustLinkLengthMin": 10,
          "insertTrustLinkLengthMax": 30,
          "insertTrustLinkKeywordWiki": "Bank",
          "languageInsertTextWiki": "en"
      },
      "imagesFunctions": {
          "convertTemplateToImage": 1,
          "convertTemplateToImageUploadHosting": 0,
          "uploadImgToHosting": 1
      }
  }'
    

Example Request (Python)

import requests

url = "https://htmlmix.pro/api?action=getRandomizeLetter"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "source": "Your html",
    "modeMorphing": {
      "randomTableLayot": 1,
      "splitInversion": 1,
      "zeroFront": 1,
      "synonymsAI": 1
    },
    "settings": {
        "inlineStylesToClasses": 0,
        "inlineStylesToClassesProbability": 40,
        "classesToInlineStyles": 0,
        "classesToInlineStylesProbability": 40,
        "startMacros": "[%%",
        "endMacros": "%%]",
        "temperature": 0.6,
        "aiLanguage": "auto",
        "insertGarbageCode": 1,
        "insertGarbageCodeProbability": 15,
        "selectedGarbageTags": ["span", "div", "strong", "em"],
        "garbageToLink": 1,
        "addRandomComments": 1
    },
    "additionalSettings": {
      "zeroFrontLengthCharacters": 4,
      "insertTrends": 1,
      "regionTrends": "US",
      "valueStopWords": ""
    },
    "trustLinks": {
        "insertTrustLink": 1,
        "insertTrustWiki": 1,
        "trustLinkHidden": 0,
        "insertTrustLinkLengthMin": 10,
        "insertTrustLinkLengthMax": 30,
        "insertTrustLinkKeywordWiki": "Bank",
        "languageInsertTextWiki": "en"
    },
    "imagesFunctions": {
        "convertTemplateToImage": 1,
        "convertTemplateToImageUploadHosting": 0,
        "uploadImgToHosting": 1
    }
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
    

Response Format

{
    "status": "success",
    "html": ["html-1","html-2","html-3"....]
}
    

Endpoint: Create Redirect Links

Method: POST

URL: https://htmlmix.pro/api?action=createRedirect

Create trusted redirect links through high-reputation domains (search.app, share.google, AWS S3, pages.dev). The cost is deducted from your balance. If you have an active redirect subscription, daily free links are used first for covered providers (search.app, share.google, pages.dev).

Request Parameters

Available Providers

Example Request (cURL)

curl -X POST "https://htmlmix.pro/api?action=createRedirect" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
      "target_url": "https://example.com/landing",
      "redirect_chain": ["search_app"],
      "count": 10,
      "google_safe_monitoring": true
  }'
    

Example Request (Python)

import requests

url = "https://htmlmix.pro/api?action=createRedirect"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "target_url": "https://example.com/landing",
    "redirect_chain": ["search_app"],
    "count": 10,
    "google_safe_monitoring": True
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
    

Response Format

{
    "status": "success",
    "redirect_urls": [
        "https://search.app/abc123",
        "https://search.app/def456",
        "..."
    ],
    "message": "Redirects created successfully",
    "cost": 0.12,
    "new_balance": 84.50,
    "redirect_remaining_daily": 40,
    "redirect_chain": ["search_app"]
}
    

Response Fields

Endpoint: Get information about subscription and quota

Method: POST

URL: https://htmlmix.pro/api?action=getUserInfo

Example Request (cURL)

curl -X POST "https://htmlmix.pro/api?action=getUserInfo" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
    

Example Request (Python)

import requests

url = "https://htmlmix.pro/api?action=getUserInfo"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
response = requests.post(url, headers=headers)
print(response.json())
    

Response Format

{
    "status": "success",
    "user": {
        "subscription_end_date": "2028-01-15",
        "quota_api": 9992
    }
}