Skip to main content
Send bot visit data to Siteline from any backend using a JSON POST request. Use this integration when you need full control over tracking or your stack isn’t covered by one of the platform-specific integrations.

​
Prerequisites

​
Endpoint

POST https://api.siteline.ai/v1/intake/pageview
Only POST requests with a JSON body are supported. Requests must be made over HTTPS.

​
Body parameters

​
url
string
required
The full URL of the page being accessed (e.g. https://yoursite.com/blog/post).
​
userAgent
string
required
The User-Agent header from the incoming request.
​
ref
string
The Referer header from the incoming request.
​
ip
string
required
The visitor’s IP address.
​
websiteKey
string
required
Your Siteline website key.

​
Example

curl --request POST \
  "https://api.siteline.ai/v1/intake/pageview" \
  --header "Content-Type: application/json" \
  --data '{
    "url": "https://yoursite.com/blog/post",
    "userAgent": "Mozilla/5.0 (compatible; ChatGPT-User/1.0)",
    "ref": "https://referrer.example",
    "ip": "1.2.3.4",
    "websiteKey": "secret_key_..."
  }'

​
Best practices

  • Track key pages only — blogs, landing pages, product pages, robots.txt, sitemap.xml
  • Skip static assets — images, CSS, JS, fonts don’t need to be tracked
  • Fire-and-forget — don’t await the response; send tracking calls asynchronously for zero impact on site speed
  • Keep sensitive fields out of URLs — send websiteKey and IP data only in the JSON body

​
Troubleshooting

Verify that all required body fields are present. Check that your websiteKey is correct and that the request includes Content-Type: application/json.
Navigate to Agent Analytics in your Siteline workspace and click Manage Configuration to view or regenerate your key.
No. Focus on content pages that AI bots are likely to crawl. Exclude static assets and internal API routes.
Need help? Book a setup call and we’ll walk you through it.