 | | |
|
| Explanation of the all-users XML data feed | |
This is what a single userid item looks like:
<userid>
<id>0verthemoon</id>
<displayname>0verthemoon (USA: CA)</displayname>
<active>1</active>
<bio>I live in California</bio>
<photo>http://bookmooch.com/photo/johnbuckman</photo>
<homepage>http://john.redmood.com</homepage>
<statusmsg>I'm away until mid-July, and will send all mooched books then.</statusmsg>
<country>US</country>
<feedback_score>3</feedback_score>
<lastnow>1169751223</lastnow>
<librarything_user>checked</librarything_user>
<now>1165372956</now>
<points>22</points>
<sequence>3</sequence>
<is_charity>0</is_charity>
<fbuid>buckman.john</fbuid>
<disabled>0</disabled>
<willsend>askme</willsend>
<zip>94025</zip>
<asins_listed>
<asins_listed_item>
<id>0451459156</id>
<now>1165373287</now>
<condition>inscription on inside cover, like new other than that...</condition>
<reserved>
<expires>1295724356</expires>
<who>
<item>buckman_ca</item>
</who>
</reserved>
</asins_listed_item>
</asins_listed>
<feedback>
<feedback_item>
<id>ttandjj/8</id>
<now>1167872487</now>
<feedback_score>1</feedback_score>
<asin>0345442636</asin>
<transactionid>ttandjj/8</transactionid>
<feedback_comment>Great condition, evenything was perfect. Thanks again.</feedback_comment>
<userid_from>ttandjj</userid_from>
<giver_comment>Please read description next time. I describe books online for a living and have never had a problem</giver_comment>
<giver_comment_now>1161181035</giver_comment_now>
</feedback_item>
</feedback>
<history_given>
<history_given_item>
<id>peixao/4</id>
<receiver_country>US</receiver_country>
<receiver_comments></receiver_comments>
<points_to_giver>10</points_to_giver>
<points_from_receiver>10</points_from_receiver>
<asin>0609605453</asin>
<status>received</status>
<now>1167872702</now>
<closedate>1168654886</closedate>
<giver>0verthemoon</giver>
<receiver>peixao</receiver>
<date_sent>1168111003</date_sent>
<reminder_sent_date>1168112322</reminder_sent_date>
<reminder_received_date>1168114314</reminder_received_date>
<meeting>london-moochers</meeting>
<condition>cover is a bit worn</condition>
</history_given_item>
</history_given>
<history_received>
<history_received_item>
<id>0verthemoon/1</id>
<receiver_country>US</receiver_country>
<receiver_comments>thanks!</receiver_comments>
<points_to_giver>10</points_to_giver>
<points_from_receiver>10</points_from_receiver>
<condition>The spine is a bit creased but otherwise is in good used book condition.</condition>
<asin>006088231X</asin>
<closedate>1166232418</closedate>
<status>received</status>
<now>1165616533</now>
<giver>kd5fto</giver>
<receiver>0verthemoon</receiver>
<date_sent>1165849974</date_sent>
<reminder_sent_date>1168112322</reminder_sent_date>
<reminder_received_date>1168114314</reminder_received_date>
<meeting>london-moochers</meeting>
<condition>cover is a bit worn</condition>
</history_received_item>
</history_received>
<friends>
<friend>
<id>ecolibris</id>
<status>a</status>
<date_invited>1285686763</date_invited>
<date_accepted>1285686816</date_accepted>
<comment>Eylon (of Eco-Libris) and I share a common love for Scottish Science Fiction</comment>
</friend>
</friends>
<wishlist>
<wishlist_item>
<id>0765309300</id>
<now>1169743168</now>
<related_off>1</related_off>
<related_off_specific>0740700030 0836228995</related_off_specific>
</wishlist_item>
</wishlist>
<pointslog>
<pointslog_item>
<description>added book to inventory</description>
<now>1169750867</now>
<oldpoints>12</oldpoints>
<points>1</points>
<active_user>0verthemoon</active_user>
<transaction></transaction>
<asin>1596060638</asin>
<newpoints>13</newpoints>
</pointslog_item>
</pointslog>
<pending_give>
<item>theveryidea/111</item>
</pending_give>
<pending_receive>
<item>0verthemoon/3</item>
</pending_receive>
<searchlog>
<item>jim butcher</item>
<item>charles stross</item>
</searchlog>
<smooches_received>6</smooches_received>
<smooches_given>3</smooches_given>
<smooch_received_log>
<smooch_received_log_item>
<now>1189944055</now>
<anon>n</anon>
<amount>10</amount>
<donor>mjones8727</donor>
<comment>I love you! Thanks for fixing</comment>
<recipient>johnbuckman</recipient>
</smooch_received_log_item>
</smooch_received_log>
<charity_received_log>
<charity_received_log_item>
<now>1195756582</now>
<amount>20</amount>
<charity>johnbuckman</charity>
<donor>martinskidmore</donor>
<comment>Sorry about the smoke-smell - I'm kind of surprised since there is virtually never smoking in either library, but since this is a smoking household and you could tell that, clearly it's there. I've updated my profile.</comment>
</charity_received_log_item>
</charity_received_log>
<charity_given_log>
<charity_given_log_item>
<now>1261647154</now>
<amount>50</amount>
<charity>supersteve</charity>
<donor>johnbuckman</donor>
<comment>Thanks for being a great moocher and for your EFF donation!</comment>
</charity_given_log_item>
</charity_given_log>
<forum_threadids>
<item>discussion 1</item>
</forum_threadids>
<forum_comments>
<item>forum_design 9 1</item>
</forum_comments>
<forums_admin>
<item>forum_design</item>
</forums_admin>
<forums_created>
<item>forum_design</item>
</forums_created>
<forums_joined>
<item>recommended</item>
</forums_joined>
<forums_receive_emails>
<item>recommended</item>
</forums_receive_emails>
<forum_date_ago>1286639119</forum_date_ago>
<recommended>
<item>0316024961</item>
<item>1400049628</item>
</recommended>
</userid>
Here is a version of the same record, but with an explanation in place of the field data:
<userid>
<id>user id of the BookMooch user</id>
<displayname>Display name of this user</displayname>
<active>whether or not this user is active. 1=active, 0=not active (ie, inactive account)</active>
<bio>the user's bio, if there is one</bio>
<photo>a URL to the user's photo, if there is one. It
will be of the form http://bookmooch.com/photo/userid and will
have been resized to be a
consistent width. If you want the original photo, add "large"
to the url, like so:
http://bookmooch.com/photo/large/userid</photo>
<homepage>a URL to the user's home page, if there is one</homepage>
<statusmsg>the optional informational status message
this user has entered in their preferences
page.</statusmsg>
<country>the country the user resides in</country>
<feedback_score>cahed total sum of their feedback. This is updated automatically any time this user's
feedback is added or changed, and should equal a calculated sum of the user's feedback
received.</feedback_score>
<lastnow>time stamp of their last log in. Multiple logins within a 1h period are not updated
(ie, this is accurate to within 1 hour)</lastnow>
<librarything_user>Whether this user has enabled the LibraryThing integration. Blank=no, any
value=yes</librarything_user>
<now>time stamp for when this user account was first created</now>
<points>total number of points this user has, in x10 notation (ie, 20 = 2 points)</points>
<sequence>the ID for this user's next mooch (ie, the next mooch would be given an ID of "username/sequence"</sequence>
<is_charity>whether this user represents a registered (and certified) charity at BookMooch</is_charity>
<fbuid>If this user has the BM facebook app installed, this is their Facebook user id</fbuid>
<disabled>if set to 1, this user's account is currently being reviewed by an admin and this user is currently unable to mooch</disabled>
<willsend>Where in the world this user has indicated they will send books to. askme=domestic yes,
international by request, mycountry=only their country, anywhere=worldwide</willsend>
<zip>the person's postal code</zip>
<asins_listed>
<asins_listed_item>
<id>ASIN of the book this person is offering to give away (ie, it is in their
inventory) </id>
<now>time-stamp when this book was added to their inventory</now>
<condition>condition notes for this person's copy of this book</condition>
<reserved>
<expires>if this book is reserved, this is the
date stamp of when this reservation expires. After the
expiration, this reserved data is not deleted until
the book is mooched, so if you see a reserved entry
for a book, be sure to check the date stamp to see if
it is still in effect. </expires>
<who>
<item>the userid of the person this book is
reserved for, and a book can be reserved for any
of multiple people. If the reservation is for a
userid of "friends" then this reservation
automatically applies to all the listed friends of
the user giving this book.</item>
</who>
</reserved>
</asins_listed_item>
</asins_listed>
<feedback>
<feedback_item>
<id>ID of this feedback item. Usually the same as the transactionid</id>
<now>time-stamp when this feedback item was first created</now>
<feedback_score>score given to this feedback item, may be 1, 0 or -1</feedback_score>
<asin>the ASIN of the book this feedback refers to</asin>
<transactionid>transaction ID this feedback item refers to. May refer to an active
transaction in the pending table, or a historical transaction in a user's
history_given</transactionid>
<feedback_comment>textual comment.</feedback_comment>
<userid_from>the userid of the author of this feedback item</userid_from>
<giver_comment>Optional textual comment left by the book giver (ie, usually a
rebuttal to negative feedback)</giver_comment>
<giver_comment_now>time-stamp for when the book giver comment was left</giver_comment_now>
</feedback_item>
</feedback>
<history_given>
<history_given_item>
<id>Transaction ID of this completed book swap (mooch) transaction, for books this userid
has given away</id>
<receiver_country>the country the book receiver resides in</receiver_country>
<receiver_comments>any comment the book receiver leaves</receiver_comments>
<points_to_giver>the number of points (x10 format) that were awarded to the book
giver for sending this book</points_to_giver>
<points_from_receiver>the number of points (x10 format) that were taken away from
the book moocher to receive this book</points_from_receiver>
<asin>the ASIN of the book that this transaction refers to</asin>
<status>the final status of this completed transaction. See pending
for an explanation of the various status codes.</status>
<now>the time stamp for when this transaction was first created</now>
<closedate>the time stamp for when this transaction was closed (ie, it was
moved from the pending table to the user's history)</closedate>
<giver>the user id of the person giving this book away</giver>
<receiver>the user id of the person receiving this book</receiver>
<date_sent>time-stamp of when this book was sent</date_sent>
<reminder_sent_date>the date when a
reminder was sent via email by the moocher,
asking the person to send the book (it hadn't
yet been marked as
sent)</reminder_sent_date>
<reminder_received_date>the date when a
reminder was sent via email by the book giver,
asking the person if they received the book
yet (they hadn't yet been marked it as
received, though it had been
sent)</reminder_received_date>
<meeting>if this book was exchanged at a
meeting, the name of that
meeting</meeting>
<condition>any condition notes that were
listed with the book when it was originally
mooched</condition>
</history_given_item>
</history_given>
<history_received>
<history_received_item>
<id>Transaction ID of this completed book swap (mooch) transaction, for books this userid
has received</id>
<receiver_country>the country the book receiver resides in</receiver_country>
<receiver_comments>any comment the book receiver leaves</receiver_comments>
<points_to_giver>the number of points (x10 format) that were awarded to the book
giver for sending this book</points_to_giver>
<points_from_receiver>the number of points (x10 format) that were taken away from
the book moocher to receive this book</points_from_receiver>
<asin>the ASIN of the book that this transaction refers to</asin>
<status>the final status of this completed transaction. See pending
for an explanation of the various status codes.</status>
<now>the time stamp for when this transaction was first created</now>
<closedate>the time stamp for when this transaction was closed (ie, it was moved from
the pending table to the user's history)</closedate>
<giver>the user id of the person giving this book away</giver>
<receiver>the user id of the person receiving this book</receiver>
<date_sent>time-stamp of when this book was sent</date_sent>
<reminder_sent_date>the date when a reminder was sent via email by the moocher,
asking the person to send the book (it hadn't yet been marked as sent)</reminder_sent_date>
<reminder_received_date>the date when a reminder was sent via email by the book giver,
asking the person if they received the book yet (they hadn't yet been marked it as
received, though it had been sent)</reminder_received_date>
<meeting>if this book was exchanged at a meeting, the name of that meeting</meeting>
<condition>any condition notes that were listed with the book when it was originally
mooched</condition>
</history_received_item>
</history_received>
<friends>
<friend>
<id>userid of the friend</id>
<status>the status of the friend request. a=active (ie, the user has confirmed
the friendship). u=unconfirmed (user has not confirmed the friendship and the friendship
relationship should probably be considered not to yet exist)</status>
<date_invited>the date when the friend invitation was sent (in seconds-since-1970
format)</date_invited>
<date_accepted>the date when the friend invitation was accepted (in seconds-since-1970
format)</date_accepted>
<comment>an optional comment the user put in after receiving the friend request,
which describes their relationship</comment>
</friend>
</friends>
<wishlist>
<wishlist_item>
<id>The ASIN of a book on this person's wishlist</id>
<now>time-stamp when this book was added to this person's wishlist</now>
<related_off>if set to 1, then BM will not show in their wishlist, books that are
related editions to this one</related_off>
<related_off_specific>a space-separated list of ASINs. If set, then BM will not show
these specific related editions in their wishlist. Frequently used to hide foreign
language editions. </related_off_specific>
</wishlist_item>
</wishlist>
<pointslog>
<pointslog_item>
<description>a descrption of this point change event. Any event that causes a point
change for a member is logged here. This log serves only for auditing points, it is
not used in calculating points.</description>
<now>time-stamp of when this point change event took place</now>
<oldpoints>the number of points (in x10 format) before this point change even
took place</oldpoints>
<points>the number of points being added or subtracted from oldpoints (in x10 format).
Can be a negative number</points>
<active_user>the userid of the person currently logged in causing this point
change event</active_user>
<transaction>if this point change was caused by a mooch, this is the transaction
ID of that mooch transaction</transaction>
<asin>if this point change was caused by a mooch, this is the ASIN of the book
referred to in the mooch transaction</asin>
<newpoints>the number of points the user now has (ie oldpoints + points = newpoints)
</newpoints>
</pointslog_item>
</pointslog>
<pending_give>
<item>transaction ID of any mooch transaction by this person, giving books away</item>
</pending_give>
<pending_receive>
<item>transaction ID of any mooch transaction by this person, receiving books</item>
</pending_receive>
<searchlog>
<item>text of any full text searches this user has made for books (via "browse" or the full
search feature on the top right of the BookMooch web pages)</item>
</searchlog>
<smooches_received>the number of smooches this member has received</smooches_received>
<smooches_given>the number of smooches this member has given</smooches_given>
<smooch_received_log>
<smooch_received_log_item>
<now>the date the smooch was received</now>
<anon>whether this smoooch was given anonymously. If
set to 'y' then the donor and comment field are not in the
XML export for this item.</anon>
<amount>the number of points that were smooched (in x10 format)</amount>
<donor>the userid of the person giving the smooch</donor>
<comment>the comment that went along with the smooch, if any</comment>
<recipient>the recipient of the smooch, which should
always be the current userid for this xml
record</recipient>
</smooch_received_log_item>
</smooch_received_log>
<charity_received_log>
<charity_received_log_item>
<now>the date the charitable gift was received</now>
<amount>the number of points that were received (in x10 format)</amount>
<charity>the userid of the receiving charity (should be the current user)</charity>
<donor>the userid of the donating user</donor>
<comment>an optional comment associated with the donation, made by the donor</comment>
</charity_received_log_item>
</charity_received_log>
<charity_given_log>
<charity_given_log_item>
<now>the date the charitable gift was given</now>
<amount>the number of points that were given (in x10 format)</amount>
<charity>the userid of the receiving user (i.e. the "charity")</charity>
<donor>the userid of the donating user (should be the current user)</donor>
<comment>an optional comment associated with the donation, made by the donor</comment>
</charity_given_log_item>
</charity_given_log>
<forum_threadids>
<item>The thread id for any forum messages this
user has written. Note that the entire field is the
id, but it is composed of
"forumname(space)threadnumber"</item>
</forum_threadids>
<forum_comments>
<item>The thread id for any forum comments this
user has written. Note that the entire field is the
id, but it is composed of
"forumname(space)threadnumber(space)commentnumber"</item>
</forum_comments>
<forums_admin>
<item>The name of any forums this person administers</item>
</forums_admin>
<forums_created>
<item>The name of any forums this person has created</item>
</forums_created>
<forums_joined>
<item>The name of any forums this person has joined (ie, they are in "my forums")</item>
</forums_joined>
<forums_receive_emails>
<item>The name of any forums this person receives email from</item>
</forums_receive_emails>
<forum_date_ago>If they have ever visited the forums,
this is the date they last visited.</forum_date_ago>
<recommended>
<item>the ASIN of a book recommended to this person. If the user
has chosen to hide any recommended books (for example, if they already
read them in the past) then those ASINs are hidden in this field as
well. The algorithm for making recommendations looks at all the books
this user has mooched, and compares this with all the books mooched by
people who have also mooched the same books. The
most-likely-to-be-mooched books based on this grouping is what this
recommendation displays. However, books that are not moochable are not
recommended. The recommendations are cached, and only updated when the
user goes to look at their recommendations.</item>
</recommended>
</userid>
| | | |
