Search API

From Second Life Wiki
Revision as of 22:46, 3 September 2008 by Dedric Mauriac (talk | contribs)
Jump to navigation Jump to search

API Guide

What is it?

The Second Life Search API allows you to search the virtual world of Second Life for Events, Groups, People, Places, and this Wiki .

Getting Started

The Second Life Search API is currently using a Google search appliance as the core of the API. You can search against the world using a standard web browser. Two URL's may be used as follows:

http://search.secondlife.com/client_search.php?q=Your_text_here http://secondlife.com/app/search/search_proxy.php?q=Your_text_here

Paging

Each query will return 10 results at the most. The parameter passed for paging is "start". This is a zero-based index identifying what record to start with. To view page 1, the following URL may be used.

q= [search for something here] &start= [(page - 1) * 10]

Page 1 http://search.secondlife.com/client_search.php?q=Your_text_here&start=0

Page 2 http://search.secondlife.com/client_search.php?q=Your_text_here&start=10

Page 3 http://search.secondlife.com/client_search.php?q=Your_text_here&start=20

Note Any results after page 100 will return nothing.

Location

When searching from the viewer, the location of the avatar is passed along to the Search API. This is optional. The following parameters are used.

Parameter Data type Description
Region string Region name where avatar is located.
X integer Position of avatar in region coordinates on X axis
Y integer Position of avatar in region coordinates on Y axis
Z integer Position of avatar in region coordinates on Z axis

http://search.secondlife.com/client_search.php?q=Your_text_here&region=Here&x=128&y=128&z=36


Miscellaneous Information

t - n - Guessing teen grid. Teen = Y, Adult = N. Without proper session, defaults to N? session - 00000000-0000-0000-0000-000000000000 - session of avatar looking at results. changes with each login. m - n - Y = Mature, N = PG s - filter results by category - All, Events, Groups, People, Places, Wiki lang - Language for user interface. en-us is English for United States.

site - default_collection - not sure. guessing might be "All" type of search. hl - en - language lr - unknown ie - UTF-8 - text encoding output - xml_no_dtd - xml results from appliance client - raw_xml_frontend - transform into xml results for user agent access - p - unknown sort - date:D:L:d1 - sort by date, lindens, object date? sa - N - unknown filter - 0 - unknown dbg - 0 - debug information?


Host: search.secondlife.com User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; chrome://navigator/locale/navigator.properties; rv:1.8.1.13) Gecko/20080314 SecondLife/1.20.15.92456 (Second Life Release; silver skin) Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5 Accept-Encoding: gzip,deflate Keep-Alive: 300 Connection: keep-alive Cookie: __utmz=########.##########.#.#.utmcsr=(direct)|utmccn=(direct)|utmcmd=(none); __utma=########.##################.##########.##########.##########.###; __utmc=########