Rybbit

Rybbit Sessions API

Session-level analytics and cohort retention.

Documentation GitHub OpenAPI

Business capability

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/sites/{site}/sessions List sessions on a site · List sessions for a site #

Ask an LLM

“How do I list all the visits to my site between two dates?”

“Can I show only sessions from identified users, not anonymous ones?”

Tell an agent

List sessions on site {site} from {start_date} to {end_date}.

Show page {page} of site {site}'s sessions, {limit} at a time, in time zone {time_zone}.

GET /api/sites/{site}/sessions/{sessionId} Replay the pageviews and events of one session · Get a single session #

Ask an LLM

“What pages did a visitor view, in order, during one specific session?”

“Can I see the ordered events that happened inside a single visit?”

Tell an agent

Get session {sessionId} on site {site}.

Show the pageviews and events of session {sessionId} for site {site}.

GET /api/sites/{site}/session-locations Map where a site's sessions come from · List session locations #

Ask an LLM

“Where in the world are my site's visits coming from?”

“Can I get geographic session data to plot on a map?”

Tell an agent

List session locations for site {site}.

Get the geographic spread of sessions on site {site} with filters {filters}.

GET /api/sites/{site}/retention Analyze cohort retention for a site · Get cohort retention #

Ask an LLM

“How many visitors come back after their first visit, grouped by cohort?”

“What does retention look like for users who first arrived in a given date range?”

Tell an agent

Get cohort retention for site {site}.

Show retention for site {site} between {start_date} and {end_date}.

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/rybbit:rybbit-sessions-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Rybbit Sessions API
  description: Rybbit is an open-source, privacy-friendly web and product analytics platform. This specification covers the public event ingestion endpoint (POST /api/track) used by the tracking script and server-side integrations, and the Bearer-key-authenticated Stats API (beta) for querying sites, sessions, users, retention, and events. The cloud base URL is https://app.rybbit.io; self-hosted instances expose the same paths on their own domain.
  termsOfService: https://www.rybbit.io/terms
  contact:
    name: Rybbit
    url: https://www.rybbit.io
  license:
    name: AGPL-3.0
    url: https://www.gnu.org/licenses/agpl-3.0.html
  version: '1.0'
servers:
- url: https://app.rybbit.io
  description: Rybbit Cloud
- url: https://your-instance.example.com
  description: Self-hosted instance (AGPL-3.0)
security:
- bearerAuth: []
tags:
- name: Sessions
  description: Session-level analytics and cohort retention.
paths:
  /api/sites/{site}/sessions:
    get:
      operationId: listSessions
      tags:
      - Sessions
      summary: List sessions for a site
      description: Returns a paginated list of sessions with their analytics data.
      parameters:
      - $ref: '#/components/parameters/Site'
      - name: page
        in: query
        schema:
          type: integer
          default: 1
      - name: limit
        in: query
        schema:
          type: integer
          default: 20
      - name: start_date
        in: query
        schema:
          type: string
          format: date
      - name: end_date
        in: query
        schema:
          type: string
          format: date
      - name: time_zone
        in: query
        schema:
          type: string
      - name: user_id
        in: query
        schema:
          type: string
      - name: identified_only
        in: query
        schema:
          type: boolean
      - $ref: '#/components/parameters/Filters'
      responses:
        '200':
          description: A paginated list of sessions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Session'
        '401':
          description: Unauthorized - missing or invalid API key.
        '403':
          description: Forbidden - no access to site.
  /api/sites/{site}/sessions/{sessionId}:
    get:
      operationId: getSession
      tags:
      - Sessions
      summary: Get a single session
      description: Returns session-level detail including the ordered list of pageviews and events.
      parameters:
      - $ref: '#/components/parameters/Site'
      - name: sessionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Session detail.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        '404':
          description: Not Found.
  /api/sites/{site}/session-locations:
    get:
      operationId: listSessionLocations
      tags:
      - Sessions
      summary: List session locations
      description: Returns geographic location data for sessions, suitable for map visualizations.
      parameters:
      - $ref: '#/components/parameters/Site'
      - $ref: '#/components/parameters/Filters'
      responses:
        '200':
          description: Session location data.
  /api/sites/{site}/retention:
    get:
      operationId: getRetention
      tags:
      - Sessions
      summary: Get cohort retention
      description: Returns cohort-based retention analysis. Users are grouped into cohorts by first visit and retention is tracked over subsequent time periods.
      parameters:
      - $ref: '#/components/parameters/Site'
      - name: start_date
        in: query
        schema:
          type: string
          format: date
      - name: end_date
        in: query
        schema:
          type: string
          format: date
      - $ref: '#/components/parameters/Filters'
      responses:
        '200':
          description: Cohort retention data.
components:
  parameters:
    Site:
      name: site
      in: path
      required: true
      description: The site ID (string or number) scoping the query.
      schema:
        type: string
    Filters:
      name: filters
      in: query
      required: false
      description: JSON-encoded array of filter objects to narrow results by browser, device, location, page data, UTM parameters, or user/event properties.
      schema:
        type: string
  schemas:
    Session:
      type: object
      properties:
        session_id:
          type: string
        user_id:
          type: string
        identified_user_id:
          type: string
        traits:
          type: object
          additionalProperties: true
        country:
          type: string
        region:
          type: string
        city:
          type: string
        browser:
          type: string
        operating_system:
          type: string
        device_type:
          type: string
        referrer:
          type: string
        channel:
          type: string
        entry_page:
          type: string
        exit_page:
          type: string
        pageviews:
          type: integer
        events:
          type: integer
        session_duration:
          type: number
        session_start:
          type: string
          format: date-time
        session_end:
          type: string
          format: date-time
        utm_source:
          type: string
        utm_medium:
          type: string
        utm_campaign:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'User-scoped API key with organization-level access. Keys begin with "rb_" and are 35 characters long. Send as `Authorization: Bearer rb_...`. A `?api_key=` query parameter is also accepted for quick testing only. API keys and rate limits apply to the Stats API on Rybbit Cloud; self-hosted instances have no rate limits.'

Rybbit Sessions API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification