Get Glue: API

Glue API

The Glue API allows you to create your own applications that utilize the Objects, People, and Interactions on Glue in new and exciting ways! Got questions? Head on over to our Developer Forum

Terms of Service

By using the Glue API, you agree to abide by these terms of service.

You agree to limit the number of queries per day to 5000.
You agree to use the API in compliance with AdaptiveBlue's Privacy Policy.
You agree to abide by the terms of service of the other APIs used by the Glue API.
You agree not to copy/store/replicate/cache the API responses for more than 24 hours.
You agree not to replace AdaptiveBlue affiliate ids in the links within API responses.
You agree that AdaptiveBlue reserves the right to change the API at any time.
You agree that AdaptiveBlue may disable access to the API at any time and for any reason.
You agree that the API is provided to you "AS IS" and without any warranty or condition, implied or statutory.
You agree that AdaptiveBlue is not liable for any damages resulting from the use of the API.

Please use the API in accordance with the documentation below.

Authentication

All API calls (besides /user/login) require an authenticaiton token. A token can be requested by calling /user/login, it should then be passed along with every other request as token={token}. Calls that act on behalf of a user, such as /user/follow, use the token user as the source. Tokens do not expire.

API Paths

All API methods are accessible under http://api.getglue.com/v2. For example, /user/profile would be accessible at http://api.getglue.com/v2/user/profile

Response Format

The full XML response format is as follows:

<adaptiveblue>
    <request>
        <method>/user/profile</method>
        <params>
            <paramName1>paramValue1</paramName1>
            <paramName2>paramValue2</paramName2>
            ...
        </params>
    </request>
    <response>
        (Response XML)
        <timestamp>yyyy-mm-ddThh:mm:ssZ</timestamp>
    </response>
</adaptiveblue>

All responses in the following documentation are substituted for (Response XML). Timestamps are returned in UTC and are ISO 8601 formatted.

In the case of an expected error, <response> is replaced by:

<error>
    <code>###</code>
    <name>ShortName</name>
    <message>Human readable message</message>
</error>

For example:

<error>
    <code>101</code>
    <name>MissingParameter</name>
    <message>userId is missing</message>
</error>

Additionally, the applicable HTTP status code will be sent with each error document. In the case of an unexpected internal error, an HTTP 500 status code will be sent with a blank document. For a complete list of expected errors and return codes, please see the error documentation.

Paging

All methods that return interactions can be paged through.

To enable paging, pass page=1 and numItems={pageSize} with your first request. Along with the rest of your response you will also recieve paging information that can be used in subsequent requests:

<pagingInfo>
    <nextToken>2009-10-16T02:46:37Z</nextToken>
    <total>175</total>
    <numItems>20</numItems>
    <page>2</page>
</pagingInfo>

To request the next page, pass page=2 and numItems={pageSize} and nextToken={nextToken from pagingInfo}. Continue this way until numItems * page is >= total which indicates you have reached the last page. Requesting further pages will return an empty set of interactions.

User Methods

/user/login

Parameters:

userId - Glue username
password - Glue password
version - Glue version (currently 4.5)

Response:

Request an authentication token, used in other API calls

<ping>
    <userId>glueman</userId>
    <serverTime>1257207570817</serverTime>
    −
    <token>glue token</token>
</ping>

Example: http://api.getglue.com/v2/user/login?userId=glueman&password=myPass

/user/profile

Parameters:

userId - Glue username

Response:

The user's profile (display name, interaction counts, description, stats, stickers, services [other networks, blogs]). All values will be returned, even if empty or 0, with the exception of service ids which will only be returned if set.

<profile>
    <private>false</private>
    <hideVisits>false</hideVisits>
    <displayName>Glue Man</displayName>
    <description>A man made of glue</description>
    <friends>89</friends>
    <followers>90</followers>
    <stats>
            <visitedProfiles>44</visitedProfiles>
            <nonFriendProfiles>44</nonFriendProfiles>
            <visited>29</visited>
            <liked>10</liked>
            <commented>1</commented>
            <disliked>3</disliked>
            <guru>5</guru>
    </stats>
    <favorites>
            <books>1</books>
            <electronics>0</electronics>
            <movie_stars>2</movie_stars>
            <movies>5</movies>
            <music>3</music>
            <recording_artists>0</recording_artists>
            <restaurants>0</restaurants>
            <tv_shows>0</tv_shows>
            <topics>0</topics>
            <video_games>0</video_games>
            <wines>0</wines>
    </favorites>
    <postToTwitter>false</postToTwitter>
    <postToFacebook>true</postToFacebook>
    <username>glueman</username>
    <stickers>
            <sticker>
                    <name>Bootcamp</name>
            </sticker>
            <sticker>
                    <name>Curious George</name>
                    <level>10</level>
                    <count>44</count>
            </sticker>
    </stickers>
    <unlockedStream>true</unlockedStream>
</profile>

Example: http://api.getglue.com/v2/user/profile?userId=mtab&token=token

/user/friends

Parameters:

userId - Glue username

Response:

The user's friends. Note that usernames are case sensitive.

<friends>
    <userId>Joe</userId>
    <userId>Jack</userId>
    <userId>jill</userId>
    <userId>Mike</userId>
    <userId>tom</userId>
    <userId>Bob</userId>
    ...
</friends>

Example: http://api.getglue.com/v2/user/friends?userId=mtab&token=token

/user/followers

Parameters:

userId - Glue username

Response:

The user's followers. Note that usernames are case sensitive.

<followers>
    <userId>Joe</userId>
    <userId>Jack</userId>
    <userId>jill</userId>
    <userId>Mike</userId>
    <userId>tom</userId>
    <userId>Bob</userId>
    ...
</followers>

Example: http://api.getglue.com/v2/user/followers?userId=mtab&token=token

/user/isFriend

Parameters:

userId - Glue username friendUserId - Glue username

Response:

true if userId is friends with friendUserId, otherwise false. If the user is protected and friend request is still pending, "pending" will be returned.

Example: http://api.getglue.com/v2/user/isFriend?userId=mtab&friendUserId=netpro2k&token=token

/user/follow

This method will be performed as the authenticated user.

Parameters:

followUserId - Glue username of the person to follow

Response:

On success:

<success/>

If awaiting protected user's approval:

<pending/>

Example: http://api.getglue.com/v2/user/follow?followUserId=mtab&token=token

/user/unfollow

This method will be performed as the authenticated user.

Parameters:

unfollowUserId - Glue username of the person to unfollow

Response:

<success/>

Example: http://api.getglue.com/v2/user/unfollow?unfollowUserId=mtab&token=token

/user/addVisit

This method will be performed as the authenticated user.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
source - the source of the interaction, must be a URL (can be the homepage of your application)
app - the name of your application

Response:

The interaction (without userId) that has been created/modified.

<interaction>
    <title>Home Alone</title>
    <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
    <action>Looked</action>
    <objectKey>movies/home_alone/chris_columbus</objectKey>
    <source>
        <name>imdb.com</name>
        <link>http://www.imdb.com/title/tt0099785</link>
    </source>
    <timestamp>2009-04-20T19:29:05Z</timestamp>
</interaction>

Examples:
http://api.getglue.com/v2/user/addVisit?objectId=http://www.amazon.com/dp/B001P9KR8U/&source=http://exampleglueapp.com/&app=ExampleApp&token=token
http://api.getglue.com/v2/user/addVisit?objectId=movies/slumdog_millionaire/danny_boyle&source=http://exampleglueapp.com/&app=ExampleApp&token=token

/user/addLike

This method will be performed as the authenticated user.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
source - the source of the interaction, must be a URL (can be the homepage of your application)
app - the name of your application

Response:

The interaction (without userId) that has been modified.

<interaction>
    <title>Home Alone</title>
    <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
    <action>Liked</action>
    <objectKey>movies/home_alone/chris_columbus</objectKey>
    <source>
        <name>imdb.com</name>
        <link>http://www.imdb.com/title/tt0099785</link>
    </source>
    <timestamp>2009-04-20T19:29:05Z</timestamp>
</interaction>

Examples:
http://api.getglue.com/v2/user/addLike?objectId=http://www.amazon.com/dp/B001P9KR8U/&source=http://exampleglueapp.com/&app=ExampleApp&token=token
http://api.getglue.com/v2/user/addLike?objectId=movies/slumdog_millionaire/danny_boyle&source=http://exampleglueapp.com/&app=ExampleApp&token=token

/user/addDislike

This method will be performed as the authenticated user.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
source - the source of the interaction, can be the URL of your application's homepage
app - the name of your application

Response:

The interaction (without userId) that has been modified.

<interaction>
    <title>Home Alone</title>
    <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
    <action>Disliked</action>
    <objectKey>movies/home_alone/chris_columbus</objectKey>
    <source>
        <name>imdb.com</name>
        <link>http://www.imdb.com/title/tt0099785</link>
    </source>
    <timestamp>2009-04-20T19:29:05Z</timestamp>
</interaction>

/user/askFriends

This method will be performed as the authenticated user.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
source - the source of the interaction, can be the URL of your application's homepage
app - the name of your application
comment - the twocents comment (Limit 140 characters)

Response:

The interaction (without userId) that has been modified.

<interaction>
    <title>Home Alone</title>
    <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
    <action>Commented</action>
    <comment>This movie was great!</comment>
    <objectKey>movies/home_alone/chris_columbus</objectKey>
    <source>
        <name>imdb.com</name>
        <link>http://www.imdb.com/title/tt0099785</link>
    </source>
    <timestamp>2009-04-20T19:29:05Z</timestamp>
</interaction>

Examples:
http://api.getglue.com/v2/user/add2Cents?objectId=http://www.amazon.com/dp/B001P9KR8U/&source=http://exampleglueapp.com/&app=ExampleApp&comment=This was a great movie!&token=token
http://api.getglue.com/v2/user/add2Cents?objectId=movies/slumdog_millionaire/danny_boyle&source=http://exampleglueapp.com/&app=ExampleApp&comment=This was a great movie!&token=token

/user/removeInteraction

This method will be performed as the authenticated user.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey

Response:

<success/>

/user/addReply

This method will be performed as the authenticated user.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
source - the source of the interaction, can be the URL of your application's homepage
app - the name of your application
replyTo - Glue username of the person you wish to reply to
reply - the reply (Limit 140 characters)

Response:

The interaction (without userId) that has been created.

<interaction>
    <title>Home Alone</title>
    <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
    <action>Reply</action>
    <comment>This movie was great!</comment>
    <objectKey>movies/home_alone/chris_columbus</objectKey>
    <source>
        <name>Joe</name>
        <type>userId</type>
        <link>http://getglue.com/users/Joe</link>
    </source>
    <timestamp>2009-04-20T19:29:05Z</timestamp>
</interaction>

Examples:
http://api.getglue.com/v2/user/addReply?objectId=http://www.amazon.com/dp/B001P9KR8U/&source=http://exampleglueapp.com/&app=ExampleApp&replyTo=mtab&reply=Yeah, it was really good!&token=token
http://api.getglue.com/v2/user/addReply?objectId=movies/slumdog_millionaire/danny_boyle&source=http://exampleglueapp.com/&app=ExampleApp&replyTo=mtab&reply=Yeah, it was really good!&token=token

/user/removeReply

This method will be performed as the authenticated user. Note that timestamps are required, due to the fact that multiple replies on the same object are allowed.

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
timestamp - the timestamp of the reply you wish to remove

Response:

<success/>

Examples:
http://api.getglue.com/v2/user/removeReply?objectId=http://www.amazon.com/dp/B001P9KR8U/&timestamp=2009-05-19T21:47:49Z&token=token
http://api.getglue.com/v2/user/removeReply?objectId=movies/slumdog_millionaire/danny_boyle&timestamp=2009-05-19T21:47:49Z&token=token

/user/objects

Parameters:

userId - Glue username
category - One of the categories supported by Glue or all. Defaults to all.

Response:

The most recent interactions (without userId) of a user within the given category. (See paging for details on how to request aditional items)

<interactions>
    <interaction>
        <title>Home Alone</title>
        <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
        <action>Looked</action>
        <objectKey>movies/home_alone/chris_columbus</objectKey>
        <source>http://www.imdb.com/title/tt0099785</source>
        <timestamp>2009-04-20T19:29:05Z</timestamp>
    </interaction>
    <interaction>
        <title>12 Angry Men</title>
        <image>http://cdn-1.nflximg.com/us/boxshots/large.jpg</image>
        <action>Reply</action>
        <comment>
            Yes. It rocked for me, not sure if it will be the same
            in translation. Cultural references and slang were big.
        </comment>
        <objectKey>movies/12_angry_men/sidney_lumet</objectKey>
        <source>http://getglue.com/users/alex</source>
        <timestamp>2009-03-22T03:40:28Z</timestamp>
    </interaction>
    ...
</interactions>

Example: http://api.getglue.com/v2/user/objects?userId=mtab&token=token

/user/object

Parameters:

userId - Glue username
objectId - either the URL of a recognized page or Glue objectKey

Response:

The interaction (without userId) for the specific userId/objectId combination.

<interaction>
    <title>Home Alone</title>
    <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
    <action>Looked</action>
    <objectKey>movies/home_alone/chris_columbus</objectKey>
    <source>http://www.imdb.com/title/tt0099785x</source>
    <timestamp>2009-04-20T19:29:05Z</timestamp>
</interaction>

Examples:
http://api.getglue.com/v2/user/object?userId=mtab&objectId=http://www.amazon.com/dp/B001P9KR8U/&token=token
http://api.getglue.com/v2/user/object?userId=mtab&objectId=movies/slumdog_millionaire/danny_boyle&token=token

/user/stream

This method will be performed as the authenticated user.

Parameters:

streamType -(optional, default is all) single letter stream type, one of the following: s (suggestions), f (friends), r (replies), p (popular)
category - One of the categories supported by Glue or all. Defaults to all.

Response:

The last 20 items from the users stream, filtered by streamType and category (See paging for details on how to request aditional items)

<interactions>
    <interaction>
        <title>Home Alone</title>
        <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
        <action>Looked</action>
        <objectKey>movies/home_alone/chris_columbus</objectKey>
        <source>http://www.imdb.com/title/tt0099785</source>
        <timestamp>2009-04-20T19:29:05Z</timestamp>
    </interaction>
    <interaction>
        <title>12 Angry Men</title>
        <image>http://cdn-1.nflximg.com/us/boxshots/large.jpg</image>
        <action>Reply</action>
        <comment>
            Yes. It rocked for me, not sure if it will be the same
            in translation. Cultural references and slang were big.
        </comment>
        <objectKey>movies/12_angry_men/sidney_lumet</objectKey>
        <source>http://getglue.com/users/alex</source>
        <timestamp>2009-03-22T03:40:28Z</timestamp>
    </interaction>
    ...
</interactions>

Example:
http://api.getglue.com/v2/user/stream?category=all&token=token (gets last 20 items in stream)
http://api.getglue.com/v2/user/stream?category=movies&streamType=s&token=token (gets last 20 movie suggestions)

/user/guru

Parameters:

userId - Glue username

Response:

The last 20 items that this user became the Guru of (See paging for details on how to request aditional items)

<interactions>
    <interaction>
        <title>Home Alone</title>
        <image>http://cdn-4.nflximg.com/us/boxshots/large.jpg</image>
        <action>Looked</action>
        <objectKey>movies/home_alone/chris_columbus</objectKey>
        <source>http://www.imdb.com/title/tt0099785</source>
        <timestamp>2009-04-20T19:29:05Z</timestamp>
    </interaction>
    <interaction>
        <title>12 Angry Men</title>
        <image>http://cdn-1.nflximg.com/us/boxshots/large.jpg</image>
        <action>Reply</action>
        <comment>
            Yes. It rocked for me, not sure if it will be the same
            in translation. Cultural references and slang were big.
        </comment>
        <objectKey>movies/12_angry_men/sidney_lumet</objectKey>
        <source>http://getglue.com/users/alex</source>
        <timestamp>2009-03-22T03:40:28Z</timestamp>
    </interaction>
    ...
</interactions>

Example: http://api.getglue.com/v2/user/guru?userId=mtab&token=token

/user/thingsInCommon

Parameters:

userId - Glue username otherUserId - Glue username

Response:

The things userId and otherUserId have in common

<objects count="7">
    <music count="3">
            <album>
                    <modelName>music</modelName>
                    <key>music/21st_century_breakdown/green_day</key>
                    <title>21st Century Breakdown</title>
            </album>
            <album>
                    <modelName>music</modelName>
                    <key>music/black_holes_revelations/muse</key>
                    <title>Black Holes and Revelations</title>
            </album>
            <album>
                    <modelName>music</modelName>
                    <key>music/day_age/the_killers</key>
                    <title>Day &amp; Age</title>
            </album>
    </music>
    <topics count="1">
            <topic>
                    <modelName>topics</modelName>
                    <key>topics/p/paris</key>
                    <title>Paris</title>
            </topic>
    </topics>
    <tv_shows count="2">
            <show>
                    <modelName>tv_shows</modelName>
                    <key>tv_shows/weeds</key>
                    <title>Weeds</title>
            </show>
            <show>
                    <modelName>tv_shows</modelName>
                    <key>tv_shows/futurama_benders_game</key>
                    <title>Futurama: Bender's Game</title>
            </show>
    </tv_shows>
    <books count="1">
            <book>
                    <modelName>books</modelName>
                    <key>books/easy_latin_crossword_puzzles/wallace</key>
                    <title>Easy Latin Crossword Puzzles</title>
            </book>
    </books>
</objects>

Example: http://api.getglue.com/v2/user/thingsInCommon?otherUserId=mtab&friendUserId=netpro2k&token=token

Object Methods

/object/get

Parameters:

objectId - either the URL of a recognized page or Glue objectKey

Response:

An object's full details.

<show>
    <itemName>show</itemName>
    <title>Weeds</title>
    <visited>38</visited>
    <liked>14</liked>
    <commented>2</commented>
    <link>http://www.netflix.com/Movie/Weeds_Season_4</link>
    <image>http://cdn-7.nflximg.com/us/boxshots/large.jpg</image>
    <url>http://www.netflix.com/Movie/Weeds_Season_4</url>
    <sdb>Netflix</sdb>
    <rank>20</rank>
    <rankChange>12</rankChange>
    <preview>http://www.youtube.com/v/tUZcdiflm_c</preview>
    <shortDescription>{short description}</shortDescription>
    <description>{full description}</description>
    <year>2008</year>
    <starring>
        <starring_item>Mary-Louise Parker</starring_item>
        <starring_item>Elizabeth Perkins</starring_item>
        <starring_item>Albert Brooks</starring_item>
    </starring>
    <similar>
        <similar_item>tv_shows/mad_men</similar_item>
        <similar_item>tv_shows/dead_like_me</similar_item>
        <similar_item>tv_shows/niptuck</similar_item>
    </similar>
    <type>tv_shows</type>
    <objectKey>tv_shows/weeds</objectKey>
</show>

Examples:
http://api.getglue.com/v2/object/get?objectId=http://www.amazon.com/dp/B001P9KR8U/&token=token
http://api.getglue.com/v2/object/get?objectId=movies/slumdog_millionaire/danny_boyle&token=token

/object/users

Parameters:

objectId - either the URL of a recognized page or Glue objectKey

Response:

Guru, friends, and other interactions (with userId) associated with the object

<totalActivity>
<guru>
    <interaction>
        <objectKey>tv_shows/weeds</objectKey>
        <link>http://www.netflix.com/Movie/Weeds_Season_3</link>
        <title>Weeds</title>
        <image>http://cdn-1.nflximg.com/us/boxshots/large.jpg</image>
        <userId>fk_test_0319</userId>
        <displayName>fk test qa cheez</displayName>
        <action>Comment</action>
        <comment>test test. weeeeeeeeds man. weeeeds.</comment>
        <source>glue://users/netpro2kdev/tv_shows</source>
        <timestamp>2009-03-19T08:21:23Z</timestamp>
    </interaction>
</guru>
<friendsActivity>
    <interaction>
        <objectKey>tv_shows/weeds</objectKey>
        <link>http://www.netflix.com/Movie/Weeds_Season_4</link>
        <title>Weeds</title>
        <image>http://cdn-7.nflximg.com/us/boxshots/large.jpg</image>
        <userId>alex_glue_test</userId>
        <displayName>Alex Iskoldfoo</displayName>
        <action>Liked</action>
        <source>http://getglue.com/netpro2kdev/tv_shows</source>
        <timestamp>2009-10-15T23:53:05Z</timestamp>
    </interaction>
    ...
</friendsActivity>
<otherActivity>
    <interaction>
        <objectKey>tv_shows/weeds</objectKey>
        <link>http://www.imdb.com/title/tt0439100/</link>
        <title>Weeds</title>
        <image>http://ecx.images-amazon.com/images.jpg</image>
        <userId>netpro2kdev</userId>
        <action>LikedComment</action>
        <comment>This show is really funny</comment>
        <source>http://getglue.com/tv_shows/weeds</source>
        <timestamp>2009-10-15T23:48:09Z</timestamp>
        <numReplies>1</numReplies>
    </interaction>
    ...
</otherActivity>
</totalActivity>

Examples:
http://api.getglue.com/v2/object/users?objectId=http://www.amazon.com/dp/B001P9KR8U/&token=token
http://api.getglue.com/v2/object/users?objectId=movies/slumdog_millionaire/danny_boyle&token=token

/object/links

Parameters:

objectId - either the URL of a recognized page or Glue objectKey

Response:

A list of links associated with the object.

<links>
    <link>http://movies.yahoo.com/movie/1809956055/info</link>
    <link>http://www.amazon.com/Slumdog-Millionaire/dp/B001UEBHYS</link>
    <link>http://www.blockbuster.com/catalog/movieDetails/370506</link>
    <link>http://www.rottentomatoes.com/m/1198041</link>
    ...
</links>

Examples:
http://api.getglue.com/v2/object/links?objectId=http://www.amazon.com/dp/B001P9KR8U/&token=token
http://api.getglue.com/v2/object/links?objectId=movies/slumdog_millionaire/danny_boyle&token=token

/object/replies

Parameters:

objectId - either the URL of a recognized page or Glue objectKey
userId - Glue username of the user who started the reply thread

Response:

Replys (as interactions (with userId)) to the given user's interaction on the given object

<interactions>
    <interaction>
        <objectKey>tv_shows/weeds</objectKey>
        <link>http://www.netflix.com/Movie/Weeds_Season_3</link>
        <title>Weeds</title>
        <image>http://cdn-1.nflximg.com/us/boxshots/large.jpg</image>
        <userId>fk_test_0319</userId>
        <displayName>fk test qa cheez</displayName>
        <action>Reply</action>
        <comment>test test. weeeeeeeeds man. weeeeds.</comment>
        <source>netpro2kdev</source>
        <timestamp>2009-03-19T08:21:23Z</timestamp>
    </interaction>
    ...
</interactions>

Examples:
http://api.getglue.com/v2/object/replies?userId=mtab&objectId=http://www.amazon.com/dp/B001P9KR8U/&token=token
http://api.getglue.com/v2/object/replies?userId=mtab&objectId=movies/slumdog_millionaire/danny_boyle&token=token

/object/similar

Parameters:

objectId - either the URL of a recognized page or Glue objectKey

Response:

A list of similar objects

<similarObjects>
    <show>
        <key>tv_shows/mad_men</key>
        <url>http://www.netflix.com/Movie/Mad_Men_Season_1/70072582</url>
        <title>Mad Men</title>
        <image>http://cdn-2.nflximg.com/us/boxshots/large/70072582.jpg</image>
    </show>
    <show>
        <key>tv_shows/dead_like_me</key>
        <url>http://www.netflix.com/Movie/Dead_Like_Me_Season_1/60036792</url>
        <title>Dead Like Me</title>
        <image>http://cdn-2.nflximg.com/us/boxshots/large/60036792.jpg</image>
    </show>
    ...
</similarObjects>

Network-wide Methods

/glue/categories

Response:

Alphabetized list of all supported categories with human-readable name and record types.

<categories>
	<category>
		<name>Books</name>
		<modelName>books</modelName>
	</category>
	<category>
		<name>Electronics</name>
		<modelName>electronics</modelName>
	</category>
	<category>
		<name>Movie Stars</name>
		<modelName>movie_stars</modelName>
	</category>
	...
</categories>

Example: http://api.getglue.com/v2/glue/categories&token=token

/glue/popular

Parameters:

category - One of the categories supported by Glue, or all.

Response:

The 100 most popular objects in the given category. (See paging for details on how to request aditional items)

<interactions>
    <interaction>
        <rank>1</rank>
        <rankChange>3</rankChange>
        <title>Raiders of the Lost Ark</title>
        <image>http://images.barnesandnoble.com/images/26280000/26281568.JPG</image>
        <objectKey>movies/raiders_of_lost_ark/steven_spielberg</objectKey>
        <link>http://video.barnesandnoble.com/DVD/97361328249/?cds2Pid=16639</link>
        <activity>34</activity>
    </interaction>
    <interaction>
        <rank>2</rank>
        <rankChange>-1</rankChange>
        <title>The Dark Knight</title>
        <image>http://cdn-3.nflximg.com/us/boxshots/large/70079583.jpg</image>
        <objectKey>movies/dark_knight/christopher_nolan</objectKey>
        <link>http://www.netflix.com/Movie/The_Dark_Knight/70079583</link>
        <activity>9</activity>
    </interaction>
	...
</interactions>

Example: http://api.getglue.com/v2/glue/popular?category=books&token=token

/glue/topUsers

Parameters:

category - One of the categories supported by Glue, or all.

Response:

The 50 most active users in the given category.

<users>
    <user>
        <rank>1</rank>
        <userId>Joe</userId>
        <activity>34</activity>
    </user>
    <user>
        <rank>2</rank>
        <userId>Bill</userId>
        <activity>27</activity>
    </user>
    ...
<users>

Example: http://api.getglue.com/v2/glue/topUsers?category=books&token=token

/glue/recent

Parameters:

category - One of the categories supported by Glue or all. Defaults to all.

Response:

The most recent public interactions (with userId). (See paging for details on how to request aditional items)

<interactions>
    <interaction>
       <title>Dancing with the Stars</title>
       <image>http://ia.media-imdb.com/images/M/BnXkFtZTcwNDc5MjI1MQ_.jpg</image>
       <action>Looked</action>
       <userId>GarryGlueman</userId>
       <objectKey>tv_shows/dancing_with_stars</objectKey>
       <source>http://www.variety.com/profiles/Dancing.html?dataSet=1</source>
       <timestamp>2009-05-05T23:31:22Z</timestamp>
	</interaction>
	...
</interactions>

Example: http://api.getglue.com/v2/glue/recent?category=books&token=token

/glue/findObjects

Parameters:

q - search query

Response:

Objects that matched your search query

<matches count="9">
    <books count="4">
        <book>
            <key>books/batman_dark_knight_returns/frank_miller</key>
            <title>Batman: The Dark Knight Returns</title>
        </book>
        ...
    </books>
    <movies count="4">
        <movie>
            <key>movies/batman_tales_of_dark_knight/boy_kirklan</key>
            <title>Batman: Tales of the Dark Knight</title>
        </movie>
        ...
    </movies>
    <music count="1">
        <album>
            <key>music/dark_knight/hans_zimmer</key>
            <title>The Dark Knight</title>
        </album>
    </music>
</matches>

Example: http://api.getglue.com/v2/glue/findObjects?q=dark knight&token=token

/glue/findUsers

Parameters:

userId - partial username or email to search for

Response:

The usernames that match your search query

<users>
    <user>
        <userId>Joe</userId>
    </user>
    <user>
        <userId>Bill</userId>
    </user>
    ...
<users>

Example: http://api.getglue.com/v2/glue/findUsers?userId=joe&token=token


	Glue works with Firefox or Internet Explorer Download Firefox Download Internet Explorer