peregrine
DocsDemoGet started

Docs

Bots and filtering

A small site’s numbers are easy to distort. Twenty scanner hits are a rounding error for a big site and a fake “best day ever” for a new one. Peregrine filters in layers, and each layer is listed here.

Never recorded

  • Known bots and tools. Search crawlers, AI crawlers (GPTBot, ClaudeBot, Perplexity, Common Crawl), SEO tools (Ahrefs, Semrush), uptime monitors, link previews, Lighthouse, and scripts such as curl or python-requests. They are recognised by user agent.
  • Automated browsers. Playwright, Puppeteer and Selenium announce themselves through navigator.webdriver, and the tracker sends nothing from them.
  • Pages opened from disk. A file:// page sends nothing.
  • Unknown domains. Events for a domain no account has added are dropped.
  • Runaway clients. One visitor sending more than 60 events a minute, such as a page stuck in a reload loop, has the rest dropped.

Hidden, not deleted

Some scanners run a real Chrome with an ordinary user agent, and get past every check above. They have a shape, though: a burst of visitors who each open one page, arriving directly, all within the same minute.

Peregrine hides those waves from the dashboard: a direct visitor with exactly one event, when at least four others like them arrived within a minute of it. Nothing is deleted. It is decided each time the dashboard loads, so if one of them comes back and does anything else, they reappear with all their history. The dashboard says how many visitors it hid in the selected range.

Your plan’s event allowance counts every event, hidden ones included, because they were received.

What still gets through

  • A single scanner visit. One direct visit to one page looks exactly like a real person who left straight away, so it stays counted.
  • Your own visits. There is no switch to exclude yourself yet. Your first visit from each browser is one more Direct visitor.
  • Bots that hide well. A bot with a real browser, a believable pace and no announcement is indistinguishable from a person, here or anywhere else.

Ad blockers work the other way: some block the tracker, so some real visitors are never counted. Purchases are not affected, because they are read from your payment provider.

More docs

  • Install the tracker
  • Revenue attribution
  • Goals and custom events
  • Sale notifications on Telegram
  • How channels are decided
  • What is collected
  • Peregrine for Polar
  • Peregrine for Lemon Squeezy
  • Peregrine for Dodo Payments

Something missing? Write to us from the footer. Or see a real dashboard in the demo, or start a free trial.

peregrine
DemoDocsIntegrationsCompareUTM builderSign in
© 2026
TermsPrivacyDPA

Contact us

Something is broken or wrong

hello@justperegrine.com
Featured onFeatured on DanielLaunchesLaunched on LaunchPanda