Fairing Sources API
The Sources API from Fairing — 1 operation(s) for sources.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/fairing:fairing-sources-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: fairing-api Sources API
version: '1.0'
servers:
- url: https://app.fairing.co/api
security:
- sec0: []
tags:
- name: Sources
paths:
/sources:
post:
responses:
'200':
description: Success - all sources created
content:
application/json:
schema:
type: object
properties:
created:
type: array
items:
type: object
properties:
name:
type: string
example: Mr Beast
channel:
type: string
example: YouTube
channel_source_id:
type: string
example: '@MrBeast'
rejected:
type: array
items:
type: object
properties: {}
summary:
type: object
properties:
created:
type: integer
example: 1
default: 0
rejected:
type: integer
example: 0
default: 0
examples:
OK:
summary: OK
value:
created:
- name: Mr Beast
channel: YouTube
channel_source_id: '@MrBeast'
rejected: []
summary:
created: 1
rejected: 0
'207':
description: Multi-Status - some sources created
content:
application/json:
schema:
type: object
properties:
created:
type: array
items:
type: object
properties:
name:
type: string
example: MrBeast
channel:
type: string
example: YouTube
channel_source_id:
type: string
example: '@MrBeast'
rejected:
type: array
items:
type: object
properties:
source:
type: object
properties:
channel:
type: string
example: YouTube
channel_source_id:
type: string
example: '@x'
errors:
type: object
properties:
name:
type: array
items:
type: string
example: can't be blank
summary:
type: object
properties:
created:
type: integer
example: 1
default: 0
rejected:
type: integer
example: 2
default: 0
examples:
Multi-Status:
summary: Multi-Status
value:
created:
- name: MrBeast
channel: YouTube
channel_source_id: '@MrBeast'
rejected:
- source:
channel: YouTube
channel_source_id: '@x'
errors:
name:
- can't be blank
- source:
name: Pokimane
channel: Twitch
channel_source_id: '@pokimane'
errors:
channel:
- 'unsupported channel: Twitch'
summary:
created: 1
rejected: 2
'401':
description: Unauthorized - missing or invalid token
content:
application/json:
schema:
type: object
properties:
status:
type: integer
message:
type: string
examples:
Unauthorized:
summary: Unauthorized
value:
status: 401
message: Unauthorized
'403':
description: Forbidden - the caller is not an approved source contributor
content:
application/json:
schema:
type: object
properties:
status:
type: integer
message:
type: string
examples:
Forbidden:
summary: Forbidden
value: '{}'
'422':
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unprocessable Entity
errors:
type: object
properties:
base:
type: array
items:
type: string
example: must contain at most 100 sources
examples:
Unprocessable Entity:
summary: Unprocessable Entity
value:
message: Unprocessable Entity
errors:
base:
- must contain at most 100 sources
description: Unprocessable Entity
parameters:
- in: header
name: Authorization
schema:
type: string
required: true
description: Your Fairing's integration API Key
summary: Create Sources
description: ''
operationId: post_sources
requestBody:
content:
application/json:
schema:
type: object
properties:
sources:
type: array
items:
properties:
name:
type: string
description: The source's display name (e.g. `Mr Beast`).
channel:
type: string
default: ''
enum:
- Podcast
- YouTube
- Instagram
- TikTok
- Facebook
description: The platform the source lives on.
channel_source_id:
type: string
description: The source's handle or identifier on that channel (e.g. `@MrBeast`)
type: object
required:
- name
- channel
required:
- sources
examples:
New source:
summary: New source
value:
sources:
- name: MrBeast
channel: YouTube
channel_source_id: '@MrBeast'
- name: Crime Junkie
channel: Podcast
tags:
- Sources
components:
securitySchemes:
sec0:
type: apiKey
in: header
name: Authorization
x-readme-fauxas: true
x-provenance:
method: searched
source: https://docs.fairing.co/reference
harvested: '2026-10-29'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://docs.fairing.co/reference/create-sources.md
- https://docs.fairing.co/reference/retrieve-questions.md
- https://docs.fairing.co/reference/retrieve-responses.md
merge:
pages: 3
deduped: 2
conflicts_kept_first: 0