Integrate premium SVG icons into your platform with paid API access.

Public catalog endpoints

These endpoints expose metadata only and do not require an API key.

GET /tswg-svg-icon-api.php?action=list
GET /tswg-svg-icon-api.php?action=categories
GET /tswg-svg-icon-api.php?action=list&q=coach
GET /tswg-svg-icon-api.php?action=list&category=AI%20Automation

Protected SVG delivery

Use a paid API key to request the actual SVG payload.

GET /tswg-svg-icon-api.php?slug=ai-agent-system
Header: X-TSWG-ICON-KEY: YOUR_PAID_API_KEY

Alternative query-string key support exists, but header authentication is cleaner for production usage.

Success response

{
  "status": "success",
  "slug": "ai-agent-system",
  "label": "AI Agent System",
  "category": "AI Automation",
  "license_tier": "paid_api",
  "monthly_limit": 10000,
  "used_this_month": 42,
  "remaining_this_month": 9958,
  "svg": "<svg ...></svg>"
}

Error responses

Example cURL

curl -H "X-TSWG-ICON-KEY: YOUR_PAID_API_KEY" \
"https://thesurestwayguides.com/tswg-svg-icon-api.php?slug=ai-agent-system"

Example JavaScript

const res = await fetch("/tswg-svg-icon-api.php?slug=ai-agent-system", {
  headers: { "X-TSWG-ICON-KEY": "YOUR_PAID_API_KEY" }
});

const icon = await res.json();

if (icon.status === "success") {
  document.querySelector("#icon").innerHTML = icon.svg;
}