Niche Public API
The public API from Niche — 5 operation(s) for public.
The public API from Niche — 5 operation(s) for public.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/nicheangle-com:nicheangle-com-public-api"
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.
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: 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