segment/apis.yml at main · api-evangelist/segment · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
aid: segment
url: https://raw.githubusercontent.com/api-evangelist/segment/refs/heads/main/apis.yml
modified: '2026-05-19'
apis:
- aid: segment:public-api
  name: Segment Public API
  tags:
  - Analytics
  - Customer Data
  - Destinations
  - Sources
  - Workspace Management
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.segmentapis.com
  humanURL: https://docs.segmentapis.com/
  properties:
  - url: https://docs.segmentapis.com/
    type: Documentation
  - url: openapi/segment-public-api-openapi.yml
    type: OpenAPI
  - url: graphql/segment-graphql.md
    type: GraphQL
  description: The Segment Public API allows developers to programmatically manage
    Segment workspaces and their resources. It supports full CRUD operations for sources,
    destinations, warehouses, tracking plans, and catalog entries. The API follows
    REST conventions with standard HTTP methods and predictable resource-oriented
    URLs. It is available for Team and Business tier customers and is the recommended
    API going forward, replacing the older Config API.
- aid: segment:http-tracking-api
  name: Segment HTTP Tracking API
  tags:
  - Analytics
  - Customer Data
  - Events
  - Tracking
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.segment.io
  humanURL: https://www.twilio.com/docs/segment/connections/sources/catalog/libraries/server/http-api
  properties:
  - url: https://www.twilio.com/docs/segment/connections/sources/catalog/libraries/server/http-api
    type: Documentation
  - url: openapi/segment-http-tracking-api-openapi.yml
    type: OpenAPI
  - url: asyncapi/segment-webhooks-asyncapi.yml
    type: AsyncAPI
  description: The Segment HTTP Tracking API enables developers to record analytics
    data from any website or application by sending HTTP requests directly to Segment
    servers. It supports identify, track, page, screen, group, and alias calls, and
    Segment routes the collected data to configured destinations. The API accepts
    batch requests up to 500 KB and requires each payload to include a userId or anonymousId.
    It is a server-side alternative to Segment's client-side SDKs.
- aid: segment:profile-api
  name: Segment Profile API
  tags:
  - Customer Data
  - Identity Resolution
  - Profiles
  - Unify
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://profiles.segment.com
  humanURL: https://www.twilio.com/docs/segment/unify/profile-api
  properties:
  - url: https://www.twilio.com/docs/segment/unify/profile-api
    type: Documentation
  - url: openapi/segment-profile-api-openapi.yml
    type: OpenAPI
  description: The Segment Profile API provides a single endpoint to read user-level
    and account-level customer data from Segment Unify. Developers can query the entire
    user or account object programmatically, including external IDs, traits, and events
    that make up a user's journey. The API uses basic authentication and typically
    delivers p95 response times under 200ms for the traits endpoint. It is commonly
    used for real-time personalization and customer data retrieval.
- aid: segment:config-api
  name: Segment Config API
  tags:
  - Configuration
  - Destinations
  - Legacy
  - Sources
  - Workspace Management
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://platform.segmentapis.com
  humanURL: https://www.twilio.com/docs/segment/api/config-api
  properties:
  - url: https://www.twilio.com/docs/segment/api/config-api
    type: Documentation
  - url: openapi/segment-config-api-openapi.yml
    type: OpenAPI
  description: The Segment Config API allows programmatic management of Segment workspaces,
    sources, destinations, and other configuration resources. It provides endpoints
    to list workspace sources and destinations, create or delete destinations, and
    manage tracking plans. As of early 2024, Segment has stopped issuing new Config
    API tokens and recommends migrating to the Public API for access to the latest
    features. The Config API remains functional for existing users but is no longer
    actively developed.
- aid: segment:pixel-tracking-api
  name: Segment Pixel Tracking API
  tags:
  - Analytics
  - Email
  - Pixel
  - Tracking
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.segment.io
  humanURL: https://www.twilio.com/docs/segment/connections/sources/catalog/libraries/server/pixel-tracking-api
  properties:
  - url: https://www.twilio.com/docs/segment/connections/sources/catalog/libraries/server/pixel-tracking-api
    type: Documentation
  - url: openapi/segment-pixel-tracking-api-openapi.yml
    type: OpenAPI
  description: The Segment Pixel Tracking API provides a way to collect analytics
    data using image pixel requests, which is useful in environments where JavaScript
    cannot execute, such as email clients. It supports identify, track, page, screen,
    group, and alias calls through pixel endpoints under the api.segment.io domain.
    This API is particularly suited for tracking email opens, ad impressions, and
    other contexts where embedding a tracking pixel is the only viable data collection
    method.
common:
- type: AgenticAccess
  url: agentic-access/segment-agentic-access.yml
- type: DomainSecurity
  url: security/segment-domain-security.yml
- type: Authentication
  url: authentication/segment-authentication.yml
- type: GitHubOrganization
  url: https://github.com/segmentio
- type: LinkedIn
  url: https://www.linkedin.com/company/segment-io
- type: JSONLD
  url: json-ld/segment-context.jsonld
- type: JSONSchema
  url: json-schema/segment-event-schema.json
- type: JSONSchema
  url: json-schema/segment-source-schema.json
- type: JSONSchema
  url: json-schema/segment-destination-schema.json
- type: Features
  data:
  - Free Developer plan up to ~1,000 visitors and 2 sources
  - Customer Data Pipeline custom-quoted via sales
  - Customer Data Platform (Unify + Engage) custom-quoted
  - 700+ destinations including warehouses, advertising, analytics
  - Tracking API up to 30,000 events/sec/source
  - Public API at 600 req/min/workspace
  - Functions for custom source/destination logic
  - Reverse ETL for warehouse-to-tool syncs
  - Identity resolution via Unify
  - AI-powered audiences and predictions
  - Generative audiences
  - Protocols add-on for tracking plan governance
  - OAuth 2.0 + workspace API tokens
  - HIPAA-eligible regional CDP options
  - Dedicated CSM on CDP plan
  - Connections to 90+ warehouses including BigQuery, Snowflake, Databricks
  sources:
  - https://www.twilio.com/en-us/pricing/customer-data
  updated: '2026-05-04'
description: Segment is a customer data platform that helps companies collect, clean,
  and route customer data to hundreds of tools used for analytics, marketing, and
  data warehousing.