Niche Public API

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

GitHub OpenAPI

Operations 5

GET /public/signal-slate Signal Slate #
POST /public/digest-subscribe Digest Subscribe #
POST /public/seed-from-slate Seed From Slate #
POST /public/brand-kit-extract Brand Kit Extract #
GET /public/brand-kit-card.png Brand Kit Card #

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-public-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-public-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Signal Public API
  version: 0.1.0
tags:
- name: Public
paths:
  /public/signal-slate:
    get:
      tags:
      - Public
      summary: Signal Slate
      operationId: signal_slate_public_signal_slate_get
      parameters:
      - name: niche
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 200
          title: Niche
      - name: window
        in: query
        required: false
        schema:
          type: string
          default: week
          title: Window
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicSlate'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /public/digest-subscribe:
    post:
      tags:
      - Public
      summary: Digest Subscribe
      description: 'Subscribe to the WEEKLY ROLLUP (the Underreported list) — a single, niche-agnostic

        editorial email, NOT a per-niche scan (that''s the paid watched-niches feature). Capture-

        only for now: the email lands in the waitlist table tagged `source=''weekly_rollup''` (a

        distinct, filterable list — keep it OUT of any pre-launch invite blast), and the page it

        converted on rides a PostHog event as a lead attribute. The rollup SEND + proper list

        management ship with the Underreported Index build.'
      operationId: digest_subscribe_public_digest_subscribe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DigestSubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /public/seed-from-slate:
    post:
      tags:
      - Public
      summary: Seed From Slate
      description: 'Selection-persistence: the just-signed-up user''s free-page pick → a desk thread

        opened on a pre-loaded brief. Reconstitutes the picked story from the (warm) cached

        slate — re-derives if the cache lapsed so the user is never stranded — then seeds a

        parked AWAITING_FORGE session + thread. Returns the thread to open. Flag-gated.'
      operationId: seed_from_slate_public_seed_from_slate_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/SeedFromSlateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /public/brand-kit-extract:
    post:
      tags:
      - Public
      summary: Brand Kit Extract
      operationId: brand_kit_extract_public_brand_kit_extract_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExtractRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandKitExtract'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /public/brand-kit-card.png:
    get:
      tags:
      - Public
      summary: Brand Kit Card
      description: '1200×630 PNG share card for a domain (server-rendered via Pillow, no browser).

        Cache-first on the kit (no re-fetch on repeat); the PNG itself is CDN/browser-cached

        via Cache-Control, and the Pillow composite is ~30ms, so no binary Redis cache needed.'
      operationId: brand_kit_card_public_brand_kit_card_png_get
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
          minLength: 4
          maxLength: 2048
          title: Url
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ExtractRequest:
      properties:
        url:
          type: string
          maxLength: 2048
          minLength: 4
          title: Url
      type: object
      required:
      - url
      title: ExtractRequest
    BrandKitExtract:
      properties:
        url:
          type: string
          title: Url
        domain:
          type: string
          title: Domain
        site_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Site Name
        tagline:
          anyOf:
          - type: string
          - type: 'null'
          title: Tagline
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        palette:
          items:
            $ref: '#/components/schemas/Swatch'
          type: array
          title: Palette
          default: []
        fonts:
          items:
            $ref: '#/components/schemas/FontInfo'
          type: array
          title: Fonts
          default: []
        logo:
          anyOf:
          - $ref: '#/components/schemas/LogoInfo'
          - type: 'null'
        extracted_at:
          type: string
          title: Extracted At
        elapsed_ms:
          type: integer
          title: Elapsed Ms
          default: 0
        thin:
          type: boolean
          title: Thin
          default: false
      type: object
      required:
      - url
      - domain
      - extracted_at
      title: BrandKitExtract
    FontInfo:
      properties:
        name:
          type: string
          title: Name
        role:
          type: string
          title: Role
          default: body
        is_system:
          type: boolean
          title: Is System
          default: false
        google_font:
          type: boolean
          title: Google Font
          default: false
      type: object
      required:
      - name
      title: FontInfo
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SeedFromSlateRequest:
      properties:
        niche:
          type: string
          maxLength: 200
          minLength: 2
          title: Niche
        story_id:
          type: string
          maxLength: 80
          title: Story Id
      type: object
      required:
      - niche
      - story_id
      title: SeedFromSlateRequest
    Swatch:
      properties:
        hex:
          type: string
          title: Hex
        role:
          type: string
          title: Role
        confidence:
          type: string
          enum:
          - corroborated
          - declared
          - supporting
          - sampled
          title: Confidence
        corroborated:
          type: boolean
          title: Corroborated
          default: false
      type: object
      required:
      - hex
      - role
      - confidence
      title: Swatch
    DigestSubscribeRequest:
      properties:
        email:
          type: string
          format: email
          title: Email
        niche:
          type: string
          maxLength: 120
          title: Niche
          default: ''
      type: object
      required:
      - email
      title: DigestSubscribeRequest
    PublicSlate:
      properties:
        niche:
          type: string
          title: Niche
        window:
          type: string
          title: Window
        window_label:
          type: string
          title: Window Label
        generated_at:
          type: string
          title: Generated At
        story_count:
          type: integer
          title: Story Count
        stories:
          items:
            $ref: '#/components/schemas/PublicStory'
          type: array
          title: Stories
          default: []
      type: object
      required:
      - niche
      - window
      - window_label
      - generated_at
      - story_count
      title: PublicSlate
    PublicStory:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
        headline:
          type: string
          title: Headline
        summary:
          type: string
          title: Summary
        tags:
          items:
            type: string
          type: array
          title: Tags
          default: []
        engagement:
          type: string
          title: Engagement
          default: medium
        sources:
          items:
            $ref: '#/components/schemas/PublicSource'
          type: array
          title: Sources
          default: []
      type: object
      required:
      - id
      - title
      - headline
      - summary
      title: PublicStory
    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
    LogoInfo:
      properties:
        kind:
          type: string
          enum:
          - svg_inline
          - raster
          title: Kind
        src:
          type: string
          title: Src
        fills:
          items:
            type: string
          type: array
          title: Fills
          default: []
      type: object
      required:
      - kind
      - src
      title: LogoInfo
    PublicSource:
      properties:
        title:
          type: string
          title: Title
        url:
          type: string
          title: Url
        publisher:
          type: string
          title: Publisher
        published_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Published At
      type: object
      required:
      - title
      - url
      - publisher
      title: PublicSource