Search audience members | Smallest AI Docs

Search for members within a specific audience using flexible search parameters. Users can only search members of audiences they created.

Search Types:

General Search (query): Searches across all fields in the audience member data
Field-Specific Search: Use any field name as a parameter (e.g., firstName=john, phoneNumber=123456, email=test@example.com)

Examples:

?query=john - General search across all fields
?firstName=john - Search specifically in firstName field
?phoneNumber=555-1234 - Search specifically in phoneNumber field
?firstName=john&lastName=doe - Search for members matching both criteria

Note: When using phoneNumber field, do not use quotes around the phone number. You can use either a general search OR field-specific searches, but not both simultaneously.

Search for members within a specific audience using flexible search parameters. Users can only search members of audiences they created. **Search Types:** - **General Search** (`query`): Searches across all fields in the audience member data - **Field-Specific Search**: Use any field name as a parameter (e.g., `firstName=john`, `phoneNumber=123456`, `email=test@example.com`) **Examples:** - `?query=john` - General search across all fields - `?firstName=john` - Search specifically in firstName field - `?phoneNumber=555-1234` - Search specifically in phoneNumber field - `?firstName=john&lastName=doe` - Search for members matching both criteria **Note:** When using phoneNumber field, do not use quotes around the phone number. You can use either a general search OR field-specific searches, but not both simultaneously.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired

The unique identifier of the audience

Query parameters

querystringOptional

General search term that searches across all fields in audience member data

Response

Search results returned successfully

statusboolean

dataobject

Errors

400

Bad Request Error

500

Internal Server Error

Search for members within a specific audience using flexible search parameters. Users can only search members of audiences they created.

Search Types:

General Search (query): Searches across all fields in the audience member data
Field-Specific Search: Use any field name as a parameter (e.g., firstName=john, phoneNumber=123456, email=test@example.com)

Examples:

?query=john - General search across all fields
?firstName=john - Search specifically in firstName field
?phoneNumber=555-1234 - Search specifically in phoneNumber field
?firstName=john&lastName=doe - Search for members matching both criteria

Note: When using phoneNumber field, do not use quotes around the phone number. You can use either a general search OR field-specific searches, but not both simultaneously.

1	from smallest_ai import SmallestAI
2
3	client = SmallestAI(
4	token="YOUR_TOKEN_HERE",
5	)
6
7	client.atoms.audience.search_audience_members(
8	id="60d0fe4f5311236168a109ca",
9	)

1	{
2	"status": true,
3	"data": {
4	"members": [
5	{
6	"_id": "60d0fe4f5311236168a109cd",
7	"data": {
8	"phoneNumber": "+1234567890",
9	"name": "John Doe",
10	"email": "john@example.com"
11	}
12	}
13	],
14	"searchInfo": {
15	"searchType": "field",
16	"searchTerm": "john",
17	"searchFields": [
18	"firstName",
19	"lastName"
20	],
21	"totalResults": 5
22	}
23	}
24	}