---
title: "Search users"
method: GET
path: "/api/v1/user-info/people/search"
tags: ["Users Info"]
---

# Search users

`GET /api/v1/user-info/people/search`

**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

---

Powerful search platform that enables advanced user discovery with comprehensive filtering capabilities. Supports complex queries across multiple dimensions including performance metrics, risk profiles, investment patterns, and account characteristics. Ideal for identifying users based on specific trading behaviors and performance criteria.

## Query parameters

- `period` 'CurrMonth' | 'CurrQuarter' | 'CurrYear' | 'LastYear' | 'LastTwoYears' | 'OneMonthAgo' | 'TwoMonthsAgo' | 'ThreeMonthsAgo' | 'SixMonthsAgo' | 'OneYearAgo', required
- `isTestAccount` boolean
- `optIn` boolean
- `blocked` boolean
- `page` integer
- `pageSize` integer
- `sort` string
- `popularInvestor` boolean
- `gainMax` integer
- `maxDailyRiskScoreMin` integer
- `maxDailyRiskScoreMax` integer
- `maxMonthlyRiskScoreMin` integer
- `maxMonthlyRiskScoreMax` integer
- `weeksSinceRegistrationMin` integer
- `countryId` integer
- `instrumentId` integer
- `instrumentPctMin` integer
- `instrumentPctMax` integer

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required

## Response `200`

OK

- object
  - `totalItems` integer, required
  - `items` object[], required
    - `customerId` integer
    - `userName` string
    - `fullName` string
    - `hasAvatar` boolean
    - `isSocialConnected` boolean
    - `isTestAccount` boolean
    - `displayFullName` boolean
    - `bonusOnly` boolean
    - `blocked` boolean
    - `verified` boolean
    - `popularInvestor` boolean
    - `copyBlock` boolean
    - `isFund` boolean
    - `isBronze` boolean
    - `fundType` integer
    - `tags` integer[]
    - `gain` number, float
    - `dailyGain` number, float
    - `thisWeekGain` number, float
    - `riskScore` integer
    - `maxDailyRiskScore` integer
    - `maxMonthlyRiskScore` integer
    - `copiers` integer
    - `copiedTrades` integer
    - `copyTradesPct` number, float
    - `copyInvestmentPct` number, float
    - `baseLineCopiers` integer
    - `copiersGain` number, float
    - `aumTier` integer
    - `aumTierV2` integer
    - `aumTierDesc` string, nullable
    - `virtualCopiers` integer
    - `trades` integer
    - `winRatio` number, float
    - `dailyDd` number, float
    - `weeklyDd` number, float
    - `profitableWeeksPct` number, float
    - `profitableMonthsPct` number, float
    - `velocity` number, float
    - `exposure` number, float
    - `avgPosSize` number, float
    - `optimalCopyPosSize` number, float
    - `highLeveragePct` number, float
    - `mediumLeveragePct` number, float
    - `lowLeveragePct` number, float
    - `peakToValley` number, float
    - `peakToValleyStart` string, date-time
    - `peakToValleyEnd` string, date-time
    - `longPosPct` number, float
    - `topTradedInstrumentId` integer
    - `topTradedAssetClassId` integer
    - `topTradedInstrumentPct` number, float
    - `totalTradedInstruments` integer
    - `activeWeeks` integer
    - `firstActivity` integer — Number of days since the beginning of the interval of a user's first trading activity
    - `lastActivity` integer — Number of days from the last trading activity till the end of the interval
    - `activeWeeksPct` number, float
    - `weeksSinceRegistration` integer
    - `country` string
    - `affiliateId` integer
    - `instrumentPct` number, float
    - `countryId` integer — The registered country ID of the user
    - `isPopularInvestor` boolean — Indicates if the user is a popular investor
    - `topTradedAssetId` integer — Top traded asset class ID in this interval

## Other responses

- `429` — Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded.

---

[API](https://skmtc.net/etoro/apis/etoro-api.md) · [All operations](https://skmtc.net/etoro/apis/etoro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/etoro/etoro-api/revisions/69c1fb266c35/schema)