Web Service Methods - People on 43 Things

API → People

search_people

Will search for people 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://43things.com/xml/2005/rc#">
  <title>People search results for "erik" on 43 Things</title>
  <link href="http://www.43things.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>
  <PERSON OBJECT>
  <PERSON OBJECT>
  <PERSON OBJECT>
</feed>

The response contains this common object: Person

Demo: /service/search_people?q=erik

search_people_by_email

Will search for people based on the q* parameter that you pass it. Results will match email addresses that have been validated for a particular account.

*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://43things.com/xml/2005/rc#">
  <title>People search results for "erik@mockerybird.com" on 43 Things</title>
  <link href="http://www.43things.com/search/query?q=erik%40mockerybird.com" rel="alternate" type="text/html"/>
  <query>erik@mockerybird.com</query>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>3</total>
    <next_offset></next_offset>
  </pagination>
  <PERSON OBJECT>
  <PERSON OBJECT>
  <PERSON OBJECT>
</feed>

The response contains this common object: Person

Demo: /service/search_people_by_email?q=erik@mockerybird.com

get_person

Returns a Person based on their username.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
flickr_username (the person’s username on flickr)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<person person_id="1">
  <username>erik</username>
  <name>Erik Benson</name>
  <url>http://erikbenson.com</url>
  <num_open_goals>32</num_open_goals>
  <profile_image_url>http://images.43places.com/profile/12436s75.jpg</profile_image_url>
  <num_open_goals>32</num_open_goals>
  <link href="http://www.43things.com/people/view/erik" rel="alternate" type="text/html"/>
  <CITY OBJECT>
  <open_goals number="32">
    <GOAL OBJECT>
    <GOAL OBJECT>
    <GOAL OBJECT>
  </open_goals>
</person>

The response contains these common objects: Goal, City

Demo: /service/get_person?id=erik

get_persons_completed_things

This returns a list of goals that a person has marked as complete.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
flickr_username (the person’s username on flickr)
offset (optional, default is 0)
max (optional, default is 20)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<person person_id="1">
  <username>erik</username>
  <name>Erik Benson</name>
  <url>http://erikbenson.com</url>
  <num_open_goals>32</num_open_goals>
  <profile_image_url>http://images.43places.com/profile/12436s75.jpg</profile_image_url>
  <num_open_goals>32</num_open_goals>
  <link href="http://www.43things.com/people/view/erik" rel="alternate" type="text/html"/>
  <CITY OBJECT>
  <completed_goals number="10">
    <GOAL OBJECT>
    <GOAL OBJECT>
    <GOAL OBJECT>
  </completed_goals>
</person>

The response contains these common objects: Goal, City

Demo: /service/get_persons_completed_things?id=erik

get_persons_entries

This returns a list of entries that the given person has written, in reverse chronological order.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
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://43things.com/xml/2005/rc#">
  <title>Erik Benson's entries at 43 Things</title>
  <link href="http://www.43things.com/people/view/erik" rel="alternate" type="text/html"/>
  <link href="http://www.43things.com/service/entry" rel="service.post" type="application/x.atom+xml"/>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>46</total>
    <next_offset>20</next_offset>
  </pagination>
  <ENTRY OBJECT>
  <ENTRY OBJECT>
  <ENTRY OBJECT>
</feed>

The response contains this common object: Entry

Demo: /service/get_persons_entries?id=erik

Returns information associated with the given person on the given goal, including tags, cheers given for this goal, entries written about it, and whether or not it has been marked as complete. If it has been marked as complete, we’ll also send flags for whether they thought it was worth doing, and whether they are willing to help others with this goal.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
flickr_username (the person’s username on flickr)
goal_id (required)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>Erik Benson's progress on "start a company that survives longer than 2 years" at 43 Things</title>
  <link href="http://www.43things.com/people/progress/erik/7" rel="alternate" type="text/html"/>
  <GOAL OBJECT>
  <progress>
    <num_cheers>4</num_cheers>
    <goal_completed>0</goal_completed>
  </progress>
  <tags>
    <tag>start-up</tag>
    <tag>entrepreneur</tag>
    <tag>business</tag>
  </tags>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>1</total>
    <next_offset></next_offset>
  </pagination>
  <ENTRY OBJECT>
  <ENTRY OBJECT>
  <ENTRY OBJECT>
</feed>

The response contains these common objects: Goal, Entry

Demo: /service/get_persons_progress_on_goal?id=erik&goal_id=9

get_persons_teammates

Returns a list of people who the given person is on a team with.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
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://43things.com/xml/2005/rc#">
  <title>Erik Benson's teammates on 43 Things</title>
  <link href="http://www.43things.com/people/teammates/erik" rel="alternate" type="text/html"/>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>18</total>
    <next_offset></next_offset>
  </pagination>
  <PERSON OBJECT>
  <PERSON OBJECT>
  <PERSON OBJECT>
</feed>

The response contains this common object: Person

Demo: /service/get_persons_teammates?id=erik

get_persons_neighbors

Returns a list of people who are doing the same things as the given person.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
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://43things.com/xml/2005/rc#">
  <title>People who are doing the same things as Erik Benson on 43 Things</title>
  <link href="http://www.43things.com/people/neighbors/erik" rel="alternate" type="text/html"/>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>717</total>
    <next_offset>20</next_offset>
  </pagination>
  <PERSON OBJECT>
  <PERSON OBJECT>
  <PERSON OBJECT>
</feed>

The response contains this common object: Person

Demo: /service/get_persons_neighbors?id=erik

get_persons_tags

Returns a list of tags that this person has given goals on their list. Each tag will also include a count that represents the number of goals that they’ve tagged with that tag.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
flickr_username (the person’s username on flickr)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>Erik Benson's tags on 43 Things</title>
  <link href="http://www.43things.com/people/tags/erik" rel="alternate" type="text/html"/>
  <tags>
    <tag count="2">conference</tag>
    <tag count="2">movies</tag>
    <tag count="2">car</tag>
    <tag count="2">web services</tag>
    <tag count="2">television</tag>
    <tag count="2">fiction</tag>
    <tag count="2">celebrities</tag>
    <tag count="2">cities</tag>
    <tag count="2">travel</tag>
    <tag count="2">ambitious</tag>
  </tags>
</feed>

Demo: /service/get_persons_tags?id=erik

get_persons_tag_cloud

This will return a list of tags that other people have given to goals on this person’s list. Along with each tag is the number of times that tag has been associated with the goals on their list.

Arguments:

api_key (required)
id (the person’s username, required unless flickr_username is supplied)
flickr_username (the person’s username on flickr)

An Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>How people are tagging goals on Erik Benson's list on 43 Things</title>
  <link href="http://www.43things.com/people/tag_cloud/erik" rel="alternate" type="text/html"/>
  <tags>
    <tag count="18">travel</tag>
    <tag count="14">japan</tag>
    <tag count="11">43 things</tag>
    <tag count="9">testing</tag>
    <tag count="9">visit</tag>
    <tag count="7">blog</tag>
    <tag count="7">beta</tag>
    <tag count="7">beta test</tag>
    <tag count="6">computer</tag>
    <tag count="5">notebook</tag>
  </tags>

Demo: /service/get_persons_tag_cloud?id=erik

get_subscriptions

This method requires authentication. It returns a list of people who the authenticated person is currently subscribed to.

Arguments:

api_key (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://43things.com/xml/2005/rc#">
  <title>People you're subscribed to on 43 Things</title>
  <link href="http://www.43things.com/people/subscriptions" rel="alternate" type="text/html"/>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>717</total>
    <next_offset>20</next_offset>
  </pagination>
  <PERSON OBJECT>
  <PERSON OBJECT>
  <PERSON OBJECT>
</feed>

The response contains this common object: Person

Demo: /service/get_subscriptions

City Hall FAQ Guidelines Contact Us	Tools iPhone App RSS API	About Us Our blog Press coverage Terms of Use	Follow @43things
			Copyright © 2004 - 2013 Robot Co-op