search_members
Search for members across all Mailchimp audiences using email or name, returning exact and fuzzy matches to find a specific person without knowing their audience.
Instructions
Search for members across all audiences by email address or name, returning both exact and fuzzy matches.
Use when looking for a specific person and you may not know which audience they belong to. Use list_audience_members instead to browse all members of a known audience. Use get_member_activity or get_member_tags after finding a member for engagement data.
Authenticated via API key. Subject to Mailchimp API rate limits (max 10 concurrent requests). Read-only, safe to retry.
Args: query: Search query. Full email address for exact match, or name/partial email for fuzzy search. Minimum 3 characters. list_id: Optional audience/list ID to restrict search to a single audience. Obtain from list_audiences.
Returns: JSON with results array combining exact and fuzzy matches. Each result: email, status ('subscribed', 'unsubscribed', etc.), full_name, list_id (audience the member belongs to). Exact matches appear first.
Example: search_members(query="john@example.com") -> {"results": [{"email": "john@example.com", "status": "subscribed", "list_id": "abc123", ...}]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| list_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |