Niche Voice API

The voice API from Niche — 4 operation(s) for voice.

GitHub OpenAPI

Operations 4

POST /voice/extract Extract Voice #
GET /voice/questions Get Interview Questions #
POST /voice/interview Submit Interview #
GET /voice Get Voice Profile #

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/nicheangle-com:nicheangle-com-voice-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

nicheangle-com-voice-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Signal Voice API
  version: 0.1.0
tags:
- name: Voice
paths:
  /voice/extract:
    post:
      tags:
      - Voice
      summary: Extract Voice
      description: 'Extract voice primitives from 1-10 pasted past posts. Stores on the user''s

        VoiceProfile row (creating one if needed). Layers the optional audience + avoid

        descriptors alongside.


        Backed by `app.services.voice_extraction` — the same engine the brand-kit

        ingest calls into when it auto-scrapes a social URL.'
      operationId: extract_voice_voice_extract_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VoiceExtractRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceExtractResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /voice/questions:
    get:
      tags:
      - Voice
      summary: Get Interview Questions
      operationId: get_interview_questions_voice_questions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /voice/interview:
    post:
      tags:
      - Voice
      summary: Submit Interview
      operationId: submit_interview_voice_interview_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InterviewRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceProfileResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /voice:
    get:
      tags:
      - Voice
      summary: Get Voice Profile
      operationId: get_voice_profile_voice_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceProfileResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    VoiceExtractResponse:
      properties:
        primitives:
          $ref: '#/components/schemas/VoicePrimitives'
        audience:
          anyOf:
          - type: string
          - type: 'null'
          title: Audience
        avoid:
          anyOf:
          - type: string
          - type: 'null'
          title: Avoid
      type: object
      required:
      - primitives
      title: VoiceExtractResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PunctuationHabits:
      properties:
        em_dashes:
          type: string
          title: Em Dashes
        semicolons:
          type: string
          title: Semicolons
        parens:
          type: string
          title: Parens
      type: object
      required:
      - em_dashes
      - semicolons
      - parens
      title: PunctuationHabits
    CadencePrimitives:
      properties:
        avg_sentence_words:
          type: integer
          title: Avg Sentence Words
        fragment_frequency_pct:
          type: integer
          title: Fragment Frequency Pct
        single_para_ratio_pct:
          type: integer
          title: Single Para Ratio Pct
      type: object
      required:
      - avg_sentence_words
      - fragment_frequency_pct
      - single_para_ratio_pct
      title: CadencePrimitives
    InterviewRequest:
      properties:
        archetype:
          type: string
          title: Archetype
        answers:
          additionalProperties:
            type: string
          type: object
          maxProperties: 30
          title: Answers
        profile_urls:
          anyOf:
          - items:
              type: string
            type: array
            maxItems: 5
          - type: 'null'
          title: Profile Urls
      type: object
      required:
      - archetype
      - answers
      title: InterviewRequest
    VoiceExtractRequest:
      properties:
        posts:
          items:
            type: string
          type: array
          maxItems: 10
          minItems: 1
          title: Posts
        audience:
          anyOf:
          - type: string
            maxLength: 400
          - type: 'null'
          title: Audience
        avoid:
          anyOf:
          - type: string
            maxLength: 400
          - type: 'null'
          title: Avoid
      type: object
      required:
      - posts
      title: VoiceExtractRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    VoicePrimitives:
      properties:
        insufficient_signal:
          type: boolean
          title: Insufficient Signal
          default: false
        cadence:
          $ref: '#/components/schemas/CadencePrimitives'
        openers:
          items:
            type: string
          type: array
          title: Openers
        connectors:
          items:
            type: string
          type: array
          title: Connectors
        taboo_phrases:
          items:
            type: string
          type: array
          title: Taboo Phrases
        signature_moves:
          items:
            type: string
          type: array
          title: Signature Moves
        topic_gravity:
          items:
            type: string
          type: array
          title: Topic Gravity
        casing:
          type: string
          title: Casing
        punctuation_habits:
          $ref: '#/components/schemas/PunctuationHabits'
      type: object
      required:
      - cadence
      - openers
      - connectors
      - taboo_phrases
      - signature_moves
      - topic_gravity
      - casing
      - punctuation_habits
      title: VoicePrimitives
    VoiceProfileResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        archetype:
          type: string
          title: Archetype
        tone_words:
          items:
            type: string
          type: array
          title: Tone Words
        stance:
          type: string
          title: Stance
        audience_level:
          type: string
          title: Audience Level
        hook_style:
          type: string
          title: Hook Style
        avoid:
          items:
            type: string
          type: array
          title: Avoid
        profile_context:
          type: string
          title: Profile Context
      type: object
      required:
      - id
      - archetype
      - tone_words
      - stance
      - audience_level
      - hook_style
      - avoid
      - profile_context
      title: VoiceProfileResponse