last update: 12-10-2001
This documentation is meant for people who would like to search the CD Express music catalog and include the result in their website.
CD Express provides two ways of searching by referring websites.
For both methodes the search parameters are the same and the following
paramaters are available:
term = is the value you would like search for.
waar = this parameter can contain only two valid values which are 'artiest'
or 'titel' . 'artiest' means you will search on artist and 'titel' means
you will be searching on title (of the song or album)
hoe = this parameter can contain only two valid values which
are 'exact' or 'bevat'. With 'exact' it will search on a exact match and
with 'bevat' it will search for the provided word in 'term' in the whole
field .
genre = this parameter is reserved for future use and defaults to 'all'
if not provided which at this time is only valid value. It defines
the type of music.
drager = this parameter defines is the media on which the music is
available. Valid values are all,6,vinyl,7. all=everything, 6=CD's,
vinyl=all types of vinyl,7=DVD and video tapes.
numrows = This parameter defines the number of rows show in the search
result. for typ I search is defaults to 25 and type II search is defaults
to 100. the limited is 500 rows
lang = This parameter defines the language is which the search result
page is showed. The valid options are NL,UK,DE,SP,IT which correspond the
apropiate ISO country code. It defaults to 'UK'
aff= This parameters allows you provide your affiliate code (provided
by CD Express if register yourself). You can register by sending an
email providing the
URL of the referring website, your name, emailadres and telephone number
(please include international code) and put in the subject 'requesting
affiliate code'
Please note that all parameter values should be URL encoded, so for
example 'elvis presey' will be 'elvis+presley' URL encoded.
URL below: show all vinyl records of artists with the word 'joy' is their name and show the result page in english and limit the result to 45 rows (if more are available the user will be provided a link to see the next 45 rows of the search result)
http://search.cdexpress.com/cleansearch.php?term=abba&waar=artiest&hoe=exact&drager=all&genre=all
URL below: show all CD's of Elvis Presley with an exact match with the result page in dutch and limit the search result to 50 rows
URL below: show all vinyl records of artists with in their the word 'joy' or 'band' ,the result page in english and limit the search result to 250 rows