Gainsight Segment API

Segment Operations

Documentation GitHub OpenAPI

Operations 2

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 /v1/segment List segments · Get segments #

Ask an LLM

“What user segments are defined in PX?”

“Can I page through segments?”

Tell an agent

List segments, page {pageNumber}.

Show the first {pageSize} segments.

GET /v1/segment/{segmentId} Get a segment · Get segment #

Ask an LLM

“How do I see one segment's definition?”

“Can I fetch a segment by ID?”

Tell an agent

Get segment {segmentId}.

Show the rules of segment {segmentId}.

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/gainsight-segment-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:
  description: Gainsight PX API provides a programmatic (server-based) method to access the users, accounts, and events that have been captured by the Gainsight PX subscription.
  version: 0.1.6
  title: Gainsight PX REST Segment API
  contact:
    name: Gainsight PX
    url: https://www.gainsight.com/product-experience/
    email: pxsupport@gainsight.com
  license:
    name: internal
servers:
- url: https://api.aptrinsic.com/
tags:
- name: Segment
  description: Segment Operations
paths:
  /v1/segment:
    get:
      tags:
      - Segment
      summary: Get segments
      description: 'Retrieves segments. Supports paging.

        Examples:


        | URI | Results |

        | ----- | -------- |

        | GET /v1/segment?pageSize=100 | Get first 100 segments. |

        | GET /v1/segment?pageSize=100&pageNumber=1 | Get next 100 segments. |'
      operationId: getSegmentsUsingGET
      parameters:
      - name: pageNumber
        in: query
        description: Page number
        required: false
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
          default: 0
      - name: pageSize
        in: query
        description: Number of segments per page
        required: false
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
          default: 25
          maximum: 200
          minimum: 1
      responses:
        '200':
          description: Success
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/SegmentsPage'
        '400':
          description: Bad request
        '401':
          description: Unauthorized or bad API Key
        '429':
          description: Rate limit exceeded
      deprecated: false
  /v1/segment/{segmentId}:
    get:
      tags:
      - Segment
      summary: Get segment
      description: Retrieves the segment with the given id
      operationId: getSegmentUsingGET
      parameters:
      - name: segmentId
        in: path
        description: Segment id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Segment'
        '400':
          description: Bad request
        '401':
          description: Unauthorized or bad API Key
        '404':
          description: Account not found
        '429':
          description: Rate limit exceeded
      deprecated: false
components:
  schemas:
    Segment:
      type: object
      required:
      - id
      - name
      properties:
        id:
          type: string
        name:
          type: string
      title: Segment
      description: Segment object
    SegmentsPage:
      type: object
      properties:
        segments:
          type: array
          description: Array of segments
          readOnly: true
          items:
            $ref: '#/components/schemas/Segment'
        pageNumber:
          type: integer
          format: int32
          description: Page number
          readOnly: true
        isLastPage:
          type: boolean
          description: True if no more records available on next page
          readOnly: true
      title: SegmentsPage
  securitySchemes:
    X-APTRINSIC-API-KEY:
      type: apiKey
      name: Aptrinsic API Key
      in: header