GRgrove
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

Request

  • Base URL
    https://api.grove.city (the document declares no server; this is the origin it was published from)
  • URL
    https://api.grove.city/v1/creators/search
  • Auth
    none declared

Query parameters

qstring nullable

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.

limitinteger

Max results per page.

offsetinteger

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.

Changes

No recorded changes to this operation across all 1 revision of this API.