List Frequent Values

get

https://api.mbd.xyz/v3/studio/search/frequent_values/{index}/{field}

Retrieve the most frequently occurring values for a specific field in an index.

This endpoint is useful for discovering popular values in a field before building filters or queries. Common use cases include:

Discovering popular languages (lang field)
Finding trending channels/topics (channels field)
Identifying common AI labels (ai_labels_med, ai_labels_high fields)
Exploring active features of any keyword field

Data Scope: Results are based on data from the last 7 days. This ensures you get recently relevant values rather than historical ones. The exact date field used varies by index:

farcaster-items: item_creation_timestamp
polymarket-items: created_at
polymarket-wallets: updated_at
zora-coins: zora_updated_at
kalshi-items: updated_at
kalshi-wallets: updated_at
token-items: last_updated

Results are sorted by frequency (highest first) and limited to the requested size (default 100).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

index

string

enum

required

The Elasticsearch index to query for frequent values

Allowed:

field

string

required

The field within the index to analyze for frequent values. Works best with keyword or categorical fields.

Common fields by index:

farcaster-items: lang, app, channels, ai_labels_med, ai_labels_high, publication_type
polymarket-items: category, tags, currency
polymarket-wallets: primary_labels, secondary_labels, ai_labels_med, ai_labels_high
zora-coins: zora_symbol, zora_creator_farcaster_id
kalshi-items: tags, series_category, ai_labels_med, ai_labels_high, status
kalshi-wallets: primary_tags, primary_labels, ai_labels
token-items: chain, symbol, name

Query Params

size

integer

1 to 10000

Defaults to 100

Maximum number of frequent values to return. Results are limited to prevent excessive memory usage.

Responses

200Successful list of frequent values

400Invalid request parameters

401Unauthorized - missing or invalid API token