Overview
Scrunch’s Agent Traffic shows how LLM bots hit your site (e.g., ChatGPT, Perplexity, Gemini, Grok)—including volume over time, top pages, and recent requests. If your site is served by WordPress, you can use our plugin to send request logs straight to Scrunch over HTTPS, and no code is needed.
What You’ll See
Once your website is connected, the Agent Traffic dashboard will show:
Total Bot Traffic in the last period
Bot traffic over time
Traffic distribution between Retrieval, Indexer, and Training LLM Bots
Comparison between the current period and the last period (%)
Top bot agents and when they were last seen
Top content pages accessed by LLM bots
Recent bot requests
A date filter to see data from the last 24 hours, last 7 days, or last 30 days
Scrunch AI's Agent Traffic feature allows customers to granularly track which AI platforms are consuming their content (and for what purpose) to enable a better understanding of how their content:
will be surfaced in AI platforms like ChatGPT
drives AI responses to relevant questions
and ultimately, how it influences AI to describe and recommend their brand,
products and services, and click through to their site(s).
Adding Your Website
Open the Scrunch app
Go to the Agent Traffic menu
You’ll see the list of your websites connected to Agent Traffic
Click + Connect Site
Select WordPress as the platform
You’ll see an instructional page with your Webhook URL, Site ID, and API Key
Your page will look like this one:
Note the Webhook URL and X-API-Key values. You'll need them in the next step.
💡 Each site you connect to Agent Traffic will have its own endpoint and API key. Don’t reuse them across different sites or integration methods.
Installing Scrunch Bot Traffic Analytics plugin
Download the plugin ZIP: scrunch-bot-traffic-analytics.zip
In WordPress: Plugins → Add New → Upload Plugin
Upload the ZIP and Activate.
Go to Plugins → Scrunch Bot Traffic Analytics → Settings
You should see a configuration screen like this:
Update settings with your values:
Endpoint URL — Paste in the
Webhook URLfrom the Scrunch set-up instructions page.X-Api-Key — Paste in the
X-API-Keyvalue from the Scrunch set-up instructions page.
Once your endpoint URL and API key are configured, check the Enable sending checkbox to activate Agent Traffic capture.
Most customers won't need to edit the remaining settings, but if you have a heavily customized or high-traffic WordPress site, they may be of interest.
Sample rate (0.0–1.0) — This configures what percentage of traffic is logged to Agent Traffic. Very high traffic WordPress sites may wish to configure this to reduce system load or outbound network traffic. 0.0 means no traffic is sent, 1.0 means all traffic is sent, 0.5 means (a random sample of) 50% of traffic is sent, and so on.
Exclude paths (regex) — Paths to skip Agent Traffic capture for. You ordinarily will not need to customize this. Some AI bots may crawl your static assets (such as CSS or JavaScript files) to collect training data for future model training; however, these are usually less relevant from a marketing perspective.
Testing your integration
After saving the settings, the Health Check section will show up. You can test your integration by clicking on Sent Test Event.
This test event should be visible on your Bot Traffic Analytics page.
Troubleshooting and Tips
Don’t see any traffic?
Ensure the plugin is activated and the
Enabled sending (opt-in)field is checkedEnsure the API Key is correct
Wait up to 5 minutes—Scrunch may take a short time to detect your configuration
If it's still not working, check the error logs from WordPress and contact our support
Tips for better results:
Repeat the process if you manage multiple sites