# Documentation - PublicWWW

Every page with its id (for read_docs) and the headings inside it.

## Query Syntax

Every operator and modifier for building a query: exact phrases, RegEx, site:, ccTLDs and more.

- `query-syntax` - Query Syntax: Everything, briefly; In detail; Where to go next
- `query-syntax/basics` - Basics: Words; Exact phrases `"..."`; Combining; Excluding `-`; Either one `|` and grouping `( )`; Near each other `distance:n`; A loose phrase `"..."~n`; Escaping
- `query-syntax/operators` - Operators: `depth:` - internal pages; `site:` - top-level domain; `ip:` - address or subnet
- `query-syntax/regex` - Regular expressions: Phone numbers of pizzerias in Italy; AddThis publisher ids; WordPress plugin names; Affiliate site ids
- `query-syntax/cctld` - Country domains

## Signatures

Find the code a product leaves on its customers' websites, and turn it into a query.

- `signatures` - Signatures: Why code, not the name; Step by step; A good signature; Other places to find the code; In detail
- `signatures/traces` - Where products leave traces: The address its script loads from; A setting inside the installed snippet; An account id; An element id or class of its widget; A plugin or module folder; A link to the product's own pages; Files served from the product's storage; The generator tag; HTTP headers and cookies
- `signatures/checking` - Checking a signature: Read the code, not just the list; Look at the end of the list; Take out what does not belong; One trace or several; What the count means; Narrow it down

## Technologies

Ready-made queries for over a thousand technologies, by topic - from ad pixels and analytics to frameworks, shops and payments.

- `examples` - Technologies
- `examples/ads` - Advertising: Yandex Advertising Network, Google Ad Manager, Taboola, Ezoic, Adsterra, MGID, PropellerAds, Prebid.js, Monetag, ExoClick and 26 more
- `examples/pixels` - Ad pixels & affiliate: Meta Pixel, Google Ads, TikTok Pixel, Microsoft Advertising, LinkedIn Insight Tag, Pinterest Tag, VK Pixel, X Pixel, Snap Pixel, Quantcast and 22 more
- `examples/marketing` - Marketing: Google Tag Manager, Yoast SEO, Rank Math, All in One SEO, Popup Maker, Adobe Experience Platform Tags, Matomo Tag Manager, The SEO Framework, OneSignal, WonderPush and 32 more
- `examples/email` - Email & automation: Mailchimp, HubSpot, Klaviyo, MC4WP: Mailchimp for WordPress, Brevo, MailerLite, Kit, HubSpot Forms, Omnisend, ActiveCampaign and 18 more
- `examples/reviews` - Reviews & store apps: Trustindex, Judge.me, Trustpilot, PageFly, Loox, Klevu, Tripadvisor, Algolia, Google Customer Reviews, Yotpo and 14 more
- `examples/analytics` - Analytics: Google Analytics 4, Site Kit by Google, Yandex Metrica, Baidu Tongji, 51.la, MonsterInsights, Jetpack Stats, Matomo, Cloudflare Web Analytics, Plausible and 39 more
- `examples/product-analytics` - Product analytics, replay & monitoring: Snowplow, Microsoft Clarity, New Relic, Hotjar, Crazy Egg, Datadog RUM, Sentry, PostHog, Segment, RudderStack and 24 more
- `examples/ab-testing` - A/B testing: Optimizely, VWO, Zoho PageSense, Adobe Target, Statsig, Intellimize, LaunchDarkly, Convert, GrowthBook, Intelligems and 11 more
- `examples/consent` - Consent & cookie banners: Complianz, CookieYes, consentmanager, Cookie Notice, Cookiebot, GDPR Cookie Compliance, Cookie Consent by Osano, Borlabs Cookie, iubenda, OneTrust and 26 more
- `examples/chat` - Chat & support: WhatsApp chat links, Joinchat, Tawk.to, Click to Chat, WP Social Chat, LiveChat, JivoChat, Smartsupp, Tidio, Zendesk Web Widget and 41 more
- `examples/captcha` - CAPTCHA & bot protection: reCAPTCHA, Cloudflare bot detection, reCAPTCHA v3, reCAPTCHA v2 checkbox, Cloudflare Turnstile, reCAPTCHA Enterprise, ALTCHA, hCaptcha, CleanTalk, Akismet and 18 more
- `examples/accessibility` - Accessibility: UserWay, One Click Accessibility, Ally by Elementor, AudioEye, OneTap, WP Accessibility, accessiBe, Enable, Siteimprove, EqualWeb and 13 more
- `examples/hosting` - Hosting & CDN: Cloudflare, Fastly, Google Cloud, Hostinger, Plesk, Vercel, Amazon CloudFront, OVHcloud, Netlify, SiteGround and 27 more
- `examples/webtech` - Servers & languages: LiteSpeed, OpenResty, ASP.NET, Microsoft IIS, LiteSpeed Cache, Varnish, WP Rocket, Express, PHP 8.3, PHP 8.2 and 49 more
- `examples/cdn-libs` - Library, font & image CDNs: Google Fonts, cdnjs, jsDelivr, Google Hosted Libraries, BootstrapCDN, Adobe Fonts, jQuery CDN, Gravatar, unpkg, Jetpack Site Accelerator and 20 more
- `examples/frontend` - JavaScript libraries: jQuery Migrate, js-cookie, core-js, jQuery UI, Waypoints, jQuery Easing, Underscore.js, lazysizes, Superfish, MediaElement.js and 29 more
- `examples/css` - CSS frameworks, fonts & icons: Bootstrap, Font Awesome, Lucide, Bootstrap Icons, Material Icons, Normalize.css, Tailwind CSS, Web Font Loader, Glyphicons, Ionicons and 24 more
- `examples/ui` - Sliders & UI components: Swiper, imagesLoaded, OWL Carousel, Slick, Magnific Popup, Fancybox, Popper, Isotope, Select2, jQuery Validation and 30 more
- `examples/charts` - Animation, charts & maps: Animate.css, WOW.js, AOS, GSAP, particles.js, Jarallax, Leaflet, Typed.js, Anime.js, Chart.js and 20 more
- `examples/frameworks` - JS frameworks: Next.js, React, Nuxt, Vue.js, Svelte, Hotwire Turbo, Angular, Backbone.js, Inertia, Knockout and 17 more
- `examples/widgets` - Widgets: YouTube, Facebook, Google Maps, X (Twitter), Smash Balloon Instagram Feed, Vimeo, GTranslate, Google Translate, AddToAny, Elfsight and 50 more
- `examples/cms` - CMS: WordPress, Joomla, Drupal, TYPO3, 1C-Bitrix, Adobe Experience Manager, Z-BlogPHP, Contao, Gnuboard, DedeCMS and 63 more
- `examples/wordpress` - WordPress themes & plugins: Elementor, Divi, WPBakery, Astra, Flatsome, Avada, GeneratePress, Kadence, OceanWP, Blocksy and 11 more
- `examples/headless` - Headless CMS & static sites: Astro, Hugo, Sanity, Jekyll, Gatsby, Ghost, Sphinx, Contentful, Hexo, Prismic and 10 more
- `examples/site-builders` - Site builders: Wix, Squarespace, WordPress.com, GoDaddy Website Builder, Duda, Tilda, Weebly, Webflow, Hostinger Website Builder, HighLevel and 46 more
- `examples/ecommerce` - Shop platforms: WooCommerce, Shopify, OpenCart, Wix Stores, PrestaShop, Magento (Adobe Commerce), Odoo, Cafe24, Tiendanube (Nuvemshop), BASE and 64 more
- `examples/payments` - Payments: Stripe, PayPal, Razorpay, Braintree, iyzico, Google Pay, Klarna, Apple Pay, Authorize.net, Square and 30 more
- `examples/discontinued` - Discontinued, still running: Universal Analytics, PHP 7, PHP 5, PHP 8.1, PHP 8.0, AngularJS, AddThis, SWFObject, Google PageSpeed, Google+ buttons and 20 more

## Clusters

Keep a set of sites, compare it against next month's, and read fields off every site in it.

- `clusters` - Clusters: What they are for; In detail; Worked examples
- `clusters/creating` - Creating a cluster: From search results; From a file; From other clusters; Reading a cluster back
- `clusters/extraction` - Extraction: What it reads; Presets and your own patterns; Getting the result out; Filtering searches with a cluster
- `clusters/limits` - Limits: How extraction is counted
- `clusters/example-widgets` - Example: tracking a widget change
- `clusters/example-contacts` - Example: extracting phones and emails

## API

Search from your own code. JSON, XML, CSV, NDJSON and TSV, with a key and a plan.

- `api` - API: In one command; Endpoints; What it promises; Getting a key
- `api/authentication` - Authentication: Why not `?key=`; Checking a key works; What can go wrong; OAuth 2.1 for applications; Identifying the application; The flow; How long a token lives; OAuth errors
- `api/requests` - Making requests: Parameters; GET; POST; The response; A row; Paging and bulk
- `api/formats` - Response formats: Which to use; ndjson; Choosing the columns; Details of the flat formats; Formats and errors
- `api/limits` - Quotas and rate limits: Rate limit: ten requests per minute; Daily quota; Result depth; Reading the current state; Usage statistics
- `api/errors` - Errors: Every code; What to do about each; Errors and formats; Reading the codes without reading this page
- `api/clusters` - Clusters: The endpoints; Creating a cluster; Combining clusters; Extracting data; A whole cluster, in code; Python; JavaScript (Node 18+); PHP; Go; Ruby; Errors
- `api/examples` - Code examples: curl; Python; Streaming a large result set; PHP; JavaScript (Node); Go; Ruby; Loading into a spreadsheet or a shell pipeline; Things worth getting right
- `api/sheets` - Google Sheets: Setting it up; Writing the query; The functions; Exporting a whole query; When a cell says #ERROR!
- `api/clay` - Clay: Does this company's site use it?; A table of companies from one search; Searches and speed
- `api/legacy` - The old export urls: Why they are separate; Moving a script over

## MCP Server

Let an AI assistant search page source for you: Claude, ChatGPT, Cursor, VS Code and more.

- `mcp` - MCP Server: What the assistant can do; Connecting your client; Who can use it
- `mcp/connecting` - Signing in: Sign in with OAuth; Or use a token; How long access lasts; What the assistant gets
- `mcp/claude` - Claude: Claude on the web and in the desktop app; Claude Code
- `mcp/chatgpt` - ChatGPT: Adding the server; Using it
- `mcp/editors` - Code editors and CLI agents: VS Code; Cursor; Devin Desktop (formerly Windsurf); Gemini CLI; Codex CLI; DeepSeek Harness; Anything else
- `mcp/automation` - n8n, Make and Zapier: n8n; Make; Zapier; Into a CRM: HubSpot, Pipedrive, Salesforce; What to watch
- `mcp/tools` - Tools: A search result; Getting more than one page; Clusters and extraction
- `mcp/limits` - Limits and errors: Limits; Errors; When the assistant cannot connect
- `mcp/developers` - For developers: The protocol as we serve it; Calling it with curl

## Use Cases

Where PublicWWW has been put to work: research papers, security investigations, marketing, OSINT and videos.

- `use-cases` - Use Cases
- `use-cases/papers` - Academic papers
- `use-cases/marketing` - Marketing, sales & SEO
- `use-cases/osint` - OSINT & investigations
- `use-cases/security` - Security research
- `use-cases/cryptojacking` - Cryptojacking
- `use-cases/videos` - Videos & courses

## Languages

The site in thirteen languages, and which characters a search matches.

- `languages` - Languages: The site in your language; What a search matches; Finding sites in a language or a country; Language of the page; Character set; Country domain and a local service

## Plans and Pricing

- `prices` - Pricing: Free; Pro; Business; Enterprise; Compare Plans; Frequently Asked Questions

## Support

What these pages do not answer - an account, a payment, a problem with the site - goes to support by email: support@publicwww.com