> ## Documentation Index > Fetch the complete documentation index at: https://developers.usewave.co/llms.txt > Use this file to discover all available pages before exploring further. # Get Audience Leads > Retrieve paginated, sorted, and filtered Instagram lead profiles collected within a specific audience list. ## OpenAPI ````yaml GET /api/v1/audiences/{id}/leads openapi: 3.1.0 info: title: Wave Public API description: >- ### Authentication All public endpoints require a valid API Key provided via header: * **Authorization:** `Bearer wave_live_...` ### Access Control API access is tied directly to your Wave subscription. An active or trialing subscription is required. Inactive subscriptions will receive a `403 Forbidden` error. ### Rate Limiting Requests are limited per API key using a 60-second sliding window. Tiers: **Paid** Subscription get 60 requests/min, **Trial** Subscription get 30 requests/min. Every authenticated response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. Exceeding the limit returns `429 Too Many Requests` with a `Retry-After` header indicating the seconds to wait. license: name: Proprietary url: https://app.usewave.co/ version: 1.0.0 servers: [] security: [] paths: /api/v1/audiences/{id}/leads: get: tags: - Audiences summary: Get Audience Leads description: >- Retrieves paginated, sorted, and filtered Instagram lead profiles collected within an audience list. The `filters` query parameter accepts a JSON-encoded string to filter leads by columns. Supported keys: - `follower_count`: `{"min": int, "max": int}` - `post_count`: `{"min": int, "max": int}` - `is_verified`: `bool` - `is_public`: `bool` - `has_profile_picture`: `bool` - `account_type`: `'Business'` or `'Personal'` - `keywords`: `{"include": ["str"], "exclude": ["str"]}` Example JSON string: `{"follower_count": {"min": 500, "max": 50000}, "is_verified": true}` operationId: get_audience_list_leads parameters: - name: id in: path required: true schema: type: string title: Id - name: page in: query required: false schema: anyOf: - type: integer minimum: 1 - type: 'null' description: Page number (starts at 1) default: 1 title: Page description: Page number (starts at 1) - name: limit in: query required: false schema: anyOf: - type: integer maximum: 100 minimum: 1 - type: 'null' description: Items per page (max 100) default: 15 title: Limit description: Items per page (max 100) - name: sort_field in: query required: false schema: anyOf: - type: string - type: 'null' description: Field name to sort by (e.g. 'follower_count' or 'username') title: Sort Field description: Field name to sort by (e.g. 'follower_count' or 'username') - name: sort_order in: query required: false schema: anyOf: - type: string pattern: ^(asc|desc)$ - type: 'null' description: 'Sort direction: ''asc'' or ''desc''' title: Sort Order description: 'Sort direction: ''asc'' or ''desc''' - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search term to filter leads by username or bio title: Search description: Search term to filter leads by username or bio - name: filters in: query required: false schema: anyOf: - type: string - type: 'null' description: >- JSON-encoded string of column filter criteria. Example: '{"follower_count": {"min": 500, "max": 50000}, "is_verified": true, "account_type": "Business"}' title: Filters description: >- JSON-encoded string of column filter criteria. Example: '{"follower_count": {"min": 500, "max": 50000}, "is_verified": true, "account_type": "Business"}' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicAudienceLeadsResponse' '400': description: Bad Request - Invalid parameters or input payload content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '401': description: Unauthorized - Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '403': description: Forbidden - Active subscription required content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '404': description: >- Not Found - The resource does not exist or belongs to another account content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '422': description: Unprocessable Entity - Schema validation failed content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '429': description: Rate Limit Exceeded - Request quota exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '500': description: Internal Server Error - Unexpected server error content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' security: - HTTPBearer: [] components: schemas: PublicAudienceLeadsResponse: properties: data: items: additionalProperties: true type: object type: array title: Data description: Array of extracted Instagram profile objects page: type: integer title: Page description: Current page number example: 1 limit: type: integer title: Limit description: Page size limit example: 15 total: type: integer title: Total description: Total leads matching search/filter criteria example: 320 total_pages: type: integer title: Total Pages description: Total pages available example: 22 search: anyOf: - type: string - type: 'null' title: Search description: Search term applied filters: anyOf: - {} - type: 'null' title: Filters description: >- Column filter rules applied. Can be passed as a JSON-encoded string in query params. Example: '{"follower_count": {"min": 500, "max": 50000}, "is_verified": true, "account_type": "Business"}' type: object required: - data - page - limit - total - total_pages title: PublicAudienceLeadsResponse description: Paginated list of leads with search and filter state. ErrorMessageResponse: properties: status: type: integer title: Status description: HTTP status code example: 400 error: type: string title: Error description: HTTP status phrase or category example: Bad Request message: type: string title: Message description: Human-readable explanation of the error example: Invalid request parameters. details: anyOf: - {} - type: 'null' title: Details description: Granular validation failure details or contextual information type: object required: - status - error - message title: ErrorMessageResponse description: Standardized public error response structure modeled after Dripify. securitySchemes: HTTPBearer: type: http description: 'Enter your API key: `wave_live_`' scheme: bearer ````