SEsearchable
Traffic

Get raw request logs

Changed on

The raw request feed with the in-app Logs tab's filters (path, status code, bots-only, host, sitemap-only). Cursor-paginated: pass the previous response's nextCursor.timestamp and nextCursor.event_id back as cursorTimestamp and cursorEventId. limit defaults to 25, max 100.

ip_address and user_agent are deliberately not returned — the IP is personal data with no analytical value once country is present, and the user-agent is superseded by the resolved botName / botVendor.

get/api/mcp/projects/{projectId}/traffic/logs

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

fromstring
Example:2026-03-01

Start of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires to, and is mutually exclusive with days — sending both returns 400 invalid_argument. A range longer than the endpoint's maximum is rejected rather than clamped.

tostring
Example:2026-03-31

End of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires from.

hoststring
Example:blog.acme.com

Comma-separated hostnames to narrow the report to. Useful on multi-domain projects; omit for every host in the project.

limitinteger

Page size. Defaults and caps vary by endpoint (see each operation's description); big list endpoints (cited domains/URLs, prompts, opportunities) cap at 1000, issues at 5000. Values above an endpoint's cap are clamped server-side, never rejected.

pathstring

Substring match on the request path.

statusCodeinteger

Exact HTTP status code.

botsOnlyboolean

Restrict to crawler requests.

onlyInSitemapboolean

Restrict to sitemap-listed paths.

cursorTimestampstring

The previous page's nextCursor.timestamp.

cursorEventIdstring

The previous page's nextCursor.event_id.

Response

A page of raw request events.

hasMoreboolean required

Changes