{"uid":"cap_STKioLAzjxC2ocyDKr5wE","slug":"how-is-bot-observatory-partner-tier-83bd74b9","name":"how.is Bot Observatory – Partner Tier","description":"Partner tier of the dns.pizza bot observatory: every network (ASN), named crawler, TLS (JA4) fingerprint and firewall rule seen in the last 7 days, refreshed hourly. The public tier is free at https://dns.pizza/bots.","url":"https://how.is/v1/bots?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"_shape":"data.data: generated_at, networks, bots, fingerprints (the free tier at dns.pizza/bots shows the same shape without fingerprints)."},"result":"Bot observatory feed for the requested subject","receipt":{"rail":"x402","tool":"bots","charge_usd":0.05,"settlement_tx":"0x…"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4pSBKlhPHNuWTGoxIrooD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full partner-tier dataset of bot network traffic seen in the last 7 days: every ASN, named crawler, TLS/JA4 fingerprint, and firewall rule, refreshed hourly.","exampleAgentPrompt":"Pull the full partner-tier bot observatory snapshot from how.is — I want to see every ASN, named crawler, JA4 TLS fingerprint, and firewall rule recorded in the last 7 days.","exampleUseCases":[{"title":"Block malicious crawler ASNs","prompt":"Get me the latest bot observatory data from how.is so I can identify which ASNs are associated with aggressive crawlers and add them to our firewall blocklist."},{"title":"Audit TLS fingerprints for anomalies","prompt":"Fetch the partner-tier bot data from how.is — I need the JA4 TLS fingerprints observed in the last 7 days so I can cross-reference them against our own traffic logs for anomalous clients."},{"title":"Identify named crawlers hitting our CDN","prompt":"Pull this week's named crawler list from the how.is bot observatory so I can see which known bots like Googlebot, GPTBot, or others have been active and whether our CDN rules are handling them correctly."}],"resultDescription":"A structured dataset containing all bot-related network observations from the past 7 days: ASNs (autonomous system numbers), named crawler identities, TLS JA4 fingerprints, and triggered firewall rules — sourced from the dns.pizza bot observatory partner tier and refreshed hourly.","failureModes":["Payment not received or insufficient USDC balance — 402 Payment Required response","Malformed request body not conforming to required schema — 400 Bad Request","Service temporarily unavailable during hourly refresh cycle — 503 or timeout","Rate limiting if the endpoint is called excessively — 429 Too Many Requests"],"whenToPreferThis":"Choose this endpoint when you need comprehensive, up-to-date bot network intelligence beyond what the free public tier offers — specifically when you require ASN-level data, JA4 TLS fingerprints, and firewall rule telemetry together in a single hourly-refreshed snapshot. Prefer this over the free dns.pizza/bots endpoint when you need partner-tier completeness for security auditing, CDN tuning, or automated threat intelligence pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:00.642Z","isFirstParty":false,"canonicalSlug":"how-is-bot-observatory-partner-tier-83bd74b9"}