Archive for the ‘event’ Category

Tuesday, November 28th, 2023

LibraryThing’s 10th Annual Holiday Card Exchange

The 10th annual LibraryThing Holiday Card Exchange is here!

Here’s how it works:

  • Mail a holiday card to a random LibraryThing member. You can send up to 10 cards!
  • Choose a handmade or store bought card. Add a special note to personalize it.
  • You’ll get the same number of cards in return from other fellow LibraryThing members.
  • In order for cards to be delivered correctly to you, you must include your real name in the address box when signing up: use whatever matches your mailbox. (Only your matches and LibraryThing staff can see your address.)

» Sign up for the LibrayThing Holiday Card Exchange now

Sign-ups for the Card Exchange close Tuesday, December 5 at 12:00pm Eastern (17:00 GMT). We’ll inform you of your matches within an hour or so after we close. Send your cards out soon after.

Questions? Join the discussion on Talk.

Labels: card exchange, event, holiday

Monday, November 28th, 2022

9th Annual LibraryThing Holiday Card Exchange

The 9th annual LibraryThing Holiday Card Exchange is here!

How it works:

  • Mail a holiday card to a random LibraryThing member.
  • You can mail a handmade or storebought card. Add a note to personalize it.
  • You’ll get one from another member. (Only that member will see your address.*)

» Sign up for the LibrayThing Holiday Card Exchange now

Sign-ups for the Card Exchange closes Wednesday, December 7th at 12:00 PM Eastern (17:00 GMT). We’ll inform you of your matches within an hour or so after we close. Send your cards out soon after.

Questions? Join the discussion on Talk.


* In order for the cards you receive to be addressed to your real name, you must include your name in the address box. Some postal services require that addressee names match what’s on your mailbox.

Labels: card exchange, event, holiday

Tuesday, November 20th, 2012

New: Add Events API

The Add Events API adds events to the LibraryThing Local events system using a simple “RESTful” API.

You can also find this on WikiThing: Add Events API

Come Talk about the API here.

The Request

Each Add Events request consists of a single http request, with all parameters specified in the URL. There is no ganging of requests.

There is no separate API to update events. If the system finds an event for the same venue at the same time and added by you, it replaces it with the new one.

Here is a sample request with the parameters broken out onto separate lines.

http://www.librarything.com/api_eventadd.php?
title=Spring+Author+Series
&description=A+reading+from+Every+Visible+Thing+by+Lisa+Carey.
&isbns=0060937424,0380815591
&time=2012-12-1+11:00
&venue=2427
&userid=timspalding
&developerkey=[omitted]
&addevent=1

You can try out this request [http://www.librarything.com/api/eventadd.php?title=Spring+Author+Series&description=A+reading+from+Every+Visible+Thing+by+Lisa+Carey.&isbns=0060937424,0380815591&time=2012-12-1+11:00&venue=2427&userid=timspalding&developerkey=%5Bomitted%5D&addevent=1 by hitting this URL]. Don’t worry, it won’t add a new event.

Basic parameters

title. The title of the event.

time. The date and time of the event, preferably in the format YYYY-MM-DD HH:MM (eg., 2012-12-01 14:00).

Ideally the HH:MM should be in 24-hour (or “military”) format, although you can also append “AM” or “PM.” All times should be local time; not include timezone data, or it will throw off the time calculation as it attempts to square it with LibraryThing’s timezone.

description. The description of the event. Works and authors should NOT be touchstones in the description.

isbns (optional). A comma-separated list of ISBNs relevant to the entry. LibraryThing uses these to retrieve all potential work titles and author names implicated in the description, and creates touchstones as appropriate.

ISBNs are not only for works, but also for authors. For example, if an author is delivering a talk but not reading from any specific work, referencing one of their ISBNs will still ensure that their name in the description gets turned into a touchstone.

eventurl (optional). URL of the event at the venue’s website.

mediaurl (optional). Archived media of the event (for past events only).

Basic parameters

There are two ways of finding the venue. You must use one or the other.

venue. If you know the LibraryThing venue id, use the venue= parameter.

The LibraryThing venue id is located in venue URLs. For example, [http://www.librarything.com/venue/924/Strand-Bookstore http://www.librarything.com/venue/924/Strand-Bookstore] has the venue id 924.

venuesearchtype, venuesearchdata and venuesearchexact. Using these two parameters you instruct LibraryThing to search for a venue. If exactly one venue is found, it will go ahead and choose it, and add the event. At present there are four venuesearchtype options.

*phone. Searches the venue’s phone number. All non-numbers are ignored (ie., 207-555-1212 is the same as 207.555.1212, etc.).

*twitter. Searches the venue’s Twitter handle, if they have one.

*email. Searches for the email.

*name. Searches the venue name.

venuesearchdata is the search string.

venuesearchexact is whether to do a match on partial searches (ie., “Strand” matching “Strand Bookstore,” “Strand Book Annex,” “The Strand Bookshop,” etc.).

Your information

userid. Your LibraryThing userid (ie., timspalding).

developerkey. Developer key. This can be found at http://www.librarything.com/services/keys.php . If you are not a registered developer, you can sign up and get your developer key in less than a minute.

Making it happen

addevent. To make it add the event, rather than just test the system and see an XML response, set addevent=1. Constructing http requests without addevent is a good way to test out the system.

The Response

Requests to the Add Events API return an XML response, recapitulating the event, reporting on errors or warning and listing the status of “added,” “replaced” or “not added.” The <touchstones> are lets you see whether your ISBNs were successfully turned into touchstones.

<response>
	<status>
		<action>replaced</action>
		<eventid>305621</eventid>
	</status>
	<event>
		<title>Spring Author Series</title>
		<venue>LibraryThing H.Q.</venue>
		<date>2012-12-01 11:00 AM</date>
		<description>
			A reading from [Every Visible Thing] by [[Lisa Carey]].
		</description>
		<touchstones>
			<touchstone>
				<text>[Every Visible Thing]</text>
				<author>careylisa</author>
					<work>3702986</work>
			</touchstone>
			<touchstone>
				<text>[[Lisa Carey]]</text>
				<author>careylisa</author>
			</touchstone>
		</touchstones>
	</event>
</response>

Labels: apis, bookstores, event

Thursday, September 2nd, 2010

Hunger Games box set winner!

Chosen randomly from over 200 comments on the blog post, the winner of the Hunger Games box set is blueAframe! Thanks to everyone who posted a comment.

Although some of the comments were not visible on the blog post, I assure you I had access to all of them on the admin side, and randomly chose from the entire set of contestants who submitted their comment before the deadline. I keep everyone’s interest in mind, as opposed to President Snow.

Labels: event

Thursday, August 26th, 2010

Read a National Book Festival author’s book; ask them a question

The 75 Books Challenge for 2010 group has a “Take It or Leave It” challenge for August, where they read a book by one of the authors who will be attending the 10th annual National Book Festival.

You don’t have to be part of the 75 Books Challenge group to decide to read a NBF author’s book. Even if you can’t go to the festival itself (in Washington, D.C. on September 25), you may be inspired to read a book by one of the participating authors. Maybe this is your chance to finally pick up Everything Is Illuminated, Outlander or Read to Your Bunny. You can join the 75 Book Challenge folks on their thread, or keep your reading choice to yourself.

I can’t go to the festival this year, but I’ve arranged to ask many of the authors in attendance ONE interview question each. If you’d like to be the one to ask any of these authors a question, post it here before September 1st.

See the entire list of authors.

Labels: event, library of congress, reading