Public API Reference

Access your LogLens analytics data programmatically. Build custom dashboards, integrate with your tools, or automate reporting.

Base URL

https://api.loglens.ai

1 Authentication

All API requests require authentication using an API key. API keys can be created in your Organization Settings.

Pass your API key in the Authorization header:

Request Header 
Authorization: Bearer llapi_your_api_key_here

Note: API keys start with llapi_ to distinguish them from ingest keys.

2 Rate Limits

Rate limits are applied per organization, per hour. The limit depends on your plan:

Plan Requests/Hour
Free No API access
Starter 100
Professional 500
Enterprise 2,000

Rate limit headers are included in every response: 

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 499
X-RateLimit-Reset: 2024-01-21T18:00:00Z

3 Error Handling

The API uses standard HTTP status codes and returns JSON error responses:

Status Description
200 Success
401 Invalid or missing API key
403 API access not available on your plan
404 Website not found
429 Rate limit exceeded
500 Internal server error
Error Response Example 
{
  "detail": "Rate limit exceeded",
  "limit": 100,
  "reset_at": "2024-01-21T18:00:00Z"
}
GET

List Websites

Returns all websites accessible to your API key.

Endpoint 
GET /public/v1/websites

Response

{
  "websites": [
    {
      "id": "ws_abc123",
      "domain": "example.com",
      "name": "Main Website",
      "created_at": "2024-01-01T00:00:00Z"
    }
  ],
  "count": 1
}
GET

Get Summary

Returns summary statistics for a website.

Endpoint 
GET /public/v1/websites/{website_id}/summary

Parameters

Name Type Description
hours integer Time period in hours (default: 24, max: 8760)
GET

Get Traffic

Returns traffic data with hourly breakdown. 

GET /public/v1/websites/{website_id}/traffic?hours=24
GET

Get Bots

Returns bot analytics including identification and verification status. 

GET /public/v1/websites/{website_id}/bots?hours=24
GET

Get Paths

Returns path/URL analytics sorted by request count. 

GET /public/v1/websites/{website_id}/paths?hours=24&limit=100

Parameters

Name Type Description
hours integer Time period (default: 24)
limit integer Max results (default: 100, max: 1000)
GET

Get Geography

Returns geographic distribution of traffic by country and city. 

GET /public/v1/websites/{website_id}/geography?hours=24
GET

Get Status Codes

Returns HTTP status code distribution with hourly breakdown. 

GET /public/v1/websites/{website_id}/status-codes?hours=24
GET

Get IPs

Returns IP address and IP range analytics. 

GET /public/v1/websites/{website_id}/ips?hours=24
GET

Get Referrers

Returns referrer domain analytics - see which sites are sending traffic to you. 

GET /public/v1/websites/{website_id}/referrers?hours=24&limit=100

Query Parameters

  • hours - Time period (1-8760, default: 24)
  • limit - Maximum referrers to return (1-500, default: 100)
GET

Get Devices

Returns device, browser, and operating system analytics. 

GET /public/v1/websites/{website_id}/devices?hours=24

Response includes

  • browsers - Browser breakdown (Chrome, Safari, Firefox, etc.)
  • operating_systems - OS breakdown (Windows, macOS, iOS, Android, etc.)
  • device_types - Device type breakdown (Desktop, Mobile, Tablet)
GET

Get SEO Stats

Returns search engine crawler statistics - Googlebot, Bingbot, etc. 

GET /public/v1/websites/{website_id}/seo?hours=24&bot=googlebot

Query Parameters

  • hours - Time period (1-8760, default: 24)
  • bot - Filter by specific bot (optional, e.g. "googlebot", "bingbot")

Response includes

  • crawler_requests - Total crawler requests
  • verified_requests - Verified (legitimate) crawler requests
  • unverified_suspicious - Potentially spoofed crawler requests
  • avg_response_time_ms - Average response time to crawlers
  • top_crawlers - Breakdown by crawler
GET

LLM Crawler Analytics

Get LLM and AI crawler activity for your website.

Endpoint 
GET /public/v1/websites/{website_id}/llms?start_date=2024-01-01&end_date=2024-01-31

Parameters

Name Type Description
start_date string Start date in YYYY-MM-DD format
end_date string End date in YYYY-MM-DD format

Response

{
  "llm_crawlers": [
    {
      "bot_name": "GPTBot",
      "requests": 12847,
      "pages_accessed": 3421,
      "avg_response_time": 245.3,
      "verified": true,
      "first_seen": "2024-01-02T08:14:22Z",
      "last_seen": "2024-01-31T22:41:09Z"
    },
    {
      "bot_name": "ClaudeBot",
      "requests": 8234,
      "pages_accessed": 2105,
      "avg_response_time": 189.7,
      "verified": true,
      "first_seen": "2024-01-05T11:32:48Z",
      "last_seen": "2024-01-31T19:58:33Z"
    }
  ]
}
GET

Get Sitemap Coverage

Returns sitemap coverage data - tracks which URLs from your sitemap have been crawled by search engines, their crawl frequency, and current status.

Endpoint 
GET /public/v1/websites/{website_id}/seo/sitemap?page=1&page_size=50&status=never_crawled

Query Parameters

  • page - Page number (default: 1)
  • page_size - Results per page (1-500, default: 50)
  • status - Filter: all, never_crawled, recently_crawled, stale, not_in_sitemap
  • sort - Sort by: path, times_crawled, last_crawled, first_seen
  • sort_dir - Sort direction: asc, desc

Response fields (per URL)

  • url - Full URL from sitemap
  • status - Crawl status: crawled or not_crawled
  • last_crawl_date - Timestamp of most recent crawl
  • crawl_count - Total number of times this URL has been crawled
  • content_type - Content type of the URL (e.g. text/html)
  • response_code - HTTP response code from last crawl
GET

Index Coverage

Get Google index coverage summary for your website.

Endpoint 
GET /public/v1/websites/{website_id}/index-coverage

Response

{
  "buckets": {
    "crawled_indexed": 1842,
    "crawled_not_indexed": 356,
    "not_crawled_indexed": 23,
    "not_crawled_not_indexed": 491
  }
}
GET

Index Coverage URLs

Get paginated list of URLs in an index coverage bucket.

Endpoint 
GET /public/v1/websites/{website_id}/index-coverage/urls?bucket=crawled_indexed&page=1&page_size=50

Parameters

Name Type Description
bucket string Required. One of: crawled_indexed, crawled_not_indexed, not_crawled_indexed, not_crawled_not_indexed
page integer Page number (default: 1)
page_size integer Results per page (default: 50)

Response

{
  "urls": [
    {
      "url": "https://example.com/blog/post-1",
      "last_crawl_date": "2024-01-28T14:22:00Z",
      "last_status_code": 200
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1842
}
GET

List Exports

List data export jobs for your website.

Endpoint 
GET /public/v1/websites/{website_id}/exports

Response

{
  "exports": [
    {
      "id": "exp_abc123",
      "status": "completed",
      "created_at": "2024-01-20T10:30:00Z",
      "download_url": "https://api.loglens.ai/public/v1/exports/exp_abc123/download"
    }
  ]
}
POST

Create Export

Create a new data export job.

Endpoint 
POST /public/v1/websites/{website_id}/exports

Request Body

Name Type Description
type string Export type: traffic, bots, paths, ips, status_codes, referrers, devices
start_date string Start date in YYYY-MM-DD format
end_date string End date in YYYY-MM-DD format
format string Export format: csv (default: csv)

Response

{
  "id": "exp_def456",
  "status": "pending"
}
GET

List Alerts

Get alert history for your website.

Endpoint 
GET /public/v1/websites/{website_id}/alerts

Response

{
  "alerts": [
    {
      "id": "alt_abc123",
      "type": "traffic_spike",
      "severity": "warning",
      "message": "Traffic increased 340% compared to baseline",
      "created_at": "2024-01-20T14:22:00Z",
      "acknowledged": false
    }
  ]
}
GET

Get Alert Configuration

Get current alert configuration.

Endpoint 
GET /public/v1/websites/{website_id}/alerts/config

Response

{
  "traffic": {
    "enabled": true,
    "spike_threshold_percent": 200,
    "drop_threshold_percent": 50
  },
  "error": {
    "enabled": true,
    "error_rate_threshold_percent": 5,
    "status_codes": [500, 502, 503, 504]
  },
  "bot": {
    "enabled": true,
    "unverified_bot_threshold_percent": 30,
    "new_bot_detection": true
  }
}
GET

Search IP Requests

Returns all requests made by a specific IP address. Useful for investigating suspicious activity. 

GET /public/v1/websites/{website_id}/ips/{ip_address}/requests?hours=24&page=1

Query Parameters

  • hours - Time period (1-168, default: 24, max 7 days)
  • page - Page number (default: 1)
  • page_size - Results per page (1-500, default: 50)

Response includes (for each request)

  • timestamp - Request timestamp
  • path - URL path requested
  • method - HTTP method
  • status - HTTP status code
  • user_agent - User agent string
  • is_bot - Whether request was from a bot

Example Usage

$ cURL 

curl -X GET \
  "https://api.loglens.ai/public/v1/websites" \
  -H "Authorization: Bearer llapi_your_key_here"

JS JavaScript / Node.js 

const response = await fetch(
  'https://api.loglens.ai/public/v1/websites',
  {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  }
);
const data = await response.json();
console.log(data.websites);

PY Python 

import requests

response = requests.get(
    "https://api.loglens.ai/public/v1/websites",
    headers={"Authorization": f"Bearer {api_key}"}
)
data = response.json()
print(data["websites"])