Developer API

Every free MeByte GEO tool is also a JSON endpoint. No key, no account, CORS open to any origin — call it from your app, your agent or a static page, and link results back for your users.

# -i prints headers + body; add your key to lift the quota
curl -i "https://mebyte.ai/api/public/v1/tools/crawler-check?url=example.com" \
  -H "x-api-key: mbk_live_xxxxxxxx"

HTTP/2 200
x-ratelimit-tier: growth
x-ratelimit-mode: full
x-ratelimit-limit: 400
x-ratelimit-remaining: 397
x-ratelimit-reset: 1750000000
x-ratelimit-daily-limit: 4000
x-ratelimit-daily-remaining: 3912

url="https://mebyte.ai/api/public/v1/tools/crawler-check?url=example.com"
for attempt in 1 2 3 4 5; do
  code=$(curl -s -o /tmp/out.json -D /tmp/hdr.txt -w '%{http_code}' \
    -H "x-api-key: $MEBYTE_API_KEY" "$url")
  [ "$code" != "429" ] && break

  # honour Retry-After, then exponential backoff with jitter
  wait=$(grep -i '^retry-after:' /tmp/hdr.txt | tr -dc '0-9')
  wait=$(( ${wait:-1} * attempt * attempt + RANDOM % 3 ))
  echo "rate limited, sleeping ${wait}s (attempt $attempt)" >&2
  sleep "$wait"
done
cat /tmp/out.json

async function callMeByte(url, { key, maxAttempts = 5 } = {}) {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const res = await fetch(url, { headers: key ? { "x-api-key": key } : {} });

    // quota telemetry is on every response, 200 and 429 alike
    const quota = {
      tier: res.headers.get("X-RateLimit-Tier"),
      mode: res.headers.get("X-RateLimit-Mode"),
      remaining: Number(res.headers.get("X-RateLimit-Remaining") ?? 0),
      resetAt: Number(res.headers.get("X-RateLimit-Reset") ?? 0) * 1000,
    };

    if (res.status !== 429) return { data: await res.json(), quota };
    if (attempt === maxAttempts) throw new Error("MeByte rate limit: give up");

    const retryAfter = Number(res.headers.get("Retry-After") ?? 1);
    const backoff = retryAfter * 1000 * 2 ** (attempt - 1);
    await new Promise((r) => setTimeout(r, backoff + Math.random() * 500));
  }
}

Endpoints

External link builder

Enter a website to generate ready-made links — API calls and shareable result pages you can drop into your product, docs or client report.

Access tiers & rate limits

Keyless calls are free forever, but they return a shareable result link plus a headline summary — not the full payload. Send an API key (x-api-key: mbk_live_…, or Authorization: Bearer …) to receive the complete JSON and a multiplied quota. Every response carries X-RateLimit-Tier, X-RateLimit-Mode, X-RateLimit-Remaining and the daily equivalents; over quota you get 429 with a quota object and Retry-After.

Key tiers multiply the base numbers above — a Growth key gets 400 crawler checks per hour.

API keys

Keys are issued per brand on paid plans and shown once. Revoke any key instantly.

OpenAPI spec

Every public endpoint — free tools and the partner API — is described in one OpenAPI 3.1 document, including each X-RateLimit-* response header and a full 429 example with Retry-After. Import it into Postman, Insomnia, or an SDK generator.

# generate a typed client
npx @hey-api/openapi-ts -i https://mebyte.ai/api/public/v1/openapi.json -o ./src/mebyte

Fair use & attribution

• • Keyless use is free for any purpose, including commercial products — share links only.
• • Paid-plan API keys unlock the full JSON payload and a multiplied rate limit.
• • Cache responses for at least 5 minutes; the crawler check fetches live sites.
• • When you display results, credit MeByte with a link to mebyte.ai.
• • Need brand-level data (AI visibility scans, articles, readiness assets)? Those live behind the authenticated partner API — see plans.