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/shapelessai:shapelessai-references-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. 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: ShapelessAI References API
version: '1'
description: 'The social media team an agent can call. Publish to LinkedIn, X, Instagram, TikTok, YouTube, Facebook, Threads, Bluesky, Reddit, Mastodon, Telegram, Discord and Pinterest, with each network''s limits checked first; make images, AI video, edits of your own footage, carousels, thumbnails, recorded product demos, speech and subtitles, one call each; or hand the whole goal to the agent team as a job. Every refusal says what to do next (a connect link, a checkout link, the question to ask). Bearer API key (Settings -> API keys) or the hosted MCP''s OAuth token. Read the docs live, not from memory: https://shapelessai.com/llms-full.txt is every docs and capability page in one fetch, prose at https://shapelessai.com/docs. What exists and what is planned: https://shapelessai.com/api/capabilities (an x-status: planned operation answers 501 with a want door).'
servers:
- url: https://shapelessai.com
tags:
- name: References
paths:
/api/v1/references:
get:
summary: The account's reference sets (creators, competitors, peers) with their members
operationId: getV1References
responses:
'200':
description: OK
'401':
description: No credential, or not valid.
'403':
description: The key is missing the "read" scope.
'429':
description: Over the key's rate limit (600 requests an hour).
security:
- apiKey:
- read
- oauth:
- read
x-scope: read
x-status: live
tags:
- References
post:
summary: 'Add one person to a reference set: {handle, platform} or {url}, kind…'
operationId: postV1References
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
handle:
type: string
description: The account's handle, with or without @.
platform:
type: string
description: A platform id (GET /api/platforms); read from url when absent.
url:
type: string
description: A profile URL; enough on its own for the platforms we can read it from.
kind:
type: string
enum:
- creator
- competitor
- peer
description: Default creator. peer = creators like me.
setId:
type: string
suggestionId:
type: string
description: Adding from GET /api/v1/references/suggestions.
personName:
type: string
maxLength: 120
source:
type: string
enum:
- search
- import
description: Only when the person came from a search or an import.
additionalProperties: false
responses:
'200':
description: OK
'401':
description: No credential, or not valid.
'403':
description: The key is missing the "write" scope.
'429':
description: Over the key's rate limit (600 requests an hour).
security:
- apiKey:
- write
- oauth:
- write
x-scope: write
x-status: live
tags:
- References
/api/v1/references/{id}:
delete:
summary: Remove a member (soft).
operationId: deleteV1ReferencesId
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
'401':
description: No credential, or not valid.
'403':
description: The key is missing the "write" scope.
'429':
description: Over the key's rate limit (600 requests an hour).
security:
- apiKey:
- write
- oauth:
- write
x-scope: write
x-status: live
tags:
- References
/api/v1/references/suggestions:
get:
summary: People we suggest as references, each with reasons [{code, evidence}] and a…
operationId: getV1ReferencesSuggestions
responses:
'200':
description: OK
'401':
description: No credential, or not valid.
'403':
description: The key is missing the "read" scope.
'429':
description: Over the key's rate limit (600 requests an hour).
security:
- apiKey:
- read
- oauth:
- read
x-scope: read
x-status: live
tags:
- References
/api/v1/references/suggestions/{id}/decide:
post:
summary: 'Accept (adds the person as a member) or reject a suggestion: {decision…'
operationId: postV1ReferencesSuggestionsIdDecide
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
decision:
type: string
enum:
- accept
- reject
kind:
type: string
enum:
- creator
- competitor
- peer
description: Overrides the suggested kind on accept.
setId:
type: string
required:
- decision
additionalProperties: false
responses:
'200':
description: OK
'401':
description: No credential, or not valid.
'403':
description: The key is missing the "write" scope.
'429':
description: Over the key's rate limit (600 requests an hour).
security:
- apiKey:
- write
- oauth:
- write
x-scope: write
x-status: live
tags:
- References
/api/v1/references/browse:
get:
summary: 'Search the reference graph: your own members matching ?q (and ?platform), the…'
operationId: getV1ReferencesBrowse
responses:
'200':
description: OK
'401':
description: No credential, or not valid.
'402':
description: 'Today''s browses are used up: {code: reference_browse_limit, limit, used, resetsAt, upgrade}.'
content:
application/json:
schema:
$ref: '#/components/schemas/NoCredit'
'403':
description: The key is missing the "read" scope.
'429':
description: Over the key's rate limit (600 requests an hour).
security:
- apiKey:
- read
- oauth:
- read
x-scope: read
x-status: live
tags:
- References
components:
schemas:
Upgrade:
type: object
description: Links a person clicks to pay. Every 402 carries one.
properties:
pricing:
type: string
format: uri
checkout:
type: array
items:
type: object
properties:
tier:
type: string
name:
type: string
priceUsd:
type: number
monthlyCreditUsd:
type: number
url:
type: string
format: uri
required:
- tier
- name
- priceUsd
- monthlyCreditUsd
- url
required:
- pricing
- checkout
NoCredit:
type: object
description: 'Out of credit. Hand upgrade.pricing (or one checkout url) to the human: one click signs in and pays.'
properties:
error:
type: string
code:
type: string
upgrade:
$ref: '#/components/schemas/Upgrade'
required:
- error
- upgrade
securitySchemes:
apiKey:
type: http
scheme: bearer
description: slk_... key; scopes read, write, publish.
oauth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://shapelessai.com/api/auth/mcp/authorize
tokenUrl: https://shapelessai.com/api/auth/mcp/token
scopes:
read: Read anything the account holds.
write: 'Create and edit: jobs, drafts, agents, Brand Memory.'
publish: Anything that goes out to a platform, or spends.
wiki: Write to the wiki at /vizipedia as this account, and nothing else. A key with `write` covers it.