Documentation

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/v1

Getting started

  1. Authentication — Create an API key and learn how to authenticate requests
  2. Endpoints — Explore available endpoints for visitors, mentions, and analytics
  3. 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

EndpointDescription
GET /visitorsList visitors with filtering
GET /visitors/:idGet a specific visitor
GET /visitors/:id/timelineGet visitor activity timeline
GET /mentionsList AI mentions
GET /analytics/overviewGet aggregate metrics
GET /analytics/trafficGet traffic breakdown
GET /intelligence/scoreGet AI Positioning Score
GET /intelligence/rankingGet competitive ranking

See the Endpoints reference for full documentation.

Rate limits

PlanLimit
Free100 requests/minute
Pro1,000 requests/minute
EnterpriseCustom

Need help?

Questions about the API? Contact us at support@loamly.ai or use the chat in your dashboard.