Skip to main content
GET
https://searchcompany-main.up.railway.app
/
api
/
bot-visits
/
{business_id}
/
stats
curl https://searchcompany-main.up.railway.app/api/bot-visits/nike/stats?days=30 \
  -H "Authorization: Bearer $API_KEY"
{
  "business_id": "nike",
  "item_id": null,
  "total_visits": 156,
  "unique_platforms": 6,
  "platforms": {
    "chatgpt": {"total_visits": 42},
    "claude": {"total_visits": 28},
    "gemini": {"total_visits": 35},
    "perplexity": {"total_visits": 19},
    "copilot": {"total_visits": 22},
    "deepseek": {"total_visits": 5},
    "grok": {"total_visits": 3},
    "google_ai": {"total_visits": 2}
  },
  "period_start": "2025-11-10T00:00:00Z",
  "period_end": "2025-12-10T00:00:00Z"
}
Returns visit counts broken down by AI platform for the “What We’re Doing” dashboard card. Shows how many times each AI platform has recommended your business.

Path Parameters

business_id
string
required
Business/organization identifier

Query Parameters

item_id
string
Filter by product/item ID
days
integer
default:"7"
Number of days to look back (1-365)

Response

business_id
string
Business identifier
item_id
string
Product/item ID if filtered
total_visits
integer
Total visits across all platforms
unique_platforms
integer
Number of different AI platforms that visited
platforms
object
Visit counts per platform (chatgpt, claude, gemini, perplexity, copilot, deepseek, grok, google_ai)
period_start
datetime
Start of the reporting period
period_end
datetime
End of the reporting period
curl https://searchcompany-main.up.railway.app/api/bot-visits/nike/stats?days=30 \
  -H "Authorization: Bearer $API_KEY"
{
  "business_id": "nike",
  "item_id": null,
  "total_visits": 156,
  "unique_platforms": 6,
  "platforms": {
    "chatgpt": {"total_visits": 42},
    "claude": {"total_visits": 28},
    "gemini": {"total_visits": 35},
    "perplexity": {"total_visits": 19},
    "copilot": {"total_visits": 22},
    "deepseek": {"total_visits": 5},
    "grok": {"total_visits": 3},
    "google_ai": {"total_visits": 2}
  },
  "period_start": "2025-11-10T00:00:00Z",
  "period_end": "2025-12-10T00:00:00Z"
}

Dashboard Usage

This endpoint powers the “What We’re Doing” card on the dashboard, showing:
  • Total AI recommendations received
  • Breakdown by AI platform
  • Trend over selected time period
The data comes from AI bots visiting your optimized site and blog posts, which are tracked via the embedded tracking script that calls /api/ai-recommendation-store.