Hits

POST

rest

hits

curl -X POST "https://api.hibonsai.com/rest/hits/" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"organization":"organization-uuid","eventDate":"2024-01-01T00:00:00Z","classification":"search"}'

Endpoint

POST /rest/hits/

Request Body Parameters

string

required

Organization UUID associated with the event.

timestamp

required

ISO 8601 event timestamp.

string

required

Event classification (for example, search).

string

HTTP method of the request (for example, GET, POST).

string

Request path (for example, /search).

string

Full URL of the request including query parameters.

string

User agent string from the request header.

string

IP address of the client making the request.

number

Bot detection score between 0 and 1. Higher values indicate greater likelihood of bot traffic.

boolean

Whether the request is from a verified bot (for example, search engine crawlers).

object

Request headers object.

object

Cloudflare-specific metadata object.

curl -X POST "https://api.hibonsai.com/rest/hits/" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"organization":"organization-uuid","eventDate":"2024-01-01T00:00:00Z","classification":"search"}'

{
  "organization": "organization-uuid",
  "eventDate": "2024-01-01T00:00:00Z",
  "method": "GET",
  "path": "/search",
  "url": "https://example.com/search?q=query",
  "userAgent": "Mozilla/5.0...",
  "classification": "search",
  "clientIp": "192.168.1.1",
  "botScore": 0.95,
  "verifiedBot": false,
  "headers": {},
  "cf": {}
}

Response

Returns the created hit record with id, createdAt, and updatedAt fields.

curl -X POST "https://api.hibonsai.com/rest/hits/" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"organization":"organization-uuid","eventDate":"2024-01-01T00:00:00Z","classification":"search"}'

REST API

MCP Server

Endpoint

Request Body Parameters

Response

​Endpoint

​Request Body Parameters

​Response

Endpoint

Request Body Parameters

Response