Niche Outputs API

The outputs API from Niche — 5 operation(s) for outputs.

GitHub OpenAPI

Operations 5

GET /outputs List Outputs #
GET /outputs/{output_id} Get Output #
POST /outputs/{output_id}/resolve-claim Resolve Claim #
GET /outputs/{output_id}/download Download Output #
GET /outputs/session/{session_id} Get Session Outputs #

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-outputs-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-outputs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Signal Outputs API
  version: 0.1.0
tags:
- name: Outputs
paths:
  /outputs:
    get:
      tags:
      - Outputs
      summary: List Outputs
      operationId: list_outputs_outputs_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OutputResponse'
                title: Response List Outputs Outputs Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /outputs/{output_id}:
    get:
      tags:
      - Outputs
      summary: Get Output
      operationId: get_output_outputs__output_id__get
      parameters:
      - name: output_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Output Id
      - 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/OutputResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /outputs/{output_id}/resolve-claim:
    post:
      tags:
      - Outputs
      summary: Resolve Claim
      description: 'Mark a surfaced claim as handled (cut / kept / sourced) so it stops

        being surfaced + the publish path stops refusing it. The actual COPY

        edit for cut/keep-generic happens through the normal caption-save path;

        this records the editorial decision + (for add_source) the citation.'
      operationId: resolve_claim_outputs__output_id__resolve_claim_post
      parameters:
      - name: output_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Output Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveClaimRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutputResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /outputs/{output_id}/download:
    get:
      tags:
      - Outputs
      summary: Download Output
      description: 'Download an output as the most natural file for its shape.


        - Pure video (video_url, no images) → returns the MP4 directly.

        - Single image (image_card with one static_url, no video) → PNG directly.

        - Everything else → ZIP with images + video + caption.txt.


        `part` (Cal 2026-06-05: "text and an image should be TWO files, not a zip"):

        - "text" → just the caption + hashtags as a .txt

        - "asset" → just the image(s)/video, NO caption.txt (single → direct file,

        multi → zip of assets only)

        The filing sheet fires part=text + part=asset back-to-back so a text+image

        output downloads as two clean files instead of one zip.


        The MP4 case is the one Cal flagged 2026-05-25: previously the endpoint

        zipped only static_urls + caption.txt, so a reel download was a tiny zip

        with a single text file — looked like "the download is a text file."'
      operationId: download_output_outputs__output_id__download_get
      parameters:
      - name: output_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Output Id
      - name: part
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Part
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /outputs/session/{session_id}:
    get:
      tags:
      - Outputs
      summary: Get Session Outputs
      operationId: get_session_outputs_outputs_session__session_id__get
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Session Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OutputResponse'
                title: Response Get Session Outputs Outputs Session  Session Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ResolveClaimRequest:
      properties:
        claim:
          type: string
          title: Claim
        action:
          type: string
          title: Action
        source:
          anyOf:
          - type: string
          - type: 'null'
          title: Source
      type: object
      required:
      - claim
      - action
      title: ResolveClaimRequest
    OutputResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        session_id:
          type: string
          format: uuid
          title: Session Id
        platform:
          type: string
          title: Platform
        script:
          additionalProperties: true
          type: object
          title: Script
        caption:
          type: string
          title: Caption
        hashtags:
          items:
            type: string
          type: array
          title: Hashtags
        static_urls:
          items:
            type: string
          type: array
          title: Static Urls
        video_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Video Url
        bundle_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Bundle Url
        published_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Published At
        published_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Published Url
        published_platform_post_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Published Platform Post Id
        scheduled_for:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Scheduled For
        verifier_blocked_reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Verifier Blocked Reason
        verifier_blocked_claim:
          anyOf:
          - type: string
          - type: 'null'
          title: Verifier Blocked Claim
        source_faithfulness_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Source Faithfulness Score
        source_claim_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Source Claim Count
        source_ungrounded_claims:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Source Ungrounded Claims
        surfaced_claims:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          title: Surfaced Claims
        resolved_claims:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          title: Resolved Claims
        source_diversity_passed:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Source Diversity Passed
        source_recency_passed:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Source Recency Passed
        source_distinct_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Source Distinct Count
        source_freshest_age_days:
          anyOf:
          - type: integer
          - type: 'null'
          title: Source Freshest Age Days
        created_at:
          type: string
          format: date-time
          title: Created At
        density_warnings:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Density Warnings
          description: 'Per-field over-density (carousel slide / image-card headline / longform

            body) so the filing sheet flags a too-dense asset instead of silently

            shrink/clipping it (§F). Empty = within caps. Derived, not stored.'
          readOnly: true
        pdf_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Pdf Url
          description: 'A multi-page PDF of a carousel''s slides (LinkedIn document-upload

            friendly) — one artifact for the whole asset (§G). Carousels only.'
          readOnly: true
        contact_sheet_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Contact Sheet Url
          description: 'A grid PNG of all carousel slides — one image previews the whole asset

            (so an agent/human doesn''t assemble it slide-by-slide). Carousels only.'
          readOnly: true
        asset_expires_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Asset Expires At
          description: 'When the presigned static/video URLs in THIS response expire (24h from

            serialization) so a consumer knows the TTL instead of guessing (§G).'
          readOnly: true
      type: object
      required:
      - id
      - session_id
      - platform
      - script
      - caption
      - hashtags
      - static_urls
      - video_url
      - bundle_url
      - created_at
      - density_warnings
      - pdf_url
      - contact_sheet_url
      - asset_expires_at
      title: OutputResponse