—— § 01 · Universal snippet

One <script> tag. Every other stack.

For Webflow, Framer, Squarespace, Ghost, Bubble, hand-rolled HTML, or anything else. One async line in your <head>. The snippet is 4.2 KB gzipped, served from Cloudflare edges in ~180 cities, and never blocks the main thread.

—— § 02 · Drop-in snippet

The 30-second install.

Find your SITE_IDin Settings → Install inside the AIRRNK dashboard. Paste the snippet once inside your site’s <head>. Save. The first scan kicks off within two minutes.

Async, never blocks render.
Served from Cloudflare’s edge (180+ cities).
4.2 KB gzipped. No runtime dependencies.

html

<!-- Add once inside <head>, before </head> -->
<script
  src="https://edge.airank.tech/v1/snippet/SITE_ID.js"
  async
  data-airank-site="SITE_ID">
</script>

—— § 03 · Config options

For when you need more control.

Declare a global window.AIRANK object before the snippet loads. Every field is optional; the snippet falls back to your dashboard settings.

sitestring: Your site’s SITE_ID. Required unless data-airank-site attribute is set on the script tag.
featuresobject: Toggle individual injections (schema, answer capsules, meta rewrite). Useful to A/B test.
onReadyfunction: Fires once after all injections apply, with a report object containing score, applied count, and timings.

html

<script>
  window.AIRANK = {
    site: "SITE_ID",
    features: {
      schema: true,          // inject JSON-LD
      answerCapsules: true,  // insert capsule after first H2
      metaRewrite: false,    // leave existing meta description alone
    },
    onReady: (report) => {
      // optional: called after injections apply
      console.log("airank ready", report.score);
    },
  };
</script>
<script src="https://edge.airank.tech/v1/snippet/SITE_ID.js" async></script>

Honest note on effectiveness

Most AI crawlers (GPTBot, ClaudeBot, PerplexityBot, CCBot) do not execute JavaScript. They see the raw HTML returned by your server. The universal snippet therefore reaches roughly 75% of the full impact that a server-side integration (WordPress plugin, Shopify app, or DNS proxy) delivers.

If you can, run a server-side integration instead. If you cannot — Framer, Squarespace, and most static hosts are in this bucket — the snippet still handles the JS-executing bots (Google, Bing, some modern AI crawlers) and client-side analytics fully.

—— § 04 · REST API

For agencies and power users.

The same API that powers the dashboard. Fetch citation streams, approve injections, subscribe to webhooks, generate content on Pro+, manage sub-accounts on Scale.

Full API reference Webhook events

1,000 requests/day on Pro, 10,000 on Scale.
HMAC-SHA256 signed webhooks, three retry attempts.
OpenAPI 3.1 spec published at /openapi.json.

bash

# Fetch the current citation stream for your site
curl https://api.airank.tech/v1/sites/SITE_ID/citations \
  -H "Authorization: Bearer ${AIRANK_API_KEY}"

# Approve a pending injection
curl -X POST \
  https://api.airank.tech/v1/sites/SITE_ID/injections/INJ_ID/activate \
  -H "Authorization: Bearer ${AIRANK_API_KEY}"

# Subscribe to citation events via webhook
curl -X POST https://api.airank.tech/v1/webhooks \
  -H "Authorization: Bearer ${AIRANK_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-api.com/airank-webhook",
    "events": ["citation.detected", "scan.completed"],
    "secret": "wh_your_secret"
  }'

§ 07 · Start now

See where AI recommends you —
and where it doesn't.

30 seconds. One domain. A full report showing which AI platforms mention your brand, which ones recommend your competitors instead, and exactly how to fix it. Free. No credit card.

Want to track results every week?Create a free account →

One dashboard · six AI platforms

ChatGPT
Claude
Perplexity
Gemini
Grok
Copilot