# Pugmill AEO — Bot Intelligence Network

> Real-time, anonymized data on how AI answer engines, search bots, and training crawlers are reading content across the web.

## What this site is

Pugmill AEO aggregates opt-in, anonymous signals from WordPress publishers running the [WP Pugmill plugin](https://wppugmill.com). It surfaces network-wide trends about bot behavior — which bots are crawling, what content types they request, and what content characteristics they encounter most.

Data is processed every 15 minutes and cached hourly. No personal data is collected. All contributions are anonymous.

## API

The full dataset is available as JSON:

- **Endpoint**: https://pugmillaeo.com/api/report
- **Method**: GET
- **Format**: JSON
- **Cache**: 1 hour (s-maxage=3600)

### Response shape

```json
{
  "generated": "2026-04-08",
  "sites_contributing": 42,
  "categories": {
    "ai":       { "total": 12400, "sites": 31, "change_pct": 14 },
    "search":   { "total":  8900, "sites": 38, "change_pct": -2 },
    "seo":      { "total":  3200, "sites": 22, "change_pct":  5 },
    "training": { "total":  2100, "sites": 18, "change_pct": 21 }
  },
  "last_30_days": {
    "ChatGPT": { "html": 8400, "llms_txt": 320, "robots_txt": 210 },
    "Googlebot": { "html": 6100, "sitemap": 180 }
  },
  "signals": {
    "ChatGPT": {
      "word_count":        { "1500+": { "tally_sum": 840, "site_count": 18 } },
      "content_freshness": { "0-7d":  { "tally_sum": 420, "site_count": 12 } }
    }
  }
}
```

### Categories

- **ai** — AI answer engines (ChatGPT, Claude, Perplexity, Gemini, etc.)
- **search** — Traditional search indexers (Googlebot, Bingbot, etc.)
- **seo** — Commercial SEO tools (Semrush, Ahrefs, etc.)
- **training** — Model training crawlers (CCBot, Bytespider, Grok, etc.)

### Signal metrics

- **word_count** — Content length at crawl time: `<500`, `500-1500`, `1500+`
- **content_freshness** — Age since publish: `0-7d`, `8-30d`, `31-90d`, `90d+`
- **fact_density** — Concentration of verifiable claims: `low`, `medium`, `high`
- **url_depth** — Path depth in site hierarchy: `shallow`, `medium`, `deep`
- **url_type** — WordPress content type: `post`, `page`, `category`, `tag`, etc.

## AEO content on contributing sites

Sites in this network may serve AEO-optimized content formats:

- `/llms.txt` — site summary for AI crawlers
- `/llms-full.txt` — full content export
- `/post-markdown/[slug]` — individual posts as Markdown
- `/site-summary` — structured site overview

## About WP Pugmill

WP Pugmill is a free WordPress plugin that adds AEO support to any WordPress site — generating llms.txt, Markdown endpoints, and structured summaries — while optionally contributing anonymized bot signal data to this network.

Plugin info: https://wppugmill.com