Web Service Methods

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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>People search results for "todd" on 43 Places</title>
  <link href="http://www.43places.com/search/query?q=todd" rel="alternate" type="text/html"/>
  <query>todd</query>
<pagination>
  <offset>0</offset>
  <max>20</max>
  <total>6</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=todd

get_person

Returns a Person based on their username.

Arguments:
  • api_key (required)
  • id (the person’s username, required)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<person person_id="pugetive">
  <username>pugetive</username>
  <name>Todd Gehman</name>
  <url>http://www.pugetive.com</url>
  <flickr_username>pugetive</flickr_username>
  <num_wants_to_visit>43</num_wants_to_visit>
<profile_image_url>http://images.43things.com/profile/00/00/55/21881s.jpg</profile_image_url>
  <link href="http://www.43places.com/person/pugetive" rel="alternate" type="text/html"/>
<num_wants_to_visit number="43">
  <PLACE OBJECT>
  <PLACE OBJECT>
</num_wants_to_visit>
</person>

The response contains these common objects: Place Demo: /service/get_person?id=pugetive

get_persons_visited_places

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

Arguments:
  • api_key (required)
  • id (the person’s username, required)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<person person_id="pugetive">
  <username>pugetive</username>
  <name>Todd Gehman</name>
  <url>http://www.pugetive.com</url>
  <flickr_username>pugetive</flickr_username>
  <num_wants_to_visit>43</num_wants_to_visit>

  <profile_image_url>http://images.43things.com/profile/00/00/55/21881s.jpg</profile_image_url>
  <link href="http://www.43places.com/person/pugetive" rel="alternate" type="text/html"/>
<PLACE OBJECT>
<num_visited_places number="10">
   <PLACE OBJECT>
   <PLACE OBJECT>
</num_visited_places>
</person>

The response contains these common objects: Place

Demo: /service/get_persons_visited_places?id=pugetive

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)
  • 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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Todd Gehman's entries on 43 Places</title>
  <link href="http://www.43places.com/person/pugetive" rel="alternate" type="text/html"/>
  <link href="http://www.43places.com/service/entry" rel="service.post" type="application/x.atom+xml"/>
<pagination>
  <offset>0</offset>
  <max>20</max>
  <total>85</total>

  <next_offset>20</next_offset>
  <ENTRY OBJECT>
  <ENTRY OBJECT>
</pagination>

The response contains this common object: Entry

Demo: /service/get_persons_entries?id=pugetive

get_persons_progress_on_place

This returns a summary of user’s activity: tags, cheers, entries that the given person has written about this place.

Arguments:
  • api_key (required)
  • id (the person’s username, required)
  • place_id (place id, 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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Buster McLeod's progress on "Seattle" on 43 Places</title>
  <link href="http://www.43places.com/person/erik" rel="alternate" type="text/html"/>
 <PLACE OBJECT>
<progress>
<num_cheers>0</num_cheers>
<has_place>true</has_place>
<has_visited>true</has_visited>
<worth_doing>true</worth_doing>
<willing_to_help>true</willing_to_help>
</progress>
<tags>
<tag>rain</tag>
<tag>coffee</tag>
</tags>
<pagination>
  <offset>0</offset>
  <max>20</max>
  <total>85</total>
  <next_offset>20</next_offset>
</pagination>
  <ENTRY OBJECT>
  <ENTRY OBJECT>

Demo: /service/get_persons_progress_on_place?id=erik&place_id=106707

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)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Erik Benson's tags on 43 Places</title>
  <link href="http://www.43places.com/people/tags/erik" rel="alternate" type="text/html"/>
  <tags>
<tag count="9">bar</tag>
<tag count="7">restaurant</tag>
<tag count="5">beautiful</tag>
<tag count="5">tourist destination</tag>
<tag count="4">beaches</tag>
<tag count="4">fancy</tag>
<tag count="4">hot</tag>
<tag count="4">camping</tag>
<tag count="3">big city</tag>
<tag count="3">hiking</tag>
<tag count="3">greasy</tag>
<tag count="3">belltown</tag>
<tag count="3">date spot</tag>
<tag count="3">wine</tag>
<tag count="3">new urbanism</tag>
</tag>
</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)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>How people are tagging places on Erik Benson's list on 43 Places</title>
  <link href="http://www.43places.com/people/tag_cloud/erik" rel="alternate" type="text/html"/>
  <tags>
<tag count="7184">travel</tag>
<tag count="4350">restaurant</tag>
<tag count="2690">food</tag>
<tag count="2550">history</tag>

<tag count="1692">bar</tag>
<tag count="1660">architecture</tag>
<tag count="1490">culture</tag>
<tag count="1260">beach</tag>
<tag count="1204">music</tag>
<tag count="1164">art</tag>
<tag count="810">mountains</tag>
</feed>

Demo: /service/get_persons_tag_cloud?id=erik