Niche Social API
The social API from Niche — 12 operation(s) for social.
The social API from Niche — 12 operation(s) for social.
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-social-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 Social API
version: 0.1.0
tags:
- name: Social
paths:
/social/connections:
get:
tags:
- Social
summary: List Connections
operationId: list_connections_social_connections_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:
type: array
items:
$ref: '#/components/schemas/ConnectionStatus'
title: Response List Connections Social Connections Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/linkedin/connect:
get:
tags:
- Social
summary: Linkedin Connect
operationId: linkedin_connect_social_linkedin_connect_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'
/social/linkedin/callback:
get:
tags:
- Social
summary: Linkedin Callback
operationId: linkedin_callback_social_linkedin_callback_get
parameters:
- name: state
in: query
required: true
schema:
type: string
title: State
- name: code
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Code
- name: error
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Error
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/instagram/connect:
get:
tags:
- Social
summary: Instagram Connect
operationId: instagram_connect_social_instagram_connect_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'
/social/instagram/callback:
get:
tags:
- Social
summary: Instagram Callback
operationId: instagram_callback_social_instagram_callback_get
parameters:
- name: state
in: query
required: true
schema:
type: string
title: State
- name: code
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Code
- name: error
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Error
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/twitter/connect:
get:
tags:
- Social
summary: Twitter Connect
operationId: twitter_connect_social_twitter_connect_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'
/social/twitter/callback:
get:
tags:
- Social
summary: Twitter Callback
operationId: twitter_callback_social_twitter_callback_get
parameters:
- name: state
in: query
required: true
schema:
type: string
title: State
- name: code
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Code
- name: error
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Error
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/{platform}/disconnect:
delete:
tags:
- Social
summary: Disconnect
operationId: disconnect_social__platform__disconnect_delete
parameters:
- name: platform
in: path
required: true
schema:
type: string
title: Platform
- 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'
/social/{session_id}/{platform}/publish:
post:
tags:
- Social
summary: Publish
operationId: publish_social__session_id___platform__publish_post
parameters:
- name: session_id
in: path
required: true
schema:
type: string
format: uuid
title: Session Id
- name: platform
in: path
required: true
schema:
type: string
title: Platform
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/PublishBody'
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PublishResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/{session_id}/{platform}/schedule:
post:
tags:
- Social
summary: Schedule Post
operationId: schedule_post_social__session_id___platform__schedule_post
parameters:
- name: session_id
in: path
required: true
schema:
type: string
format: uuid
title: Session Id
- name: platform
in: path
required: true
schema:
type: string
title: Platform
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduleRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduledPostOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/scheduled:
get:
tags:
- Social
summary: List Scheduled
operationId: list_scheduled_social_scheduled_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:
type: array
items:
$ref: '#/components/schemas/ScheduledPostOut'
title: Response List Scheduled Social Scheduled Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/social/scheduled/{scheduled_id}:
delete:
tags:
- Social
summary: Cancel Scheduled
operationId: cancel_scheduled_social_scheduled__scheduled_id__delete
parameters:
- name: scheduled_id
in: path
required: true
schema:
type: string
format: uuid
title: Scheduled 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'
components:
schemas:
PublishBody:
properties:
override_verifier_block:
type: boolean
title: Override Verifier Block
default: false
override_acknowledged_claim:
type: string
title: Override Acknowledged Claim
default: ''
acknowledge_publish_cost:
type: boolean
title: Acknowledge Publish Cost
default: false
type: object
title: PublishBody
description: 'Optional publish-time flags. The override pair is the human-only escape
hatch for a false verifier block — honored only when the acknowledged claim
matches the flagged claim verbatim (see dispatch_publish).
`acknowledge_publish_cost` is the human''s confirm that a link-bearing X post
will cost credits (X bills per link-post). The route returns a 402 with the
cost the FIRST time; the filing sheet shows it, the human confirms, the
re-call carries this flag. Mirrors the MCP `acknowledge_publish_cost` gate so
no surface charges for a link post without an explicit yes.'
ScheduleRequest:
properties:
scheduled_for:
type: string
format: date-time
title: Scheduled For
type: object
required:
- scheduled_for
title: ScheduleRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
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
PublishResult:
properties:
ok:
type: boolean
title: Ok
post_url:
type: string
title: Post Url
default: ''
platform_post_id:
type: string
title: Platform Post Id
default: ''
error_kind:
type: string
title: Error Kind
default: ''
error_message:
type: string
title: Error Message
default: ''
retry_after_sec:
anyOf:
- type: integer
- type: 'null'
title: Retry After Sec
type: object
required:
- ok
title: PublishResult
ScheduledPostOut:
properties:
id:
type: string
title: Id
session_id:
type: string
title: Session Id
platform:
type: string
title: Platform
scheduled_for:
type: string
title: Scheduled For
status:
type: string
title: Status
post_url:
type: string
title: Post Url
default: ''
error:
type: string
title: Error
default: ''
created_at:
type: string
title: Created At
sent_at:
anyOf:
- type: string
- type: 'null'
title: Sent At
type: object
required:
- id
- session_id
- platform
- scheduled_for
- status
- created_at
title: ScheduledPostOut
ConnectionStatus:
properties:
platform:
type: string
title: Platform
connected:
type: boolean
title: Connected
username:
type: string
title: Username
default: ''
expires_at:
anyOf:
- type: string
- type: 'null'
title: Expires At
supports_media:
type: boolean
title: Supports Media
default: false
avatar_url:
anyOf:
- type: string
- type: 'null'
title: Avatar Url
display_name:
anyOf:
- type: string
- type: 'null'
title: Display Name
verified:
type: boolean
title: Verified
default: false
type: object
required:
- platform
- connected
title: ConnectionStatus