API Guide v2.0

Bookmark Search

Version 1 | Version 2

HTTP Method & URL
GET <base-url>?Type=BookmarkSearch&Keyword=<searchstring>&Version=2&UserId=<userid>
Parameters
Type <Required> Type of the request resource
Version <Required> API version#
Keyword <Required> Search String
UserId <optional> If userid is given, the results will also include the user's personal bookmarks. Providing the userid produces the same results as if the user is logged-in and searched.
Page <optional> Page# (starts with 1) of the results. Defaults to 1st page.
Description
Returns the list of all bookmarks matching the given search string.
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <TimeStamp> 2008-03-25 05:29:30 GMT </TimeStamp>
  <APIVersion> 2.0 </APIVersion>
  <CurrentPage> 1 </CurrentPage>
  <TotalPages> 20 </TotalPages>
  <PageSize> 10 </PageSize>
  <Bookmarks>
    <Bookmark> 
      <Name> CNN.com - Breaking News, U.S., World, Weather, Entertainment
 _ Video News </Name>
      <URL> http://www.cnn.com/ </URL>
      <SaveCount> -1 </SaveCount>
      <Id> 204 </Id>
      <Tags>
        <Tag>
          <Keyword> news </Keyword>
          <Id> 34 </Id>
          <Weight> 1 </Weight>
        </Tag>
      </Tags> 
      <UserName> Joe Doe </UserName>
      <CreatedOn> 6 days ago </CreatedOn>
      <Community>
        <Name> News Community </Name>
        <Id> 333 </Id>
        <Type> group_open </Type>
      </Community>
      <CommentCount> 2 </CommentCount>
    </Bookmark>
  </Bookmarks>
</Response>
Notes:
  • Type values, as in <Community><Type>value</Type></Community>
    • private : User's private community
    • company : Public (shared with all)
    • group_restricted : Restricted Group
    • group_open : Open Group

back to top

©2008 Connectbeam, Inc.