Back to Apis

Saved Workspace

developer-api-saved-workspace.md

latest4.1 KB
Original Source

APIs.io API

APIs.io API

Saved Workspace

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.


List your saved searches.

GET https://apis.io/api/v1

/me/searches

The saved searches owned by the authenticated key. Pro. Requires an API key.

List your saved searches. › Responses

200401402

Your saved searches.


Create a saved search.

POST https://apis.io/api/v1

/me/searches

Persist a named search using the same filter vocabulary as /search. Pro.

Create a saved search. › Request Body

name ​string · required

q ​string

tags ​string[]

band ​string[]

industry ​string[]

region ​string[]

area ​string[]

artifact_types ​string[]

match ​string · enum

Enum values: any

all

min_score ​number

Create a saved search. › Responses

201401402

The created saved search (id, name, criteria).


Delete a saved search you own.

DELETE https://apis.io/api/v1

/me/searches/{id}

Permanently removes the saved search and its delta cursor. Pro.

Delete a saved search you own. › path Parameters

id ​string · required

Delete a saved search you own. › Responses

200402

Deleted.


Re-run a saved search against the live catalog.

GET https://apis.io/api/v1

/me/searches/{id}/results

Re-runs the stored criteria and returns providers that currently match. Pro.

Re-run a saved search against the live catalog. › path Parameters

id ​string · required

Re-run a saved search against the live catalog. › query Parameters

limit ​integer

Re-run a saved search against the live catalog. › Responses

200402

Current matching providers.


What's NEW for a saved search since you last checked.

GET https://apis.io/api/v1

/me/searches/{id}/net_new

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.

What's NEW for a saved search since you last checked. › path Parameters

id ​string · required

What's NEW for a saved search since you last checked. › Responses

200402

Net-new matches + advanced cursor.


List the lists/shortlists you own.

GET https://apis.io/api/v1

/me/lists

List the lists/shortlists you own. › Responses

200401402

Your lists.


Create a named, persistent list.

POST https://apis.io/api/v1

/me/lists

Creates a shortlist/stack you own; seed it with provider slugs and/or aids. Pro.

Create a named, persistent list. › Request Body

name ​string · required

members ​string[]

Provider slugs and/or aids.

Create a named, persistent list. › Responses

201402

The created list.


Get a list, members resolved to current name/band/score.

GET https://apis.io/api/v1

/me/lists/{id}

Returns the list with each member resolved to its current profile and rating. Pro.

Get a list, members resolved to current name/band/score. › path Parameters

id ​string · required

Get a list, members resolved to current name/band/score. › Responses

200402

The list with resolved members.


Delete a list you own.

DELETE https://apis.io/api/v1

/me/lists/{id}

Permanently removes the list. Pro.

Delete a list you own. › path Parameters

id ​string · required

Delete a list you own. › Responses

200402

Deleted.


Add providers/APIs to a list.

POST https://apis.io/api/v1

/me/lists/{id}/entries

Appends providers/APIs (by slug or aid) to the list, de-duplicated. Pro.

Add providers/APIs to a list. › path Parameters

id ​string · required

Add providers/APIs to a list. › Request Body

members ​string[] · required

Add providers/APIs to a list. › Responses

200402

Updated list (count + added).


Resolve & EnrichExport