Web Service Methods on 43 People

API → People

search_people

Will search for Profiles based on the q parameter that you pass it. Results will match usernames, first names, and last names.

Arguments:

api_key (required)
q (required)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>People search results for "erik" on 43 People</title>
  <link href="http://www.43people.com/search/query?q=erik" rel="alternate" type="text/html"/>
  <query>erik</query>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>5</total>
    <next_offset></next_offset>
  </pagination>
  <search_results>
    <PROFILE OBJECT>
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </search_results>
</feed>

The response contains this common object: Profile

Demo: /service/search_people?q=erik

get_profile

Returns the Profile based on the profile_id, or name, or, flickr_username parameters.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr).

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
  <PROFILE OBJECT>
  <wants_to_meet_people number="3">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </wants_to_meet_people>
  <has_met_people number="2">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </has_met_people>

The response contains this common object: Profile

Demo: /service/get_profile

get_profiles_who_want_to_meet_list

Returns a list of Profiles who want to meet this Profile.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>People who want to meet "erik" on 43 People</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>5</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <who_want_to_meet_list number="3">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </who_want_to_meet_list>
</feed>

The response contains this common object: Profile

Demo: /service/get_profiles_who_want_to_meet_list

get_profiles_who_have_met_list

Returns a list of Profiles who have met this Profile.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>People who have met "erik" on 43 People</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>5</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <who_have_met_list number="5">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </who_have_met_list>
</feed>

The response contains this common object: Profile

Demo: /service/get_profiles_who_have_met_list

get_profiles_wants_to_meet_list

Returns Profile’s wants to meet list of Profiles.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Erik's Wants To Meet People List</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>3</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <wants_to_meet_people_list number="3">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </wants_to_meet_people_list>
</feed>

The response contains this common object: Profile

Demo: /service/get_profiles_wants_to_meet_list

get_profiles_has_met_list

Returns Profile’s has met list of Profiles.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Person "Erik" Has Met People List</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>5</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <has_met_people_list number="5">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </has_met_people_list>
</feed>

The response contains this common object: Profile

Demo: /service/get_profiles_has_met_list

get_profiles_entries

Returns Entries written by the Profile.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Entries written by "Erik" on 43 People</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>124</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <entries number="124">
    <ENTRY OBJECT>
    <ENTRY OBJECT>
  </entries>
</feed>

The response contains this common object: Profile, Entry

Demo: /service/get_profiles_entries

get_entries_about_profile

Returns Entries written about the Profile.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Entries written about "Erik" on 43 People</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>124</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <entries number="124">
    <ENTRY OBJECT>
    <ENTRY OBJECT>
  </entries>
</feed>

The response contains this common objects: Profile, Entry

Demo: /service/get_entries_about_profile

get_profiles_images

Returns Images uploaded by the Profile for itself.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Erik's Images on 43 People</title>
  <PROFILE OBJECT>
  <images number="9">
    <IMAGE OBJECT>
    <IMAGE OBJECT>
  </images>
</feed>

The response contains this common objects: Profile, Image

Demo: /service/get_profiles_images

get_images_about_profile

Returns Images uploaded by the Profile as well as other folks.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Images of "Erik" on 43 People</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>19</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <images number="19">
    <IMAGE OBJECT>
    <IMAGE OBJECT>
  </images>
</feed>

The response contains this common objects: Profile, Image

Demo: /service/get_images_about_profile

get_profiles_tags

Returns Tags given by the Profile.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Tags by "Erik" on 43 People</title>
  <PROFILE OBJECT>
  <tags number="190">
    <TAG OBJECT>
    <TAG OBJECT>
  </tags>
</feed>

The response contains this common objects: Profile, Tag

Demo: /service/get_profiles_tags

get_tags_about_profile

Returns Tags describing the Profile. Optional: results can be filtered by person given the tags.

Arguments:

api_key (required)
id (the person’s profile id), or
name (the person’s username), or
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20 and can’t be higher than 20)
by_profile_id (Optional: filter results by person given the tags)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Tags written by Daniel about "Erik" on 43 People</title>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>190</total>
    <next_offset></next_offset>
  </pagination>
  <PROFILE OBJECT>
  <tags number="190">
    <TAG OBJECT>
    <TAG OBJECT>
  </tags>
</feed>

The response contains this common objects: Profile, Tag

Demo: /service/get_tags_about_profile

get_popular_people

Returns list of recent most popular Profiles.

Arguments:

api_key (required)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Popular People on 43 People</title>
  <popular_people number="2">
    <PROFILE OBJECT>
    <PROFILE OBJECT>
  </popular_people>
</feed>

The response contains this common objects: Profile

Demo: /service/get_popular_people

get_recent_conviviality

Returns list of recent activity on 43 People.

Arguments:

api_key (required)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43people.com/xml/2005/rc#">
  <title>Recent Activity on 43 People</title>
  <conviviality number="10">
  <meeting meeting_id="356">
    <description>Erik Benson wants to meet sangala</description>
    <person_one>
      <PROFILE OBJECT>
    </person_one>
    <person_two>
      <PROFILE OBJECT>
    </person_two>
  </meeting>
  </conviviality>
</feed>

The response contains this common objects: Profile

Demo: /service/get_recent_conviviality

Web Service Methods

API → People

The world wants to meet…