---
title: "Ingest server-side SDK analytics event (page_visit)"
method: POST
path: "/api/v1/analytics/events"
tags: ["Visibility & Mentions"]
---

# Ingest server-side SDK analytics event (page_visit)

`POST /api/v1/analytics/events`

## Request

- Base URL: `https://app.promptingco.com`
- URL: `https://app.promptingco.com/api/v1/analytics/events`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

## Request body

- object
  - `event` 'page_visit', required
  - `occurredAt` string, date-time
  - `eventId` string
  - `sessionId` string, nullable
  - `anonymousId` string, nullable
  - `page` object, required
    - `href` string, uri, required
    - `domain` string
    - `pathname` string
    - `title` string, nullable
    - `canonicalUrl` string, uri, nullable
  - `request` object
    - `referrer` string, nullable
    - `userAgent` string, nullable
    - `clientIp` string, nullable
    - `method` string, nullable
  - `sdk` object
    - `name` string
    - `version` string
    - `runtime` string
  - `properties` object

## Response `200`

Successful response

- object
  - `ok` true, required
  - `data` object, required
    - `ok` true, required
    - `data` object, required
      - `accepted` true, required
      - `eventId` string, required
      - `status` 'accepted', required
      - `receivedAt` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Not found
- `422`: Validation failed
- `500`: Internal server error

---

[API](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api.md) - [All operations](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api/revisions/c0451ea10e9a?raw)