Skip to main content

​
Step 1: Create an API Key

Create an API key in Promptwatch. Go to Settings → API Keys in your Promptwatch dashboard.

​
Step 2: Send HTTP Request Logs

Send your HTTP request logs to https://logs.promptwatch.com/event in the following format: Request: 
Method: POST
URL: https://logs.promptwatch.com/event
Content-Type: application/json
Headers: X-API-Key: YOUR_API_KEY
Body: [see below]
You can batch multiple events together in a single request by sending a JSON array. The maximum request size is 50MB. All properties need to be present for each event. query_string and referrer can be null. timestamp should be an ISO 8601 string. Example body: 
[
  {
    "timestamp": "2025-10-01T12:00:00.000Z",
    "status_code": 200,
    "request_method": "GET",
    "request_path": "/",
    "query_string": "search=test",
    "content_type": "text/html",
    "client_ip": "192.168.0.10",
    "hostname": "example.com",
    "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.1; +https://openai.com/gptbot)",
    "referrer": "https://www.google.com"
  }
]

​
Step 3: Finish

Once implemented on your end, view your crawler logs in the Promptwatch dashboard.