Skip to main content
GET
https://api.keywordsai.co
/
api
/
users
/
list
import requests
from urllib.parse import urlencode

base_url = "https://api.keywordsai.co/api/users/list/"
params = {
    "page": 1,
    "page_size": 50,
    "sort_by": "-first_seen",
    "environment": "prod",
}
url = f"{base_url}?{urlencode(params)}"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, headers=headers)
print(response.json())

{
  "count": 51,
  "next": "https://api.keywordsai.co/api/users/list/?page=2",
  "previous": null,
  "results": [
    {
      "id": "user_123prod8264a3f4-40c7-476a-97d1-96908127ea21",
      "unique_organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
      "customer_identifier": "user_123",
      "environment": "prod",
      "name": "John Doe",
      "email": "[email protected]",
      "first_seen": "2025-10-15T08:00:00Z",
      "last_active_timeframe": "2025-12-29T10:30:00Z",
      "active_days": 75,
      "number_of_requests": 15420,
      "total_tokens": 170000,
      "total_cost": 523.45,
      "average_latency": 1.23,
      "average_ttft": 0.45
    }
  ]
}
The Users List endpoint allows you to retrieve customers with pagination and sorting.

​
Authentication

Use your Keywords AI API key in Authorization: Bearer YOUR_API_KEY.

​
Query params

You can add these params to the URL params. For example: 
https://api.keywordsai.co/api/users/list/?page=1&page_size=50&sort_by=-first_seen&environment=prod
​
page
number
default:1
Page number.
​
page_size
number
default:50
The number of customers to return per page. Maximum is 1000.
​
sort_by
string
default:"-first_seen"
Sort field. Prefix with - for descending.Examples: customer_identifier, -total_cost, email, -number_of_requests.
​
environment
string
default:"prod"
Filter by environment. Options: prod, test.

​
Request example

import requests
from urllib.parse import urlencode

base_url = "https://api.keywordsai.co/api/users/list/"
params = {
    "page": 1,
    "page_size": 50,
    "sort_by": "-first_seen",
    "environment": "prod",
}
url = f"{base_url}?{urlencode(params)}"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, headers=headers)
print(response.json())

​
Response

{
  "count": 51,
  "next": "https://api.keywordsai.co/api/users/list/?page=2",
  "previous": null,
  "results": [
    {
      "id": "user_123prod8264a3f4-40c7-476a-97d1-96908127ea21",
      "unique_organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
      "customer_identifier": "user_123",
      "environment": "prod",
      "name": "John Doe",
      "email": "[email protected]",
      "first_seen": "2025-10-15T08:00:00Z",
      "last_active_timeframe": "2025-12-29T10:30:00Z",
      "active_days": 75,
      "number_of_requests": 15420,
      "total_tokens": 170000,
      "total_cost": 523.45,
      "average_latency": 1.23,
      "average_ttft": 0.45
    }
  ]
}