Saved searches and provider lists for a signed-in apis.io API key — save a query, re-run it, and watch what is net-new. 10 operations of the APIs.io API, split out by tag so this surface is documented, rated, and governed on its own.
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/apis-io-saved-workspace-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: APIs.io Saved Workspace API
description: |-
A Pro dimension — per-user saved searches, lists, and net-new deltas. The same capability the MCP exposes as tools; turns apis.io from stateless lookup into a persistent research workspace. Requires an API key.
This is the Saved Workspace surface of the [APIs.io API](https://apis.io/api/v1) — one of 17 contracts split from the full API by tag, each documented and governed on its own. See the APIs.json index for the whole set.
version: 1.5.0
contact:
name: API Evangelist
url: https://apis.io
license:
name: CC BY 4.0
url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://apis.io/api/v1
description: Production server.
tags:
- name: Saved Workspace
description: A Pro dimension — per-user saved searches, lists, and net-new deltas. The same capability the MCP exposes as tools; turns apis.io from stateless lookup into a persistent research workspace. Requires an API key.
paths:
/me/searches:
get:
operationId: listSavedSearches
x-tier: pro
x-mcp-tool: list_saved_searches
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: List your saved searches.
description: The saved searches owned by the authenticated key. Pro. Requires an API key.
responses:
"200":
description: Your saved searches.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"401":
$ref: "#/components/responses/AuthRequired"
"402":
$ref: "#/components/responses/UpgradeRequired"
post:
operationId: createSavedSearch
x-tier: pro
x-mcp-tool: save_search
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Create a saved search.
description: Persist a named search using the same filter vocabulary as `/search`. Pro.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
description: Name for the saved search.
examples:
- Messaging APIs
maxLength: 1024
q:
type: string
description: Free-text query the saved search runs with.
examples:
- messaging
maxLength: 1024
tags:
type: array
items:
type: string
description: Restrict the search to records carrying these tags.
band:
type: array
items:
type: string
description: Restrict the search to these rating bands.
industry:
type: array
items:
type: string
description: Restrict the search to these industries.
region:
type: array
items:
type: string
description: Restrict the search to these regions.
area:
type: array
items:
type: string
description: Restrict the search to these curated areas.
artifact_types:
type: array
items:
type: string
description: Restrict the search to records publishing these artifact types.
match:
type: string
enum:
- any
- all
description: Whether a record must carry any of the tags or all of them.
examples:
- any
min_score:
type: number
description: Only results at or above this composite score.
examples:
- 60
description: The search to save — a name plus the filters the search runs with.
responses:
"201":
description: The created saved search (id, name, criteria).
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"401":
$ref: "#/components/responses/AuthRequired"
"402":
$ref: "#/components/responses/UpgradeRequired"
/me/searches/{id}:
delete:
operationId: deleteSavedSearch
x-tier: pro
x-mcp-tool: delete_saved_search
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Delete a saved search you own.
description: Permanently removes the saved search and its delta cursor. Pro.
parameters:
- name: id
in: path
required: true
schema:
type: string
maxLength: 1024
description: Identifier of the saved search or list, as returned when it was created.
responses:
"200":
description: Deleted.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
/me/searches/{id}/results:
get:
operationId: runSavedSearch
x-tier: pro
x-mcp-tool: run_saved_search
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Re-run a saved search against the live catalog.
description: Re-runs the stored criteria and returns providers that currently match. Pro.
parameters:
- name: id
in: path
required: true
schema:
type: string
maxLength: 1024
description: Identifier of the saved search or list, as returned when it was created.
- name: limit
in: query
schema:
type: integer
maximum: 1000000
description: Items per page.
responses:
"200":
description: Current matching providers.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
"404":
$ref: "#/components/responses/NotFound"
/me/searches/{id}/net_new:
get:
operationId: savedSearchNetNew
x-tier: pro
x-mcp-tool: saved_search_net_new
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: What's NEW for a saved search since you last checked.
description: Providers that newly match your criteria since the previous call. Advances the delta cursor, so each call reports only the change. The first call establishes the baseline (net-new empty). The agent-native version of the demand report. Pro.
parameters:
- name: id
in: path
required: true
schema:
type: string
maxLength: 1024
description: Identifier of the saved search or list, as returned when it was created.
responses:
"200":
description: Net-new matches + advanced cursor.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
"404":
$ref: "#/components/responses/NotFound"
/me/lists:
get:
operationId: listLists
x-tier: pro
x-mcp-tool: list_lists
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: List the lists/shortlists you own.
responses:
"200":
description: Your lists.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"401":
$ref: "#/components/responses/AuthRequired"
"402":
$ref: "#/components/responses/UpgradeRequired"
description: The saved lists in your workspace, each with its members and when it was last changed. Requires a signed-in apis.io API key.
post:
operationId: createList
x-tier: pro
x-mcp-tool: create_list
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Create a named, persistent list.
description: Creates a shortlist/stack you own; seed it with provider slugs and/or aids. Pro.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
description: Name for the list.
examples:
- Payments shortlist
maxLength: 1024
members:
type: array
items:
type: string
description: Provider slugs and/or aids.
description: The list to create — a name and, optionally, its first members.
responses:
"201":
description: The created list.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
/me/lists/{id}:
get:
operationId: getList
x-tier: pro
x-mcp-tool: get_list
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Get a list, members resolved to current name/band/score.
description: Returns the list with each member resolved to its current profile and rating. Pro.
parameters:
- name: id
in: path
required: true
schema:
type: string
maxLength: 1024
description: Identifier of the saved search or list, as returned when it was created.
responses:
"200":
description: The list with resolved members.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
"404":
$ref: "#/components/responses/NotFound"
delete:
operationId: deleteList
x-tier: pro
x-mcp-tool: delete_list
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Delete a list you own.
description: Permanently removes the list. Pro.
parameters:
- name: id
in: path
required: true
schema:
type: string
maxLength: 1024
description: Identifier of the saved search or list, as returned when it was created.
responses:
"200":
description: Deleted.
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
/me/lists/{id}/entries:
post:
operationId: addToList
x-tier: pro
x-mcp-tool: add_to_list
security:
- ApiKeyAuth: []
tags:
- Saved Workspace
summary: Add providers/APIs to a list.
description: Appends providers/APIs (by slug or aid) to the list, de-duplicated. Pro.
parameters:
- name: id
in: path
required: true
schema:
type: string
maxLength: 1024
description: Identifier of the saved search or list, as returned when it was created.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- members
properties:
members:
type: array
items:
type: string
description: Provider slugs or API aids to add to the list.
description: The members to add to the list.
responses:
"200":
description: Updated list (count + added).
content:
application/json:
schema:
type: object
additionalProperties: true
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
"402":
$ref: "#/components/responses/UpgradeRequired"
components:
responses:
AuthRequired:
description: The saved workspace needs a signed-in apis.io API key — get one at https://apis.io/developer/.
content:
application/problem+json:
schema:
$ref: "#/components/schemas/Problem"
example:
type: https://apis.io/problems/auth-required
title: Authentication required
status: 401
detail: The saved workspace needs a signed-in apis.io API key. Get one at https://apis.io/developer/.
instance: /v1/me/lists
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
UpgradeRequired:
description: Payment Required — this operation needs a paid tier. Send a plan key in `X-API-Key`.
content:
application/problem+json:
schema:
$ref: "#/components/schemas/Problem"
example:
type: https://apis.io/problems/upgrade-required
title: Upgrade required
status: 402
detail: This endpoint requires the Understanding or Influence plan.
instance: /v1/ratings
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
NotFound:
description: Resource not found.
content:
application/problem+json:
schema:
$ref: "#/components/schemas/Problem"
example:
type: https://apis.io/problems/not-found
title: Resource not found
status: 404
detail: No API found with aid `twilio:nope`.
instance: /v1/apis/twilio:nope
headers:
ratelimit-policy:
$ref: "#/components/headers/RateLimitPolicy"
x-ratelimit-tier:
$ref: "#/components/headers/RateLimitTier"
x-ratelimit-limit:
$ref: "#/components/headers/RateLimitLimit"
x-ratelimit-window:
$ref: "#/components/headers/RateLimitWindow"
schemas:
Problem:
type: object
description: |
A Problem Details object per [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457).
Served as `application/problem+json`. Extension members (e.g. `parameter`) may be
added alongside the standard fields.
properties:
type:
type: string
format: uri
default: about:blank
description: A URI identifying the problem type; dereferences to human-readable docs.
examples:
- https://apis.io/problems/invalid-parameter
maxLength: 2048
title:
type: string
description: A short, human-readable summary of the problem type.
examples:
- Invalid parameter
maxLength: 1024
status:
type: integer
minimum: 100
maximum: 599
description: The HTTP status code, repeated for convenience.
examples:
- 400
detail:
type: string
description: A human-readable explanation specific to this occurrence.
maxLength: 20000
examples:
- "`match` must be one of: any, all."
instance:
type: string
format: uri-reference
description: A URI reference identifying the specific occurrence (typically the request path).
maxLength: 2048
examples:
- /v1/search
parameter:
type: string
description: Extension member — the offending query/path parameter, when applicable.
maxLength: 1024
examples:
- match
required:
- type
- title
- status
additionalProperties: true
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Send a plan key to be served above the free tier. Keyless callers get the free tier; a call that needs a paid tier answers 402 rather than refusing the connection.
headers:
RateLimitPolicy:
description: The quota and burst policy applied to this key, in the RFC 9745 RateLimit-Policy form.
schema:
type: string
maxLength: 1024
example: "\"quota\";q=500;w=86400, \"burst\";q=5;w=1"
RateLimitTier:
description: The tier the call was served at. Keyless callers are served `free`.
schema:
type: string
enum:
- free
- pro
- business
example: free
RateLimitLimit:
description: Requests allowed in the current quota window.
schema:
type: integer
maximum: 1000000
example: 500
RateLimitWindow:
description: Length of the quota window, in seconds.
schema:
type: integer
maximum: 1000000
example: 86400