Niche Feed API
The feed API from Niche — 13 operation(s) for feed.
The feed API from Niche — 13 operation(s) for feed.
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-feed-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 Feed API
version: 0.1.0
tags:
- name: Feed
paths:
/feed/niches:
get:
tags:
- Feed
summary: List Niches
operationId: list_niches_feed_niches_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
post:
tags:
- Feed
summary: Create Custom Niche
description: 'A niche described in the follower''s own words (Pro). Creates the niche
row if nobody has described it yet, then follows it; the hourly build loop
picks it up because it now has a confirmed follower. Two people describing
the same niche share one build. Capped per account so the paid surface
can''t become a free-for-all of daily builds.'
operationId: create_custom_niche_feed_niches_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/CustomNicheRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/n/{slug}:
get:
tags:
- Feed
summary: Latest Edition
operationId: latest_edition_feed_n__slug__get
parameters:
- name: slug
in: path
required: true
schema:
type: string
title: Slug
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/n/{slug}/dates:
get:
tags:
- Feed
summary: Edition Dates
operationId: edition_dates_feed_n__slug__dates_get
parameters:
- name: slug
in: path
required: true
schema:
type: string
title: Slug
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/n/{slug}/week:
get:
tags:
- Feed
summary: Week Edition
description: 'The week in one briefing: every published edition of the past seven days
merged (app.feed.weekly). What the weekly email carries, as a page.'
operationId: week_edition_feed_n__slug__week_get
parameters:
- name: slug
in: path
required: true
schema:
type: string
title: Slug
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/n/{slug}/{when}:
get:
tags:
- Feed
summary: Dated Edition
operationId: dated_edition_feed_n__slug___when__get
parameters:
- name: slug
in: path
required: true
schema:
type: string
title: Slug
- name: when
in: path
required: true
schema:
type: string
title: When
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/follow:
post:
tags:
- Feed
summary: Follow
description: 'Follow a niche. With a signed-in bearer token and no email: a confirmed
user follow. Otherwise: an email follow that starts the double opt-in.'
operationId: follow_feed_follow_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/FollowRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/confirm/{token}:
get:
tags:
- Feed
summary: Confirm Follow Link
description: The double opt-in link. Confirms and sends the person to the site.
operationId: confirm_follow_link_feed_confirm__token__get
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/unsubscribe/{token}:
get:
tags:
- Feed
summary: Unsubscribe Get
operationId: unsubscribe_get_feed_unsubscribe__token__get
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Feed
summary: Unsubscribe Post
description: RFC 8058 one-click (List-Unsubscribe-Post). Always 200.
operationId: unsubscribe_post_feed_unsubscribe__token__post
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/stories/{story_id}/angles:
post:
tags:
- Feed
summary: Story Angles
description: 'Up to three angles a practitioner could take on one story. Pro only.
Built on the first call (one quality-model pass) and cached on the story
for every Pro reader after.'
operationId: story_angles_feed_stories__story_id__angles_post
parameters:
- name: story_id
in: path
required: true
schema:
type: string
title: Story Id
- 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'
/feed/me:
get:
tags:
- Feed
summary: My Feed
description: 'The control panel: every niche I follow (paused ones included, so they
can be resumed) with its description, latest edition and delivery.'
operationId: my_feed_feed_me_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: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
patch:
tags:
- Feed
summary: Update My Feed
description: 'Change my send hour and/or cadence, for one niche or all of them. Daily
and chosen weekdays are Pro; a Free account asking for them gets 402.'
operationId: update_my_feed_feed_me_patch
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/FeedSettings'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/follow/{slug}:
delete:
tags:
- Feed
summary: Unfollow
description: Pause my subscription to a niche (a later follow resumes it).
operationId: unfollow_feed_follow__slug__delete
parameters:
- name: slug
in: path
required: true
schema:
type: string
title: Slug
- 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'
/feed/inbound:
post:
tags:
- Feed
summary: Inbound
description: 'Resend posts here when mail lands at the list domain. Svix-signed; an
unsigned or stale post is refused. Only `email.received` is handled; other
events return 200 so Resend doesn''t retry them.'
operationId: inbound_feed_inbound_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/feed/preview:
get:
tags:
- Feed
summary: Preview
description: 'The stories this week that are about the typed niche as a whole. Reuses
the public scan (cached, capped) and filters it with one fast-model pass so a
description like "Cybersecurity for hospitals" never comes back as generic
hospital news. `matched` of `total` tells the page how honest to be.'
operationId: preview_feed_preview_get
parameters:
- name: niche
in: query
required: true
schema:
type: string
title: Niche
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
FollowRequest:
properties:
slug:
type: string
maxLength: 120
minLength: 1
title: Slug
email:
anyOf:
- type: string
format: email
- type: 'null'
title: Email
cadence:
type: string
maxLength: 16
title: Cadence
default: daily
send_days:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Send Days
send_hour_utc:
anyOf:
- type: integer
maximum: 23.0
minimum: 0.0
- type: 'null'
title: Send Hour Utc
send_hour_local:
anyOf:
- type: integer
maximum: 23.0
minimum: 0.0
- type: 'null'
title: Send Hour Local
send_tz:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Send Tz
type: object
required:
- slug
title: FollowRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CustomNicheRequest:
properties:
query:
type: string
maxLength: 200
minLength: 3
title: Query
cadence:
type: string
maxLength: 16
title: Cadence
default: daily
send_days:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Send Days
send_hour_utc:
anyOf:
- type: integer
maximum: 23.0
minimum: 0.0
- type: 'null'
title: Send Hour Utc
send_hour_local:
anyOf:
- type: integer
maximum: 23.0
minimum: 0.0
- type: 'null'
title: Send Hour Local
send_tz:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Send Tz
type: object
required:
- query
title: CustomNicheRequest
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
FeedSettings:
properties:
send_hour_utc:
anyOf:
- type: integer
maximum: 23.0
minimum: 0.0
- type: 'null'
title: Send Hour Utc
send_hour_local:
anyOf:
- type: integer
maximum: 23.0
minimum: 0.0
- type: 'null'
title: Send Hour Local
send_tz:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Send Tz
cadence:
anyOf:
- type: string
maxLength: 16
- type: 'null'
title: Cadence
send_days:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Send Days
slug:
anyOf:
- type: string
maxLength: 120
- type: 'null'
title: Slug
type: object
title: FeedSettings