Xstreet RSS feeds

From Second Life Wiki

Second Life Wiki > Knowledge Base > Xstreet RSS feeds
Jump to: navigation, search

Template:Needs Translation/KB/de Template:Needs Translation/KB/es Template:Needs Translation/KB/el Template:Needs Translation/KB/fr Template:Needs Translation/KB/he Template:Needs Translation/KB/it Template:Needs Translation/KB/ja Template:Needs Translation/KB/ko Template:Needs Translation/KB/nl Template:Needs Translation/KB/hu Template:Needs Translation/KB/no Template:Needs Translation/KB/da Template:Needs Translation/KB/sv Template:Needs Translation/KB/tr Template:Needs Translation/KB/pl Template:Needs Translation/KB/pt Template:Needs Translation/KB/ru Template:Needs Translation/KB/uk Template:Needs Translation/KB/zh-Hans Template:Needs Translation/KB/zh-Hant

This article is part of the Second Life® Knowledge Base. Although Linden Lab can't guarantee its accuracy, as part of the Knowledge Base it must meet high quality standards, and designated Reviewers must approve any changes. You can edit this article and make it better! Learn more.

add versioning

The Xstreet Marketplace has several RSS feeds you can use to receive automatic updates or for syndication.

Contents

Introduction

A list of RSS category feeds using Firefox's built-in RSS feature

With so many products and items being offered and sold on Xstreet, you might ask:

  • I run an SL merchant blog on the World Wide Web to promote my items. How do I publish a regularly-updated list of products I sell, without having to maintain my product list in two places, and without any programming experience?
  • The marketplace seems to be full of items that don't interest me, but I know what categories I care about. How can I view the most popular items in a particular Xstreet category, such as office furniture, without having to see items I'm not interested in?
  • I already read so many websites. How can I easily stay current on the most popular vehicles on Xstreet while I'm checking all my favorite blogs and news feeds?

Xstreet's RSS feeds are an easy way for Second Life residents to publish, share, customize, or simply keep up with an automatically updated content about Xstreet marketplace products. RSS stands for "Really Simple Syndication".

The ability to publish content using RSS is called syndication. Syndication enables you to do things such as hosting a real-time product list on your blog.

Syndication collects RSS content and metadata into a standardized XML format, which enables the content to be displayed in multiple formats even though it's sourced in one place. You can also add the recognizable RSS icon ("") to your website so that users familiar with RSS can easily subscribe, or publish the same RSS content on their own blogs. You'll benefit by seeing more targeted traffic to your Xstreet products. You can even track and analyze the click-throughs that led to your marketplace items by adding a special parameter to your RSS feed link.

If you're not looking to distribute RSS content to others but just want to watch updates yourself, you can subscribe to an RSS feed by, for instance, adding a RSS feed link to browser's Live Bookmarks, an RSS feed reader such as Google Reader or My Yahoo, or even your mobile device.

To subscribe, just click on the ("") icon (you'll see one just by visiting the default Xstreet marketplace page, which lists the most popular items), or you can customize an standard RSS link by adding parameters such as categories, language locales, description length, maximum number of items to display, and so on.

Syndicating and subscribing the easy way: default RSS feeds

Xstreet provides several standard RSS feeds to publish or view broad categories of items at once, as detailed in the following table.

To view Use
All new items on Xstreet https://www.xstreetsl.com/rss/new_items.php.
The most popular items on Xstreet https://www.xstreetsl.com/rss/popular_items.php
A random sampling of free items on Xstreet https://www.xstreetsl.com/rss/free_items.php
All categories and subcategories in one alphabetized list https://www.xstreetsl.com/rss/categories.php
The newest SL real estate listings https://www.xstreetsl.com/rss/new_real_estate.php

To filter your feeds by information types that interest you, you can tack on one or more parameters to the end of these base URLs to create a customized RSS feed to syndicate or subscribe to. The more commonly used parameters are:

  • maxItems limits or expands the number of RSS items displayed
  • maxDescriptionLength sets the length of item descriptions by number of characters
  • enableAdult enables the display of adult or mature items
  • category filters the categories displayed to only category ID numbers you specify

Parameters in a URL should be preceded by a question mark (?) and followed by an equal sign (=) with the value for the parameter. For instance, you can see the top 10 most popular items by adding the parameter ?maxItems=10 to the Popular Items feed: https://www.xstreetsl.com/rss/popular_items.php?maxItems=10.

You can add multiple parameters in one URL.

Various other parameters such as referrer, thumbSize, merchant, and parcelType may also be used in some feeds. All of these parameters are detailed in the sections below.

Note that these parameters only work with some, not necessarily all, of the default RSS URLs.

Limiting the number of returned items

By default, all the Xstreet RSS feeds display 20 items at once. If you want to limit your RSS feed items to a smaller or larger number, add the maxItems parameter to the URL.

You can set the maximum number of items displayed between one (1) and 100; for example, ?maxItems=12.

This parameter works with:

This parameter does not work with the Categories RSS feed.

Example links with different maximum numbers of items

List:

Limiting descriptions to a maximum number of characters

Descriptions are set to display the first 30 characters by setting ?maxDescriptionLength=30.
If the descriptions (not the titles) of items returned by the RSS feeds are longer than you'd like, you can use the maxDescriptionLength parameter to control the description length by the number of characters.

By default, the item descriptions allow 150 characters, but you can set a number between 1 and 500.

You can limit item description length in the following standard feeds:

This option does not work with the Categories feed.

Example links with item descriptions


Enabling adult content

By default, items designated "adult" by the merchant are not displayed in RSS feeds.

If you would like to include adult AND non-adult items in your RSS feed, use the enableAdult parameter to your RSS URL, and set it to true.

The enableAdult parameter works with the following standard RSS feeds:

This parameter does not apply to the New Real Estate feed.

Example links with adult content enabled

Limiting items to one or more categories

If you would like to display items in your RSS feed from one or more categories, use the category option and add the category ID numbers you want to display, separated by a comma.

If this parameter is not supplied, the results will be ALL categories that fit any additional criteria supplied.

Subcategories will also be included with the parent categories.

This parameter works with the following feeds:

The category parameter does not work with New Real Estate listings.

Example link formats

Displaying items in XML or JSON format

Free Xstreet Items in JSON format.
By default, all XSS feeds display in XML 1.1 format, but you can set the feed to display in JSON with the responseType [parameter]. (For more information, see http://www.json.org/.)

This parameter works with all feeds:

Example links using responseType:

Viewing items from a particular region

An RSS feed with the de_DE option enabled displays in German
By default, the all the RSS feeds display in U.S. English, but you can optionally choose a different display language with the locale parameter.

The locale parameter sets the language of the feed title as well as items that have a locale-specific entry (or leave them in English if not). Your locale options are French, German, Japanese, Spanish, and Brazilian Portugese.

To add a locale parameter, append these parameters to the end of the base URL, followed by one of the codes below:

  • locale=de_DE = German
  • locale=es_ES = Spanish
  • locale=fr_FR = French
  • locale=jp_JP = Japanese
  • locale=pt_BR = Brazilian Portuguese

Example links in different locales:

This parameter works with:

This parameter does not work with the new real estate feed.

Setting the referrer for your RSS link

If you host an RSS feed on various places on the web, you may want to track the referring pages. To do this, use the referrer parameter. This passthrough parameter will be attached to urls generated for each <link> in the feed.

Adding the referrer parameter to a URL does not change the displayed contents.

The referrer parameter works with all feeds:

Example feed with the referrer option


Setting the size of image thumbnails

If you use an RSS reader that includes image thumbnails, you can set the size of the thumbnails with the thumbSize parameter. The options for this parameter are large and small.

The thumbSize parameter works with these three feeds:

This parameter does not work with Categories and New Real Estate feeds.

Example links with various thumbnail sizes:

Limiting items to one or more merchants

If you have a favorite merchant you'd like to track (or, if you are a merchant who wants to add an RSS feed for your items on your website), you can supply one or more merchant ID numbers with the merchant option. Separate each merchant ID by a comma.

You can find your Xstreet SL Merchant ID number by going to Xstreet SL, navigating to the page displaying all of your items & copying your merchant ID number located at the end of the URL following the tag "MerchantID="

The merchant parameter only works with:

This option does not work with Popular Items, Free Items, All Categories, or New Real Estate Listings.

Example link using the merchant parameter

These are the newest items being sold by three merchants: https://www.xstreetsl.com/rss/new_items.php?merchant=409,649,12015

Showing real estate listings by parcel type

By default, the new real estate feed lists all parcel types, but you can specify the parcel types you want to display by each type's ID number. For this, use the parcelType parameter in your URL.

  • 1 - Flat land
  • 2 - Snow
  • 3 - Waterfront
  • 4 - Hillside
  • 5 - Water
  • 6 - Island
  • 7 - Roadside
  • 8 - Hilltop

This parameter only works in the New Real Estate feed.

Example link:

New real estate in snow, hillside, and island parcel types: https://www.xstreetsl.com/rss/new_real_estate.php?parcelType=2,4,6


Examples with multiple parameters

You can join multiple parameters with an ampersand (&) at the end of a URL.


Combining parameters in a new items feed

Suppose you want to create a feed listing all new items with the following settings:

  • Return the results in XML 1.0 format
  • List a maximum of 5 items
  • Contain only non-adult items
  • Only categories 4 and 6 (and their subcategories)
  • List each name and description for each item in French if it exists, otherwise in U.S. English as a fallback
  • limit item descriptions to 50 characters
  • embed a referrer to "landstore"

You would use this URL: https://www.xstreetsl.com/rss/new_items.php?category=4,6&referrer=landstore&maxItems=5&maxDescriptionLength=50&locale=fr_FR

Combining parameters in a popular items feed

Suppose you want to create a feed listing all popular items with the following settings:

  • Return the results in JSON format
  • List 10 items maximum
  • Contain both adult AND non-adult items
  • Set German as the locale, but fall back to English by default
  • limit item descriptions to 150 characters

You would use this URL: https://www.xstreetsl.com/rss/popular_items.php?maxItems=10&enableAdult=true&responseType=json&locale=de_DE

Retrieved from "http://wiki.secondlife.com/wiki/Xstreet_RSS_feeds"
Personal tools
In other languages