SpeakerRate

Featured Talk: Advanced jQuery B… by Yehuda Katz (wycats)

Most Recent Talk: The Young and the Digital by Craig Watkins

Next Talk: Content Strategy:… by Margot Bloomstein

SpeakerRate API

The SpeakerRate API is available for non-commercial use by outside developers. If you wish to make use of the API for commercial purposes, contact us.

Request Format

The API accepts requests via simple HTTP GET actions. Currently, there is no authentication necessary for accessing any of the API methods.

The request URL is any speaker, talk, event, or series page's URL, with an .xml extension (for an XML response) or .json (for a JSON response) following the ID number. e.g.:

http://speakerrate.com/talks/17-how-macgyver-would-do-design-research

Becomes:

http://speakerrate.com/talks/17.xml

Response Format

The API currently provides XML and JSON response formats.

The XML response consists of a simple XML prolog and then a dump of the data.

The JSON response contains raw data in JSON format.

If the requested data cannot be found, an HTTP 404 error will be returned.

Response Schemata

Below is a list of fields returned by the API, organized by object type.

Speakers

Example request:

http://speakerrate.com/speakers/2.xml

Response definitions:

```
speaker
```
Parent element. Contains all data.
```
avatar_url
```
Relative URL of the speaker's avatar.
```
biography
```
Contains the speaker's biographical information, which may include markdown.
```
company
```
The speaker's listed company, in plain text.
```
company-website
```
The URL to the company's website.
```
id
```
The speaker's ID in the SpeakerRate system. This is an integer.
```
linkedin-url
```
The URL to the speaker's LinkedIn profile.
```
location
```
An unstructured location entered by the speaker, in plain text.
```
name
```
The speaker's full name as displayed.
```
personal-website
```
The URL to the speaker's website.
```
talks
```
An array of talk objects associated with this speaker.
- ```
talk
```
  The element containing information about an individual talk. See the talks object documentation

Talks

Example request:

http://speakerrate.com/talks/17.xml

Response definitions:

```
talk
```
Parent element. Contains all data.
- ```
created-at
```
  The datetime when the object was created. This is presented in ISO 8601 format.
- ```
event-id
```
  The ID of any event associated with this talk, as an integer.
- ```
id
```
  The talk's ID in the SpeakerRate system. This is an integer.
- ```
info
```
  This is the description of the talk, in plain text. It may include markdown.
- ```
location
```
  If there is a location associated with this event, it is output here, in plain text and unstructured.
- ```
series-id
```
  The ID of any series associated with this talk.
- ```
slides-url
```
  The URL of this talk's slides.
- ```
talk-url
```
  The authoritative non-SpeakerRate URL to reference this talk.
- ```
title
```
  This talk's title.
- ```
updated-at
```
  The datetime this talk was last updated. This is presented in ISO 8601 format.
- ```
when
```
  The datetime of the talk itself. This is presented in ISO 8601 format.
- ```
average-rating
```
  This is a decimal representing the average of its ratings.
- ```
event
```
  This is the parent element for information about any associated event. See the events object documentation

Events

Example request:

http://speakerrate.com/events/6.xml

Response definitions:

```
event
```
Parent element. Contains all data.
- ```
created-at
```
  The datetime when the object was created. This is presented in ISO 8601 format.
- ```
description
```
  A description of the event in plain text. It may include some markdown.
- ```
end-date
```
  The datetime this event will end. This is presented in ISO 8601 format.
- ```
event-url
```
  The authoritative non-SpeakerRate URL of this event.
- ```
id
```
  The event's ID in the SpeakerRate system. This is an integer.
- ```
location
```
  If there is a location associated with this event, it will be displayed here, in unstructured plain text.
- ```
series-id
```
  The SpeakerRate ID of any series associated with this event.
- ```
start-date
```
  The datetime this event will start. This is presented in ISO 8601 format.
- ```
title
```
  The name of this event, in plain text.
- ```
updated-at
```
  The datetime this event was last updated. This is presented in ISO 8601 format.
- ```
average-rating
```
  The average rating of all talks that make up this event.
- ```
series
```
  This is the parent element for information about any associated series. See the series object documentation
- ```
talks
```
  This is the parent element of an array of talk elements that contain information about any associated talks. See the talks object documentation

Series

Example request:

http://speakerrate.com/series/6.xml

Response definitions:

```
series
```
Parent element. Contains all data.
- ```
created-at
```
  The datetime when the object was created. This is presented in ISO 8601 format.
- ```
description
```
  A description of the series in plain text. It may include some markdown.
- ```
id
```
  The series' ID in the SpeakerRate system. This is an integer.
- ```
title
```
  The name of this series, in plain text.
- ```
updated-at
```
  The datetime this series was last updated. This is presented in ISO 8601 format.
- ```
url
```
  The authoritative non-SpeakerRate URL of this series.
- ```
average-rating
```
  The average rating of all talks that make up this series.
- ```
events
```
  This is the parent element of an array of event elements that contain information about any associated eventss. See the events object documentation
- ```
talks
```
  This is the parent element of an array of talk elements that contain information about any associated talks. See the talks object documentation