> ## Documentation Index > Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt > Use this file to discover all available pages before exploring further. # Comprehensive search and analytics engine for user discovery and analysis > 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. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/user-info/people/search openapi: 3.0.1 info: title: eToro Api version: v1.206.0 description: >- eToro’s public API provides access to real-time financial data, trading insights, and account management features, allowing developers to integrate eToro’s services into their applications. With access to market prices, historical data, and social trading information, the API empowers users to enhance their trading strategies. Designed for security and scalability, the eToro API ensures smooth and reliable integration for a variety of financial applications. For more details on integrating with eToro's public WebSocket service, please refer to the dedicated [WebSocket documentation](./websocket/websocket-doc.html). servers: - url: https://public-api.etoro.com description: eToro Public API security: [] tags: - name: Agent Portfolios - name: Watchlists - name: Feeds - name: Asset Explorer - name: Market Data - name: Identity - name: Notifications - name: PI Data - name: Comments - name: Trading Demo - name: Trading Real - name: Users Info - name: Deprecated paths: /api/v1/user-info/people/search: get: tags: - Users Info summary: >- Comprehensive search and analytics engine for user discovery and analysis description: >- 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. operationId: comprehensiveSearchAnalyticsEngineUserDiscovery parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: 0c2b805c-0774-4449-91db-fed04333fb6d description: A unique request identifier. - name: x-api-key in: header required: true schema: type: string format: password example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663 description: API key for authentication. - name: x-user-key in: header required: true schema: type: string format: password example: >- eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_ description: User-specific authentication key. - name: period in: query description: >- Defines the time period for analyzing user metrics and performance data. Supports various predefined intervals for consistent analysis. required: true schema: type: string enum: - CurrMonth - CurrQuarter - CurrYear - LastYear - LastTwoYears - OneMonthAgo - TwoMonthsAgo - ThreeMonthsAgo - SixMonthsAgo - OneYearAgo example: LastYear - name: isTestAccount in: query description: >- When set to true, filters results to include only test/demo accounts. When false, shows only live accounts. Optional filter. required: false schema: type: boolean example: false - name: optIn in: query description: >- Filter for users who have explicitly opted in to specific features or programs. Used for compliance and feature-specific filtering. required: false schema: type: boolean example: true - name: blocked in: query description: >- When true, includes only blocked accounts in the results. Used for compliance and risk management purposes. required: false schema: type: boolean example: false - name: page in: query description: Page number for pagination. required: false schema: type: integer example: 1 - name: pageSize in: query description: Number of results per page. required: false schema: type: integer example: 10 - name: sort in: query description: Sort results by specific field (e.g., -copiers). required: false schema: type: string example: '-copiers' - name: popularInvestor in: query description: Filter for popular investors. required: false schema: type: boolean - name: gainMax in: query description: Max gain value filter. required: false schema: type: integer example: 100 - name: maxDailyRiskScoreMin in: query description: Minimum daily risk score. required: false schema: type: integer example: 1 - name: maxDailyRiskScoreMax in: query description: Maximum daily risk score. required: false schema: type: integer example: 7 - name: maxMonthlyRiskScoreMin in: query description: Minimum monthly risk score. required: false schema: type: integer example: 1 - name: maxMonthlyRiskScoreMax in: query description: Maximum monthly risk score. required: false schema: type: integer example: 6 - name: weeksSinceRegistrationMin in: query description: Minimum weeks since registration. required: false schema: type: integer example: 75 - name: countryId in: query description: The registered country ID of the user required: false schema: type: integer example: 101 - name: instrumentId in: query description: >- The instrument ID (you can also use this to exclude an instrument e.g., -5). required: false schema: type: integer example: -5 - name: instrumentPctMin in: query description: Minimum percentage of investment in the requested instrument ID. required: false schema: type: integer example: 100 - name: instrumentPctMax in: query description: Maximum percentage of investment in the requested instrument ID. required: false schema: type: integer example: 100 responses: '200': description: OK content: application/json: schema: type: object properties: totalItems: type: integer items: type: array items: type: object properties: customerId: type: integer userName: type: string fullName: type: string hasAvatar: type: boolean isSocialConnected: type: boolean isTestAccount: type: boolean displayFullName: type: boolean bonusOnly: type: boolean blocked: type: boolean verified: type: boolean popularInvestor: type: boolean copyBlock: type: boolean isFund: type: boolean isBronze: type: boolean fundType: type: integer tags: type: array items: type: integer gain: type: number format: float dailyGain: type: number format: float thisWeekGain: type: number format: float riskScore: type: integer maxDailyRiskScore: type: integer maxMonthlyRiskScore: type: integer copiers: type: integer copiedTrades: type: integer copyTradesPct: type: number format: float copyInvestmentPct: type: number format: float baseLineCopiers: type: integer copiersGain: type: number format: float aumTier: type: integer aumTierV2: type: integer aumTierDesc: type: string nullable: true virtualCopiers: type: integer trades: type: integer winRatio: type: number format: float dailyDd: type: number format: float weeklyDd: type: number format: float profitableWeeksPct: type: number format: float profitableMonthsPct: type: number format: float velocity: type: number format: float exposure: type: number format: float avgPosSize: type: number format: float optimalCopyPosSize: type: number format: float highLeveragePct: type: number format: float mediumLeveragePct: type: number format: float lowLeveragePct: type: number format: float peakToValley: type: number format: float peakToValleyStart: type: string format: date-time peakToValleyEnd: type: string format: date-time longPosPct: type: number format: float topTradedInstrumentId: type: integer topTradedAssetClassId: type: integer topTradedInstrumentPct: type: number format: float totalTradedInstruments: type: integer activeWeeks: type: integer firstActivity: type: integer description: >- Number of days since the beginning of the interval of a user's first trading activity lastActivity: type: integer description: >- Number of days from the last trading activity till the end of the interval activeWeeksPct: type: number format: float weeksSinceRegistration: type: integer country: type: string affiliateId: type: integer instrumentPct: type: number format: float countryId: type: integer description: The registered country ID of the user isPopularInvestor: type: boolean description: Indicates if the user is a popular investor topTradedAssetId: type: integer description: Top traded asset class ID in this interval required: - totalItems - items ````