Creator River Searches API
The searches API from Creator River — 4 operation(s) for searches.
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/creatorriver-com:creatorriver-com-searches-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 Specification
openapi: 3.2.0
info:
title: Creatorriver Com Searches API
version: '1'
description: 'Operations tagged searches across 2 of this provider''s published API definitions: creatorriver-com-openapi.json, creatorriver-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.creatorriver.com/api/v1
security:
- apiKey: []
tags:
- name: searches
paths:
/searches:
get:
operationId: list_searches
summary: List past searches
description: Lists the searches run before, newest first, with their query, filters and how many results they had, including find_similar_creators ones. Free, and does not count against the daily search limit. To see a search’s results again, call get_search instead of searching again.
tags:
- searches
parameters:
- name: campaignId
in: query
required: false
description: Only the searches run for this campaign
schema:
description: Only the searches run for this campaign
type: string
minLength: 1
- name: includeArchived
in: query
required: false
description: Also list archived searches (default false)
schema:
description: Also list archived searches (default false)
type: boolean
- name: page
in: query
required: false
description: Page number, from 1
schema:
description: Page number, from 1
type: integer
minimum: 1
maximum: 9007199254740991
- name: limit
in: query
required: false
description: How many to return, 1-100 (default 20)
schema:
description: How many to return, 1-100 (default 20)
type: integer
minimum: 1
maximum: 100
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data: {}
required:
- data
4XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://www.creatorriver.com/api/v1
/searches/{searchId}:
get:
operationId: get_search
summary: Read a past search’s results again
description: Returns a past search and its results, in the order they were ranked, as search_creators returned them. Free, and does not count against the daily search limit.
tags:
- searches
parameters:
- name: searchId
in: path
required: true
description: Search id, from search_creators, find_similar_creators or list_searches
schema:
type: string
minLength: 1
description: Search id, from search_creators, find_similar_creators or list_searches
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data: {}
required:
- data
4XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
patch:
operationId: update_search
summary: Rename or archive a past search
description: 'Names a past search, or archives it so list_searches leaves it out (archived: false brings it back). Free.'
tags:
- searches
parameters:
- name: searchId
in: path
required: true
description: Search id, from search_creators, find_similar_creators or list_searches
schema:
type: string
minLength: 1
description: Search id, from search_creators, find_similar_creators or list_searches
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
description: New name
type: string
minLength: 1
maxLength: 80
archived:
description: true leaves it out of list_searches; false brings it back
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data: {}
required:
- data
4XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://www.creatorriver.com/api/v1
/searches/filters:
get:
operationId: get_search_filters
summary: List the values the search filters take
description: 'Returns the values the search and browse filters accept: platforms, creator countries and languages present in the database, niches and activity windows. Free.'
tags:
- searches
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data: {}
required:
- data
4XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://www.creatorriver.com/api/v1
/searches/{searchId}/export:
get:
operationId: export_search
summary: Export a search’s results as CSV
description: 'Returns a search’s results as CSV text, one row per creator in rank order, as the dashboard’s export does: handles and profile links only for unlocked creators, and emails only for ones already revealed. Free. Save csv to a file named filename.'
tags:
- searches
parameters:
- name: searchId
in: path
required: true
description: Search id, from search_creators, find_similar_creators or list_searches
schema:
type: string
minLength: 1
description: Search id, from search_creators, find_similar_creators or list_searches
- name: scope
in: query
required: false
description: all results (default), or only the ones added to a campaign
schema:
description: all results (default), or only the ones added to a campaign
type: string
enum:
- all
- added
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data: {}
required:
- data
4XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Failure; `error.code` says what to do
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://www.creatorriver.com/api/v1
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
enum:
- unauthorized
- not_found
- invalid_input
- insufficient_credits
- rate_limited
- conflict
- internal
message:
type: string
details:
type: object
requestId:
type: string
securitySchemes:
apiKey:
type: http
scheme: bearer
description: An API key from https://www.creatorriver.com/settings/apikeys
x-refined-from:
- creatorriver-com-openapi.json
- creatorriver-com-openapi.yml