All current bugs in regards to returning blank or null fields have been fixed. In addition, I have added to the URLs for the search (actually it did this before, but I forgot to document it)

It can now accept the following format:

http://services.katharineberry.co.uk/search/search/(main|teen|mature)[/(all|classifieds|events|groups|people|places|wiki)]/search+term[/page-number]

The new parameter is in bold, and is entirely optional. It sets the category through which to search. Some example URLs:

http://services.katharineberry.co.uk/search/search/teen/test+search – A search for “test search” on the TG
http://services.katharineberry.co.uk/search/search/teen/groups/Group – A search for “Group” in all TG groups
http://services.katharineberry.co.uk/search/search/teen/places/Land/2 – Page 2 (results 11-20) of a search for “Land” in all TG places
http://services.katharineberry.co.uk/search/search/main/test+search – A search for “test search” on the MG
http://services.katharineberry.co.uk/search/search/mature/test+search – A search for “test search” on the MG, with mature results enabled.

Search results will now return an object that looks something like this (ficticious search):

{
    success: true,
    results: [
        {
            type: "wiki",
            url: "http://wiki.secondlife.com/wiki/Some_wiki_page",
            name: "Some wiki page",
            summary: "Excerpt from some wiki page..."
        },
        {
            type: "place",
            uuid: "e7b6d188-9f88-7a04-c066-4caa8e2b3fb6",
            url: "http://teen.world.secondlife.com/place/e7b6d188-9f88-7a04-c066-4caa8e2b3fb6",
            name: "Teen Grid's Party Event Area",
            summary: "Host parties for new coming/outgoing friends! Or just chill, hangout and relax!"
        },
        {
            "type":"event",
            "id":"1234567",
            "url":"http://teen.world.secondlife.com/event/1234567",
            "name":"Sample Event",
            "summary":"This is a test event that doesn't actually exist."
        }
    ]
}

Residents, places, groups and classifieds will follow the format of “place” above. Events will follow that of “event” above.

Everything else will be in the format of the “wiki” entry.

Data from /place/ looks like this (edited output from.. oops, lost the URL):

{
    success:true,
    name: "Teen Grid's Party Event Area",
    image: "9a7e13c0-b8bc-1885-9183-a2123c5c5dbb",
    category: "Linden Location",
    region: {
        name: "Dougall",
        uuid: "236910c3-cc59-ae3d-3594-4c2bdf9bc3b8"
    },
    position: {
        x: 187,
        y: 64,
        z: 31
    },
    description: "Host parties for new coming/outgoing friends! Or just chill, hangout and relax! Host all your parties here!",
    owner: {
        group: false,
        name: "Governor Linden",
        uuid: 3d6181b0-6a4b-97ef-18d8-722652995cf1
    },
    objects: [
        [
            {
                price: 10,
                name: "Test Object",
                description:"Object added to show object result format",
                position: {
                    x: 141,
                    y: 37,
                    z: 28
            }
        }
    ]
}

Resident results look like this (edited output from http://services.katharineberry.co.uk/search/resident/16459c45-227a-4a4a-ac4c-5badfac9ac65):

{
    success: true,
    name: "Alister Harrington",
    image: "00000000-0000-0000-0000-000000000000", /* Were this person to have a profile image, it would be here. */
    description: "Alister Harrington - Well, I'm Alister.  I'm 15, I make boats.  That's about it really.",
    born: "2005-06-08",
    picks: [
        {
            uuid: "09545df4-0fae-7561-7473-d11c164d7c71", /* These UUIDs are places - although many of them don't seem to work. */
            name: "1 - First poast.",
            description: "And it rocks."
        },
        {
            uuid: "b1f87754-5ac3-d96a-8ff1-ccb7240f3489",
            name: "8 - Quotes 7",
            description: "[Storm at the Eye4You College Fair]

[13:31]  Storm Basiat: So
[13:31]  Stephanie Carducci is Online
[13:31]  Saryn Fanwood: sometimes I wonder
[13:31]  Saryn Fanwood: 
[13:31]  Storm Basiat: Welcome to another speach
[13:31]  Libby Beam: 
[13:32]  Storm Basiat: We will try and make this quick as possable as i hate speaches
[13:32]  Storm Basiat: becuase im crap at it"
        }
    ]
}

Classifieds look like this: (from http://services.katharineberry.co.uk/search/classified/149b8d14-53e6-d125-53e8-4f64c5435623)

{
    success: true,
    name: "Wolf Quadrupeds!",
    image: "4c76a073-affd-9b69-0016-923296a79a84",
    description: "One of the most realistic wolf quad's on the Teen Grid!
comes in black, brown, white and grey
change the color of the eyes with a command
and change the direction of the ears with a hud ^.^
price, 800L

Now selling limited halloween wolf quads!
comes with fangs, wings horns and glowing eyes >:D
comes in green, purple, orange, yellow and pink.
price, 700L

key words: wolf avatar avatars wolves animals furry furries av avies nature halloween costume",
    price: 200,
    region: {
        uuid: "ccb75d6a-13c1-edbb-bf00-c70b65e50117",
        name: "Nailsworth"
    },
    place: {
        uuid: "0973bff5-dd79-89c6-f409-38f4a47afd8c",
        name: "Wolf's Territory"
    },
    creator: {
        uuid: "0ea431a3-0a7c-41b4-af8b-e658e3aec93a",
        name: "Blue Newcomb"
    },
    position: {
        x: 101,
        y: 218,
        z: 49
    }
}

Region data looks like this (from http://services.katharineberry.co.uk/search/region/ccb75d6a-13c1-edbb-bf00-c70b65e50117):

{
    success: true,
    parcels: [
        {
            uuid: "36c1e094-4b2b-06cc-eb3d-74eb5c3baf6d",
            name: "Devin Jordans Dezines",
            position: {
                x: 26,
                y: 22,
                z: 22
            }
        },
        {
            uuid: "93f4d010-5158-fa12-76dd-07570d3354d0",
            name: "HOUSEING DISTRICT",
            position: {
                x: 140,
                y: 227,
                z: 52
            }
        },
        {
            uuid: "e91c73c9-7d70-7f04-f205-61fec9e3329f",
            name: "Beautiful Waterfront Land",
            position: {
                x: 157,
                y: 69,
                z: 26
            }
        }
    ],
    name: "Nailsworth"
}

Events look like this (from http://services.katharineberry.co.uk/search/event/1030959)

{
    success: true,
    name: "Party@Club Red Inferno",
    category: "Nightlife/Entertainment",
    description: "come party at club red inferno and help us raise money to keep the land",
    rating: "PG",
    time: 1196535600,
    length: 10800, /* This is in seconds. */
    host: {
        uuid: "b5fa82fa-ec0a-42dd-beac-be417dcdc91a",
        name: "SkullKing Kidd"
    },
    region: {
        uuid: "8264f163-71b7-fe56-80c6-e5163a2c5bdb",
        name: "Bull"
    },
    place: {
        uuid: "fff021c9-6bc1-d67e-6caa-540f74924f9d",
        name: "CLUB RED INFERNO"
    },
    position: {
        x: 151,
        y: 15,
        z: 21
    }
}

This is a group (http://services.katharineberry.co.uk/search/group/6e9aa3c7-131e-0a99-f282-2d00e4ed69e8 – first result for a search for “group” in the category “groups”)

{
    success: true,
    name: "Info Trade Business Group",
    image: "3cb1f189-9700-7f04-0b18-3fc8c9555723",
    members: 203,
    founder: {
        uuid: "c4bf9d63-f318-4799-8497-b4a7fcd89ec2",
        name: "Gabe Gallacher"
    }
}

Note that many (if not all) TG groups seem to be missing for some reason. LL’s fault, not mine.

Popular places (from http://services.katharineberry.co.uk/search/popular/teen/5)

{
    success: true,
    results: [
        {
            uuid: "e1549fee-b9c6-1da0-47db-00aefc4eee51",
            name: "Sandbox Cleans every 3 hours. SAVE WORK-NO WARNING",
            traffic: 9796
        },
        {
            uuid: "29563825-a6e5-5e56-2e2a-5605df6f114e",
            name: "Jeffrey Land",
            traffic: 7330
        },
        {
            uuid: "213a5ed6-7d5f-cf0f-1f95-e78d0c900668",
            name: "^ [ Atticus Tech Sky Mall ] ^ - Look Up - Vacancy 2nd floor",
            traffic: 6253
        },
        {
            uuid: "6e93da51-07b8-574e-c615-c5d9fe805809",
            name: "Sandbox Cleans every 3 hours. SAVE WORK-NO WARNING",
            traffic: 5961
        },
        {
            uuid: "260633c8-6287-4b51-aa54-4d00ff6c2bbb",
            name: "WEAPONS TESTING SANDBOX - Wipes every 3 hours",
            traffic: 5872
        }
    ]
}

All the methods have the base URL http://services.katharineberry.co.uk/search/.

Firstly, the search itself. This provides acccess to either MG or TG search, and provides information about all results on the page. It also supports specifying a page.

The format is as follows:

http://services.katharineberry.co.uk/search/search/(teen|main|mature)/search+string[/page-number]

The /page-number must be an integer, and is optional. If you use “teen” you get TG results, “main” gives MG results, and “mature” gives MG results with mature enabled. The output, assuming you know what JSON is, is fairly self-explanatory.

Additionally, you can access a bunch of other data:

http://services.katharineberry.co.uk/search/classified/required-uuid

http://services.katharineberry.co.uk/search/place/required-uuid

http://services.katharineberry.co.uk/search/resident/required-uuid

http://services.katharineberry.co.uk/search/region/required-uuid

http://services.katharineberry.co.uk/search/event/eventid

http://services.katharineberry.co.uk/search/group/required-uuid

Excluding events, all of the above expect a UUID in place of “required-uuid”. They can take both hyphenated and unhyphenated UUIDs. Events expect an Event ID, which are currently seven digit integers.

It can also pick out up to the top 100 popular places (I could do more – up to 50,000 – but capped it at 100 to save my server from certain death). The format for this is as follows:

http://services.katharineberry.co.uk/search/popular/(main|teen)/count

Using “main” gets MG data, “teen” gets TG data. “count” specifies the number of results to be returned.

Finally, as a bonus feature, if you have a key and have no idea what it’s for, put it in like this:

http://services.katharineberry.co.uk/search/unknown-uuid

This will make it search through the classifieds, parcels, residents, regions, events, groups, and textures. If it’s any of the above (except textures) it’ll return the same output as the standard services, with the added property “uuidtype” being set to one of the above. If it was a texture you only get the uuidtype. Please note that this takes several seconds to run, and is a relatively heavy job for my server.

I hope someone finds some use for this. Personally, I plan to use it in AjaxLife.