Search
GET from https://api.madmimi.com/audience_members/search
with 3 parameters:
username
▪ Your Mad Mimi API Key (
api_key
)▪ A
query
or email
▪ (Optional)
raw
- If true then search suppressed members tooThe query
parameter can be any search criteria you can use in the interface. A common use would be to use this function to get all of a member's details by sending the email address as the query. If you know the exact email address of the audience member, the email
parameter can be used instead of query
. email
will return results much faster.
Sample output
GET https://api.madmimi.com/audience_members/search.xml?username=username&api_key=api_key&query=support[at]madmimi.com
<audience>
<member suppressed="false">
<first_name>Mad</first_name>
<last_name>Mimi</last_name>
<email>support@madmimi.com</email>
<created_at>Tue Apr 20 14:30:25 -0400 2010</created_at>
<city/>
<phone/>
<company>Mad Mimi</company>
<title>Mrs</title>
<address/>
<state/>
<zip/>
<country>US</country>
<confirmed/>
<birthday/>
<categories/>
<friend_name>Marc</friend_name>
<lists>
<list>test</list>
</lists>
</member>
</audience>
Note, the output will contain a maximum of 100 members. All the members custom columns will be included. The lists section will contain the names of all the lists the member is part of.
Adding to a list
You can add the results of the search to a new or existing list by passing an additional add_list
parameter with the name of the list.