Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Developer Utilities Tier 3 All-Access

User-Agent & AI Crawler Detection API — Identify GPTBot, ClaudeBot & Scrapers

Detect AI training crawlers, RAG bots, headless browsers, and device/OS details from User-Agent. Parse User-Agent strings and client hints to identify browsers, OS, devices, search engine crawlers, and AI training/RAG bots (GPTBot, ClaudeBot, PerplexityBot).

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/ua-bot-parserinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot",
    "is_bot": true,
    "is_ai_bot": true,
    "category": "ai_crawler",
    "bot": {
      "name": "GPTBot",
      "operator": "OpenAI",
      "category": "ai_crawler",
      "intent": "training",
      "docs_url": "https://platform.openai.com/docs/bots",
      "rule_id": "ai_openai_gptbot"
    },
    "client": {
      "browser": {
        "name": null,
        "version": null
      },
      "os": {
        "name": null,
        "version": null
      },
      "engine": null,
      "device_type": "bot"
    },
    "rules_version": "2026.11.1"
  },
  "meta": {
    "request_id": "req_ua_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/ua-bot-parser" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"user_agent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/ua-bot-parser", {
  "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/ua-bot-parser",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/ua-bot-parser", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_ua_bot_parser",
    "arguments": {
      "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/ua-bot-parser)

ParameterType & ConstraintsDescription
user_agent required string
minLen: 1, maxLen: 2048
Raw HTTP User-Agent header value (max 2048 characters).

Response data Object Fields (200 OK)

FieldTypeDescription
user_agent string Field 'user_agent'
is_bot boolean Field 'is_bot'
is_ai_bot boolean Field 'is_ai_bot'
category "human" | "ai_crawler" | "ai_assistant" | "search_crawler" | "social_preview" | "seo_crawler" | "monitoring" | "http_client" | "headless_browser" | "unknown_bot" Field 'category'
bot object | null Field 'bot'
client object Field 'client'
rules_version string Field 'rules_version'

What User-Agent & AI Bot Parser API Detects & Validates

  • Identifies 30+ AI crawlers and distinguishes training scrapers vs live user-triggered AI search/RAG fetchers (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended, CCBot, Bytespider)
  • Detects headless automation and CLI clients (HeadlessChrome, Playwright, Puppeteer, Selenium, curl, python-requests, Go-http-client)
  • Extracts browser family/version, rendering engine, OS family/version, and device type (mobile, tablet, desktop, tv, bot)
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • User-Agent strings can be spoofed by malicious scrapers; combine with reverse-DNS/IP range verification for high-security blocking.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Does it distinguish AI training scrapers from live AI search citations?

Yes! For example, it separates OpenAI's GPTBot (training) from OAI-SearchBot and ChatGPT-User (search/user browsing).

Can I pair this with robots.txt & llms.txt analysis?

Yes, use POST /v1/robots-llms-analyzer to audit and generate your site's AI crawler rules.

How fast is it?

Typically under 1 ms at the edge.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless in-memory User-Agent parsing.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/robots-llms-analyzer Developer Utilities

robots.txt & llms.txt AI Crawler Analyzer & Generator API

Audit which AI crawlers your robots.txt allows and generate a valid llms.txt file.

POST /v1/signup-fraud Compliance & Business

Signup Fraud & Disposable Email Scorer API

Block disposable emails, alias abuse, and bot signups with a 0–100 fraud risk score.

POST /v1/security-headers Security & Secrets

HTTP Security Header Scanner API

Audit CSP, HSTS, and browser security headers with an A+ to F grade and fix snippets.