Skip to main content
GET
/
agent-analytics
/
logs
List Agent logs
curl --request GET \
  --url https://api.peec.ai/customer/v1/agent-analytics/logs \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "bot_id": "AppleBot",
      "timestamp": "2025-01-01 00:01:02.000",
      "request_method": "GET",
      "request_host": "example.com",
      "request_path": "/path",
      "response_status": 200,
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Safari/605.1.15 (Applebot/0.1; +http://www.apple.com/go/applebot)",
      "client_ip": "127.0.0.1",
      "referer": "notexample.com"
    }
  ],
  "totalCount": 100
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
project_id
string

Required if using a company api key

Example:

"or_f45b94ba-5e35-4982-93ed-285e72ee14eb"

​
limit
number
default:1000
Required range: 1 <= x <= 10000
​
offset
number
default:0
Required range: x >= 0
​
start_date
string<date>
default:2026-01-01

full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Example:

"2025-09-22"

​
end_date
string<date>
default:2026-01-01

full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Example:

"2025-09-22"

​
bot_ids
enum<string>[]

List of bot IDs to filter by. you will get it from /agent-analytics/bots

Available options:
GPTBot,
anthropic-ai,
Google-Extended,
Meta-ExternalAgent,
Applebot-Extended,
Amazonbot,
Bytespider,
CCBot,
Ai2Bot,
Ai2Bot-Dolma,
cohere-ai,
cohere-training-data-crawler,
DeepSeekBot,
PanguBot,
Webzio-Extended,
Diffbot,
FacebookBot,
omgili,
Timpibot,
GrokBot,
OAI-SearchBot,
Claude-SearchBot,
PerplexityBot,
Amzn-SearchBot,
AzureAI-SearchBot,
Google-CloudVertexBot,
meta-webindexer,
Applebot,
Grok-DeepSearch,
xAI-Grok,
ChatGPT-User,
Claude-User,
Perplexity-User,
Manus-User,
GoogleAgent-Mariner,
NovaAct,
Gemini-Deep-Research,
MistralAI-User,
DuckAssistBot,
quillbot.com,
meta-externalfetcher,
Claude-Code,
MyCentralAIScraperBot,
Google-Agent,
omgilibot,
ClaudeBot,
Claude-Web,
YouBot
Example:
["AppleBot", "GoogleBot"]

Response

200 - application/json

Response for status 200

​
data
object[]
required
​
totalCount
number
required

Total number of agent logs in storage

Example:

100