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

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

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

POST/me/searches

curl https://apis.io/api/v1/me/searches \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "name": "name",
  "q": "q",
  "tags": [
    "string"
  ],
  "band": [
    "string"
  ],
  "industry": [
    "string"
  ],
  "region": [
    "string"
  ],
  "area": [
    "string"
  ],
  "artifact_types": [
    "string"
  ],
  "match": "any",
  "min_score": 0
}'

Example Request Body

{
  "name": "name",
  "q": "q",
  "tags": [
    "string"
  ],
  "band": [
    "string"
  ],
  "industry": [
    "string"
  ],
  "region": [
    "string"
  ],
  "area": [
    "string"
  ],
  "artifact_types": [
    "string"
  ],
  "match": "any",
  "min_score": 0
}

json

Example Responses

{}

json

application/json

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

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

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

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

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

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

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

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

Updated list (count + added).

Your workspace root — plan, counts, and where things live.

GET

https://apis.io/api/v1

/me

What you have saved here and where to find it, plus the plan you are on. NOT the account: login, API key, usage and billing live at /v1/auth/me, which authenticates with a session rather than a key. Counts rather than contents — a root that inlined every saved search would be the heaviest response here for a caller who mostly wants to know where things are. A count that cannot be read comes back as null with a note, never as a zero and never as an error: the urls are still true when the store is not reachable.

Your workspace root — plan, counts, and where things live. › Responses

The workspace root.

user

string

object

note

string

object

Resolve & Enrich Capabilities

APIs.io API

Saved Workspace

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

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

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

POST/me/searches

curl https://apis.io/api/v1/me/searches \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "name": "name",
  "q": "q",
  "tags": [
    "string"
  ],
  "band": [
    "string"
  ],
  "industry": [
    "string"
  ],
  "region": [
    "string"
  ],
  "area": [
    "string"
  ],
  "artifact_types": [
    "string"
  ],
  "match": "any",
  "min_score": 0
}'

Example Request Body

{
  "name": "name",
  "q": "q",
  "tags": [
    "string"
  ],
  "band": [
    "string"
  ],
  "industry": [
    "string"
  ],
  "region": [
    "string"
  ],
  "area": [
    "string"
  ],
  "artifact_types": [
    "string"
  ],
  "match": "any",
  "min_score": 0
}

json

Example Responses

{}

json

application/json

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

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

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

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

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

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

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

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

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

Updated list (count + added).

Your workspace root — plan, counts, and where things live.

GET

https://apis.io/api/v1

/me

Your workspace root — plan, counts, and where things live. › Responses

The workspace root.

user

string

object

note

string

object

Resolve & Enrich Capabilities