Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
creators

Search public Grove creators

Substring search across creator handle, ENS name, basename, and social identity values (X, YouTube, TikTok, etc.). Returns a narrow 'search card' shape — no tip stats. Frontend should call /v1/profiles/{handle} for enrichment on drill-in.

When q is omitted, returns the top N creators by all-time USD tipped so the search box has something useful to show on focus. Optional platform filter narrows to accounts that have at least one identity of that type.

Public endpoint — no authentication required.

get/v1/creators/search

Query parameters

qstring nullable

Search term. When omitted, returns top N creators by USD tipped (featured mode).

Search term. When omitted, returns top N creators by USD tipped (featured mode).

platformstring nullable

Optional identity_type filter (e.g., 'youtube', 'x', 'tiktok'). Narrows results to accounts that have at least one identity of that type.

Optional identity_type filter (e.g., 'youtube', 'x', 'tiktok'). Narrows results to accounts that have at least one identity of that type.

limitinteger

Max results per page.

Max results per page.

offsetinteger

Pagination offset (search mode only).

Pagination offset (search mode only).

Response

Matching or featured creators.

querystring nullable

Echo of the search term. Null when the endpoint is used in empty-query 'featured' mode.

platformstring nullable

Echo of the platform filter, if provided.

total_countinteger required

Total number of results available for this query (for pagination).

has_moreboolean required

True if another page is available beyond the current offset+limit window.