Skip to main content
Send bot visit data to Siteline from any backend using a simple GET 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

GET https://api.siteline.ai/v1/intake/pageview
All parameters are passed as query string parameters. Requests must be made over HTTPS.

​
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
required
The Referer header from the incoming request. Pass an empty string if none.
​
ip
string
required
The visitor’s IP address.
​
websiteKey
string
required
Your Siteline website key.

​
Example

curl --request GET \
  "https://api.siteline.ai/v1/intake/pageview\
?url=https://yoursite.com/blog/post\
&userAgent=Mozilla/5.0%20(compatible;%20ChatGPT-User/1.0)\
&ref=\
&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
  • URL-encode all parameters — especially url and userAgent which may contain special characters

​
Troubleshooting

Verify that all required parameters are present and URL-encoded. Check that your websiteKey is correct.
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.