aid: surge-ai

name: Surge AI

description: Surge AI is a human-data company that provides large-scale, expert-quality labeled data for training and evaluating frontier AI models.
  The product surface spans RL environments and agents (rich, complex environments that challenge agentic models), rubrics and verifiers (scoring
  systems for AI outputs), RLHF (preference and reward data), SFT (foundational skill demonstrations), human evaluation, expert professional domains,
  internationalization across 70+ languages, multimodal (image, audio, video) data, and off-the-shelf datasets. Surge ships an official Python
  SDK (surge-python) wrapping the Surge API, with API-key authentication, and exposes the dashboard and API reference at app.surgehq.ai. Public
  datasets published by Surge include the toxicity dataset (the world's largest social-media toxicity dataset).

type: Index

deliveryModel:
  model: open-core
  license: MIT
  open_source: true
  commercial: true
  callable_host: true
  label: Open core · an OSS project plus a commercial hosted product
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived

accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived

image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/surge-ai.png

tags:
- Human Data
- RLHF
- SFT
- Rubrics
- Verifiers
- RL Environments
- Multi-Modal
- Internationalization
- Labeling

tags_raw:
- Human Data
- RLHF
- SFT
- Rubrics
- Verifiers
- RL Environments
- Multimodal
- Internationalization
- Labeling

url: https://raw.githubusercontent.com/api-evangelist/surge-ai/refs/heads/main/apis.yml

created: '2026-05-23'

modified: '2026-10-27'

specificationVersion: '0.23'

maintainers:
- FN: Kin Lane
  url: http://apievangelist.com
  email: kin@apievangelist.com

common:
- type: CapabilityMap
  url: capabilities/surge-ai-capability-edges.yml
  name: Surge AI Business Capability Map
- type: Spectral
  url: rules/surge-ai-rules.yml
- type: JSONLD
  url: json-ld/surge-ai-context.jsonld
- type: Vocabulary
  url: vocabulary/surge-ai-vocabulary.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DataModel
  url: data-model/surge-ai-data-model.yml
- type: Conventions
  url: conventions/surge-ai-conventions.yml
- type: Deprecation
  url: lifecycle/surge-ai-lifecycle.yml
- type: Lifecycle
  url: lifecycle/surge-ai-lifecycle.yml
- type: Conformance
  url: conformance/surge-ai-conformance.yml
- type: Overlay
  url: overlays/surge-ai-projects-api-overlay.yaml
- type: Hosts
  url: hosts/surge-ai-hosts.yml
- type: Vendors
  url: vendors/surge-ai-vendors.yml
- type: Packages
  url: packages/surge-ai-packages.yml
- type: FinOps
  url: finops/surge-ai-finops.yml
- type: Website
  url: https://surgehq.ai/
- type: IssueTracker
  url: https://github.com/surge-ai/surge-python/issues
- type: License
  name: MIT
  url: https://github.com/surge-ai/surge-python/blob/main/LICENSE
- type: AgenticAccess
  url: agentic-access/surge-ai-agentic-access.yml
- type: DomainSecurity
  url: security/surge-ai-domain-security.yml
- type: Authentication
  url: authentication/surge-ai-authentication.yml
- type: Portal
  url: https://www.surgehq.ai
- type: Documentation
  url: https://app.surgehq.ai/docs/api
- type: APIReference
  url: https://app.surgehq.ai/docs/api
- type: Authentication
  url: https://app.surgehq.ai/docs/api
- type: Signup
  url: https://app.surgehq.ai/customers/sign_in
- type: Console
  url: https://app.surgehq.ai
- type: SDKs
  url: https://github.com/surge-ai/surge-python
  name: Surge Python SDK
- type: SDKs
  url: https://pypi.org/project/surge-api/
  name: surge-api on PyPI
- type: GitHubOrganization
  url: https://github.com/surge-ai
- type: GitHubRepository
  url: https://github.com/surge-ai/toxicity
  name: Surge Toxicity Dataset
- type: Blog
  url: https://www.surgehq.ai/blog
- type: Support
  url: https://surgehq.ai/contact
- type: TermsOfService
  url: https://surgehq.ai/terms-of-service
- type: PrivacyPolicy
  url: https://surgehq.ai/privacy-policy
- type: StatusPage
  url: https://status.surgehq.ai/
- type: Guides
  url: https://surgehq.ai/guides
  name: Enterprise Guides
- type: Login
  url: https://app.surgehq.ai/customers/sign_in
- type: Careers
  url: https://surgehq.ai/careers
- type: LinkedIn
  url: https://www.linkedin.com/company/surge-ai/
- type: X
  url: https://x.com/HelloSurgeAI
- type: Features
  data:
  - name: Surge REST API
    description: Endpoints for projects, tasks, and blueprints, with API-key authentication.
  - name: Python SDK
    description: Official surge-python SDK on PyPI, MIT-licensed, Python 3.10+.
  - name: RL Environments and Agents
    description: Complex environments that challenge agentic models.
  - name: Rubrics and Verifiers
    description: Scoring systems for AI outputs across domains.
  - name: RLHF and SFT
    description: Preference, reward, and demonstration data for foundation-model training.
  - name: Human Evaluation
    description: Expert workforce grades AI output quality.
  - name: Expert Professional Domains
    description: Specialized expertise across finance, law, medicine, and more.
  - name: 70+ Languages
    description: Internationalization coverage spanning more than 70 languages.
  - name: Multimodal Data
    description: Image, audio, and video collection and labeling.
  - name: Off-The-Shelf Datasets
    description: Pre-built datasets available for licensing.
  - name: Open Datasets
    description: Public releases including the world's largest social-media toxicity dataset.
- type: UseCases
  data:
  - name: Frontier Model RLHF
    description: Preference and reward data for reinforcement learning from human feedback.
  - name: Supervised Fine-Tuning
    description: Demonstration data for SFT across professional domains.
  - name: Agentic Evals
    description: Benchmark agents in complex RL environments with structured rubrics.
  - name: Multilingual Model Evaluation
    description: Evaluate model quality across 70+ languages.
  - name: Trust and Safety Research
    description: Use the toxicity dataset and human evaluation pipelines for trust and safety work.
- type: Integrations
  data:
  - name: Python SDK
    description: Programmatic integration via the official surge-python SDK.
  - name: API Key Authentication
    description: Standard API-key auth (SURGE_API_KEY env var or programmatic configuration).
  - name: Custom Project Blueprints
    description: Use Surge blueprints as templates for new labeling projects.

apis:
- aid: surge-ai:surge-api
  name: Surge API
  description: Surge's REST API for managing labeling projects, tasks, and results. Endpoints cover projects (list, retrieve, create, download
    results, save reports in multiple formats), tasks (create, list, retrieve individual tasks), and blueprints (list and use as templates for
    new projects). Authentication uses an API key sourced from the user's Surge profile, passed via the SURGE_API_KEY environment variable or
    set explicitly on the client. The reference is published in the Surge dashboard at app.surgehq.ai/docs/api.
  humanURL: https://app.surgehq.ai/docs/api
  baseURL: https://app.surgehq.ai/api
  tags:
  - REST API
  - Project
  - Task
  - Blueprints
  tags_raw:
  - REST API
  - Projects
  - Tasks
  - Blueprints
  properties:
  - type: Documentation
    url: https://app.surgehq.ai/docs/api
  - type: APIReference
    url: https://app.surgehq.ai/docs/api
  - type: Authentication
    url: https://app.surgehq.ai/docs/api
  - type: SDKs
    url: https://github.com/surge-ai/surge-python
- aid: surge-ai:surge-python-sdk
  name: Surge Python SDK
  description: Official Python SDK (surge-api on PyPI) wrapping the Surge API. Requires Python 3.10+, MIT-licensed, and last updated May 2026.
    Configured via surge.api_key or the SURGE_API_KEY environment variable.
  humanURL: https://github.com/surge-ai/surge-python
  tags:
  - SDK
  - Python
  - Open Source
  tags_raw:
  - SDK
  - Python
  - Open Source
  - Open-Source
  properties:
  - type: GitHubRepository
    url: https://github.com/surge-ai/surge-python
  - type: SDKs
    url: https://pypi.org/project/surge-api/
- aid: surge-ai:surge-rl-environments
  name: Surge RL Environments and Agents
  description: Surge's product surface for delivering complex reinforcement-learning environments and agents that challenge and evaluate agentic
    models.
  humanURL: https://www.surgehq.ai/products
  tags:
  - RL Environments
  - Agents
  - Evals
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-rubrics-verifiers
  name: Surge Rubrics and Verifiers
  description: Scoring rubrics and automated verifiers for grading AI outputs across domains.
  humanURL: https://www.surgehq.ai/products
  tags:
  - Rubrics
  - Verifiers
  - Evals
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-rlhf
  name: Surge RLHF
  description: Preference and reward data for reinforcement learning from human feedback.
  humanURL: https://www.surgehq.ai/products
  tags:
  - RLHF
  - Preference Data
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-sft
  name: Surge SFT
  description: Foundational-skill demonstration data for supervised fine-tuning.
  humanURL: https://www.surgehq.ai/products
  tags:
  - SFT
  - Fine-Tuning
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-human-evaluation
  name: Surge Human Evaluation
  description: Quality assessment of AI outputs by Surge's expert workforce.
  humanURL: https://www.surgehq.ai/products
  tags:
  - Human Evaluation
  - Quality
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-multimodal
  name: Surge Multimodal Data
  description: Image, audio, and video data collection and labeling.
  humanURL: https://www.surgehq.ai/products
  tags:
  - Multi-Modal
  - Image
  - Audio
  - Video
  tags_raw:
  - Multimodal
  - Image
  - Audio
  - Video
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-internationalization
  name: Surge Internationalization
  description: Multilingual data across 70+ languages for localization, translation, and multilingual model evaluation.
  humanURL: https://www.surgehq.ai/products
  tags:
  - Internationalization
  - Multilingual
  - Translation
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-off-the-shelf-data
  name: Surge Off-The-Shelf Data
  description: Pre-built datasets ready for licensing and download.
  humanURL: https://www.surgehq.ai/products
  tags:
  - Datasets
  - Pre-Built Data
  properties:
  - type: Documentation
    url: https://www.surgehq.ai/products
- aid: surge-ai:surge-toxicity-dataset
  name: Surge Toxicity Dataset
  description: The world's largest open social-media toxicity dataset, published under MIT license.
  humanURL: https://github.com/surge-ai/toxicity
  tags:
  - Datasets
  - Open Data
  - Toxicity
  - Trust and Safety
  tags_raw:
  - Dataset
  - Open Data
  - Toxicity
  - Trust and Safety
  properties:
  - type: GitHubRepository
    url: https://github.com/surge-ai/toxicity
- aid: surge-ai:surge-ai-projects-api
  name: Surge AI Projects API
  description: The Projects API from Surge AI — 9 operation(s) for projects.
  humanURL: https://app.surgehq.ai/docs/api
  baseURL: https://app.surgehq.ai/api
  tags:
  - Project
  tags_raw:
  - Projects
  properties:
  - type: OpenAPI
    url: openapi/surge-ai-projects-api-openapi.yml
  - type: JSONSchema
    url: json-schema/surge-ai-project-create-schema.json
  - type: JSONSchema
    url: json-schema/surge-ai-project-schema.json
  - type: JSONSchema
    url: json-schema/surge-ai-project-update-schema.json
- aid: surge-ai:surge-ai-tasks-api
  name: Surge AI Tasks API
  description: The Tasks API from Surge AI — 5 operation(s) for tasks.
  humanURL: https://app.surgehq.ai/docs/api
  baseURL: https://app.surgehq.ai/api
  tags:
  - Task
  tags_raw:
  - Tasks
  properties:
  - type: OpenAPI
    url: openapi/surge-ai-tasks-api-openapi.yml
  - type: JSONSchema
    url: json-schema/surge-ai-task-schema.json
  - type: JSONSchema
    url: json-schema/surge-ai-task-create-schema.json
- aid: surge-ai:surge-ai-teams-api
  name: Surge AI Teams API
  description: The Teams API from Surge AI — 1 operation(s) for teams.
  humanURL: https://app.surgehq.ai/docs/api
  baseURL: https://app.surgehq.ai/api
  tags:
  - Team
  tags_raw:
  - Teams
  properties:
  - type: OpenAPI
    url: openapi/surge-ai-teams-api-openapi.yml
  - type: JSONSchema
    url: json-schema/surge-ai-team-schema.json

x-coverage:
  state: gated
  reason: customer-only-docs
  detail: Surge's API reference at app.surgehq.ai/docs/api redirects to app.surgehq.ai/customers/sign_in, so the only public description of the API is the open-source surge-python SDK.
  evidence:
  - url: https://app.surgehq.ai/docs/api
    status: 200
  - url: https://app.surgehq.ai/openapi.json
    status: 404
  - url: https://app.surgehq.ai/api/openapi.json
    status: 404
  checked: '2026-10-27'
x-enrichment:
  date: '2026-10-27'
  status: nochange
  artifacts_added: 0
  pass: modular-v1
  engine: identity=anthropic,contract=anthropic,surfaces=anthropic,docs=anthropic,regulatory=anthropic