API Reference
Build custom integrations with the Loamly API
The Loamly API provides programmatic access to your analytics data. Use it to build custom dashboards, sync data to your CRM, or integrate with internal tools.
Base URL
All API endpoints are available at
https://api.loamly.ai/v1Getting started
- Authentication — Create an API key and learn how to authenticate requests
- Endpoints — Explore available endpoints for visitors, mentions, and analytics
- Webhooks — Set up real-time notifications for events
Quick example
Fetch recent visitors with a simple API call:
curl -X GET "https://api.loamly.ai/v1/visitors?limit=10" \
-H "Authorization: Bearer loam_sk_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json"Response:
{
"data": [
{
"id": "vis_abc123",
"first_seen": "2024-12-18T10:30:00Z",
"source": "chatgpt",
"intent": "solution_comparison",
"pages_viewed": 5,
"converted": true
}
],
"meta": {
"total": 1234,
"limit": 10,
"offset": 0
}
}Available endpoints
| Endpoint | Description |
|---|---|
GET /visitors | List visitors with filtering |
GET /visitors/:id | Get a specific visitor |
GET /visitors/:id/timeline | Get visitor activity timeline |
GET /mentions | List AI mentions |
GET /analytics/overview | Get aggregate metrics |
GET /analytics/traffic | Get traffic breakdown |
GET /intelligence/score | Get AI Positioning Score |
GET /intelligence/ranking | Get competitive ranking |
See the Endpoints reference for full documentation.
Rate limits
| Plan | Limit |
|---|---|
| Free | 100 requests/minute |
| Pro | 1,000 requests/minute |
| Enterprise | Custom |
Need help?
Questions about the API? Contact us at support@loamly.ai or use the chat in your dashboard.