Plausible

Plausible Events API

Submit pageviews and custom events.

Documentation GitHub OpenAPI

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/plausible-events-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.0.3
info:
  title: Plausible CustomProps Events API
  description: The Plausible Events API allows server-side and non-browser clients to send pageviews and custom events to Plausible.
  version: 1.0.0
  contact:
    name: Plausible Support
    url: https://plausible.io/contact
  license:
    name: AGPL-3.0
    url: https://github.com/plausible/analytics/blob/master/LICENSE.md
servers:
- url: https://plausible.io
  description: Plausible Cloud
tags:
- name: Events
  description: Submit pageviews and custom events.
paths:
  /api/event:
    post:
      tags:
      - Events
      summary: Record a pageview or custom event
      description: Sends a pageview or a custom event to Plausible. The User-Agent and client IP are used to compute a privacy-preserving visitor identifier.
      operationId: recordEvent
      parameters:
      - in: header
        name: User-Agent
        required: true
        schema:
          type: string
        description: Used to derive the visitor identifier.
      - in: header
        name: X-Forwarded-For
        required: false
        schema:
          type: string
        description: Client IP address; defaults to the sender's remote IP.
      - in: header
        name: X-Debug-Request
        required: false
        schema:
          type: boolean
        description: When true, returns the IP used for visitor counting.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EventRequest'
      responses:
        '202':
          description: Event accepted (always returned, even if dropped).
        '400':
          description: Bad request.
components:
  schemas:
    EventRequest:
      type: object
      required:
      - domain
      - name
      - url
      properties:
        domain:
          type: string
          description: The site's domain registered in Plausible.
        name:
          type: string
          description: Event name. Use "pageview" for pageviews; any other value is a custom event.
          example: pageview
        url:
          type: string
          description: URL of the page where the event was triggered.
        referrer:
          type: string
          description: The referrer URL.
        props:
          type: object
          additionalProperties:
            oneOf:
            - type: string
            - type: number
            - type: boolean
          description: Custom properties (max 30 key/value pairs).
        revenue:
          type: object
          properties:
            currency:
              type: string
              example: USD
            amount:
              type: number
              example: 19.99
        interactive:
          type: boolean
          description: Indicates whether the event affects bounce rate.