Chapter 2. Specification

1. Accessing TemplateMonster Catalog via HTTP

1.1. templates_screenshots4.php

URL:

http://www.templatemonster.com/webapi/templates_screenshots4.php

Description:

Returns a plain text table of properties of selected templates.

Status:

0.2

Synopsis:

http://www.templatemonster.com/webapi/templates_screenshots4.php?[linebreak=<linebreak>][&delim=<delimiter>] [(&from=<first_template_number>&to=<last_template_number> | &last_added=Yes | &sold=Yes)] [&filter=<filter_number>] [&category=<category_number>] [&keywords=<keywords>] [&sort_by=<sort_type>] [&order=( asc | desc )] [&list_delim=<delimiter>] [&list_begin=<list_begin_char>] [&list_end=<list_end_char>] [&full_path=<full_path_flag>][&currency=<currency>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate lines (default: \r\n)
delim	string	a sequence of characters used to separate columns (default: \t)
from	integer	a starting template number (inclusive, default: 1)
to	integer	an ending template number (inclusive, default: a maximum item number available)
last_added=Yes	string	Templates from the last 'new templates report' will be listed only if this parameter exists and has a nonzero length.
sold=Yes	string	Sold and permanently removed from TemplateMonster templates will be listed only if this parameter exists and has a nonzero length.
filter	integer	If this parameter exists, not all templates will be returned, but the ones that match certain criteria (default: 0). Acceptable values: 0 - all templates except adult website templates 1 - website templates only (hosting website templates included) 2 - hosting website templates only 3 - flash intro templates only 4 - adult website templates only 5 - unique logo templates only 6 - non unique logo templates only 7 - unique corporate identity packages only 8 - non-unique corporate identity packages only.
keywords	string	A space separated list of keywords associated with the template. If this parameter exists, not all templates will be returned but the ones that contain given keywords only.
category	integer	If this parameter exists, not all templates will be returned, but the ones that belong to this category only. Use a script categories.php to obtain acceptable values.
sort_by	string	If this parameter exists, records will be sorted by a certain attribute. By default, records are sorted by a template number. Acceptable values: number - sort by a template number date - sort by date of addition price - sort by price
order=( asc \| desc )	string	The default order is ascending. Acceptable values: asc - ascending order desc - descending order
list_delim	string	a sequence of characters used to separate list items (default: , )
list_begin	string	a sequence of characters used to mark the beginning of the list (default: { )
list_end	string	a sequence of characters used to mark the end of the list (default: } )
full_path	string	if this parameter exists and its value is 'true' a full path to screenshots is returned.
currency	3 chars	If this parameter exists templates prices will be priced using a currency different from USD. Acceptable values: EUR - templates prices will be in Euros CAD - templates prices will be in Canadian Dollars GBP - templates prices will be in British Pounds Sterling JPY - templates prices will be in Japanese Yen AUD -templates prices will be in Australian Dollars.

Response:

Response is a plain text table delimited with <delimiter>. It consists of the following columns (without columns headers):

Column	Type	Description
id	integer	an item number of the template
price	integer	a regular price of the template
exclusive price	integer	an exclusive price of the template
date of addition	date	the date when the template was added to the database in YYYY-MM-DD format
number of downloads	integer	the number of downloads
is hosting	integer (1/0) 1-true	equals 1 for Hosting Website templates
is flash	integer (1/0) 1-true	equals 1 for Flash Intro templates
is adult	integer (1/0) 1-true	equals 1 for Adult templates
is unique logo	integer (1/0) 1-true	equals 1 for unique Logo templates
is non unique logo	integer (1/0) 1-true	equals 1 for non-unique Logo templates
is unique corporate	integer (1/0) 1-true	equals 1 for unique Corporate Identity Packages
is non unique corporate	integer (1/0) 1-true	equals 1 for non-unique Corporate Identity Packages
author's ID	integer	a template's author identifier
is full site template	integer (1/0) 1-true	equals 1 for Full Site templates
number of pages	integer	the number of subpages (some templates are not full site templates but still contain several subpages).
screenshots list	list	a list of all screenshots of this template delimited with <delimiter>, started with <list_begin> and ended with <list_end>. By default, only variable part of URL is displayed. If you want to obtain a full URL, set <full_path> parameter to 'true'

Response example:

http://www.templatemonster.com/webapi/templates_screenshots4.php?delim=|&from=12&to=30&keyword=hosting&sort_by=price&currency=EUR

19|10.59|174.74|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/19-b.jpg,0/19-h.jpg,0/19-m.jpg,0/19-rs.jpg}| 25|12.36|144.73|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/25-b.jpg,0/25-h.jpg,0/25-m.jpg,0/25-rs.jpg}| 12|13.24|138.55|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/12-b.jpg,0/12-h.jpg,0/12-m.jpg}| 13|13.24|138.55|2002-05-01|9|0|0|0|0|0|0|0|1|0|0|{0/13-b.jpg,0/13-h.jpg,0/13-m.jpg}| 15|13.24|112.08|2002-05-01|4|0|0|0|0|0|0|0|1|0|0|{0/15-b.jpg,0/15-h.jpg,0/15-m.jpg}| 17|13.24|181.80|2002-05-01|8|0|0|0|0|0|0|0|1|0|0|{0/17-b.jpg,0/17-h.jpg,0/17-m.jpg}| 27|13.24|131.49|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/27-b.jpg,0/27-h.jpg,0/27-m.jpg,0/27-rs.jpg}| 21|15.00|157.97|2002-05-01|6|0|0|0|0|0|0|0|1|0|0|{0/21-b.jpg,0/21-h.jpg,0/21-m.jpg,0/21-rs.jpg}| 29|15.00|122.67|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/29-b.jpg,0/29-h.jpg,0/29-m.jpg,0/29-rs.jpg}| 18|17.65|166.79|2002-05-01|3|0|0|0|0|0|0|0|1|0|0|{0/18-b.jpg,0/18-h.jpg,0/18-m.jpg,0/18-rs.jpg}| 23|21.18|184.44|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/23-b.jpg,0/23-h.jpg,0/23-m.jpg,0/23-rs.jpg}| 26|21.18|215.33|2002-05-01|4|0|0|0|0|0|0|0|1|0|0|{0/26-b.jpg,0/26-h.jpg,0/26-m.jpg,0/26-rs.jpg}| 16|25.59|157.97|2002-05-01|4|0|0|0|0|0|0|0|1|0|0|{0/16-b.jpg,0/16-h.jpg,0/16-m.jpg}| 28|25.59|224.16|2002-05-01|5|0|0|0|0|0|0|0|1|0|0|{0/28-b.jpg,0/28-h.jpg,0/28-m.jpg}|

1.2. template_sources.php

URL:

http://www.templatemonster.com/webapi/template_sources.php

Description:

Returns a plain text table of sources available for templates

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/template_sources.php?[linebreak=<linebreak>][&delim=<delimiter>] [&from=<first_template_number>&to=<last_template_number>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
from	integer	an item number of the first template (inclusive, default: 1)
to	integer	an item number of the last template (inclusive, default: a maximum item number available)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about available sources for templates from <first_template_number> to <last_template_number> (inclusive). It consists of the following columns (without columns headers):

Column	Type
id	integer
sources	string

Response example:

http://www.templatemonster.com/webapi/template_sources.php?from=8888&to=8899

8888    .PSD; .HTML; 
8889    .FLA; .SWF; .PSD; .HTML; 
8890    .FLA; .SWF; .PSD; .HTML; 
8891    .PSD; .HTML; .FLA; .SWF; 
8892    .PSD; .SWF; .FLA; .HTML; 
8893    .FLA; .SWF; .PSD; .HTML; 
8894    .FLA; .SWF; .PSD; .HTML; 
8895    .SWF; .FLA; .PSD; .HTML; 
8896    .PSD; .HTML; 
8897    .PSD; .HTML; 
8898    .PSD; .HTML; 
8899    .FLA; .SWF; .PSD; .HTML;

1.3. template_keywords.php

URL:

http://www.templatemonster.com/webapi/template_keywords.php

Description:

Returns a plain text table of keywords associated with templates

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/template_keywords.php?[linebreak=<linebreak>][&delim=<delimiter>] [&from=<first_template_number>&to=<last_template_number>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
from	integer	an item number of the first template (inclusive, default: 1)
to	integer	an item number of the last template (inclusive, default: a maximum item number available)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about keywords associated with templates from <first_template_number> to <last_template_number> (inclusive). It consists of the following columns (without columns headers):

Column	Type
id	integer
keywords	a string of keywords separated by spaces

Response example:

http://www.templatemonster.com/webapi/template_keywords.php?from=900&to=915

900|music mp3 songs singers bands audio
901|cars driving speed highway road automobiles vehicles
902|creative webdesign webpage website butterfly
903|hosting servers traffic domain bandwidth notebook
905|mobile phones cellular communication communications phone
908|furniture company interior design studio
909|computers it computer retailer internet media communication communications
910|bank banking insurance credit credits finance financing stock exchange money
911|hosting servers traffic domain bandwidth
912|flash intro business
914|internet auction bids vendue clocks
915|domain registration domain name web address web hosting hosting host

1.4. authors.php

URL:

http://www.templatemonster.com/webapi/authors.php

Description:

Returns a plain text table of all authors' IDs and nicknames.

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/authors.php?[linebreak=<linebreak>][&delim=<delimiter>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about the authors. It consists of the following columns (without columns headers):

Column	Type
author's ID	integer
author's nickname	string

Response example:

http://www.templatemonster.com/webapi/authors.php?delim=|

1|Big mama
3|Engine
4|MariArti
5|Casher
10|Dipixel
12|MAN!AK
13|Pharaoh
14|Dan
15|SR
17|Sloth
18|Bullet
19|Orange
21|Mc Oyed
22|Hummingbird
24|Wolf
25|Photographer
26|Shrew
27|Dgan Dgan
30|Glasgo Ranger
32|Flayer
36|Co-casher
37|Mr. Corpuscle

1.5. categories.php

URL:

http://www.templatemonster.com/webapi/categories.php

Description:

Returns a table of all templates categories

Status:

0.2

Synopsis:

http://www.templatemonster.com/webapi/categories.php?[linebreak=<linebreak>][&delim=<delimiter>][locale=<locale>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
locale	string	2 characters on locales name (default: en) Acceptable values: cz - Czech en - English de - German dk - Danish du - Dutch es - Spanish fi - Finnish fr - French hu - Hungarian it - Italian pl - Polish pt - Portuguese ro - Romanian tr - Turkish

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about templates categories. It consists of the following columns (without columns headers):

Column	Type
id of category	integer
name of category	string

Response example:

http://www.templatemonster.com/webapi/categories.php?locale=de&delim=|

1|Beauty
2|Business
3|Computer
4|Immobilien
5|Portal
6|Internet
7|Familie
8|Webdesign
9|Unterhaltung
10|Medizin
11|Auto
13|Neutral
14|Sport
16|Industrie
17|Religion
18|Medien
19|Musik

1.6. styles.php

URL:

http://www.templatemonster.com/webapi/styles.php

Description:

Returns a table of all templates styles

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/styles.php?[linebreak=<linebreak>][&delim=<delimiter>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about templates styles. It consists of the following columns (without columns headers):

Column	Type
id of style	integer
name of style	string

Response example:

http://www.templatemonster.com/webapi/styles.php?delim=|

1|3d
2|Artworks
3|Cartoon
4|Clean
5|Collage
6|Dark
7|Futurist
8|Geometric
9|Grunge
10|Minimalist
11|Paper Made
12|Retro
13|Corporate
14|Urban / Street
15|Vector
16|Neutral

1.7. template_categories.php

URL:

http://www.templatemonster.com/webapi/template_categories.php

Description:

Returns a plain text table that is a sequence of templates numbers and corresponding categories names. Warning: a template can belong to many categories, so more than one line can contain this template id.

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/template_categories.php?[linebreak=<linebreak>][&delim=<delimiter>] [&from=<first_template_number>&to=<last_template_number>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
from	integer	an item number of the first template (inclusive, default: 1)
to	integer	an item number of the last template (inclusive, default: a maximum item number available at templatemonster.com)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about categories content for templates from <first_template_number> to <last_template_number> (inclusive). It consists of the following columns (without columns headers):

Column	Type
id of template	integer
id of category	integer

Response example:

http://www.templatemonster.com/webapi/template_categories.php?delim=|&from=9005&to=9008

1.8. template_styles.php

URL:

http://www.templatemonster.com/webapi/template_styles.php

Description:

Returns a plain text table that is a sequence of templates numbers and corresponding styles IDs. Warning: a template can belong to many styles, so more than one line can contain this template id.

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/template_styles.php?[linebreak=<linebreak>][&delim=<delimiter>] [&from=<first_template_number>&to=<last_template_number>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
from	integer	an item number of the first template (inclusive, default: 1)
to	integer	an item number of the last template (inclusive, default: a maximum item number available at templatemonster.com)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about styles content for templates from <first_template_number> to <last_template_number> (inclusive). It consists of the following columns (without columns headers):

Column	Type
id of template	integer
id of style	integer

Response example:

http://www.templatemonster.com/webapi/template_styles.php?delim=|&from=9002&to=9008

1.9. featured.php

URL:

http://www.templatemonster.com/webapi/featured.php

Description:

Returns a list of the numbers of featured templates. There are two types of featured templates: featured website templates and featured flash intro templates. You can review featured website templates at http://www.templatemonster.com/index.php and featured flash intro templates at http://www.templatemonster.com/flash-templates.php

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/featured.php?[linebreak=<linebreak>][&delim=<delimiter>] [&type= ( website | flash )]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
type	string	a type of fearured templates. Acceptable values: website or flash. The default value is website.

Response:

Response is a plain text string containing template numbers delimited with <delimiter>.

Response example:

http://www.templatemonster.com/webapi/featured.php?delim=|&type=flash

9634|9426|8669|9635

1.10. template_info2.php

URL:

http://www.templatemonster.com/webapi/template_info2.php

Description:

Returns the info about the selected template.

Status:

0.2

Synopsis:

http://www.templatemonster.com/webapi/template_info.php?[linebreak=<linebreak>][&delim=<delimiter>] [&template_number=<template_number>] [&list_delim=<delimiter>] [&list_begin=<list_begin_char>] [&list_end=<list_end_char>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)
template_number	integer	an item number of the template (default: 1)
list_delim	string	a sequence of characters used to separate list items (default: , )
list_begin	string	a sequence of characters used to mark the beginning of the list (default: { )
list_end	string	a sequence of characters used to mark the end of the list (default: } )

Response:

Response is a plain text table delimited with <delimiter>. It consists of the following columns (without columns headers):

Column	Type	Description
id	integer	an item number of the template
price	integer	a template price (in USD)
exclusive price	integer	an exclusive price of the template (in USD)
date of addition	date	date of addition in YYYY-MM-DD format
number of downloads	integer	the number of downloads
is hosting	integer (1/0) 1-true	1 for Hosting Website templates
is flash	integer (1/0) 1-true	1 for Flash Intro templates
is adult	integer (1/0) 1-true	1 for Adult templates
is unique logo	integer (1/0) 1-true	1 for unique Logo templates
is non unique logo	integer (1/0) 1-true	1 for non-unique Logo templates
is unique corporate	integer (1/0) 1-true	1 for unique Corporate Identity Packages
is non unique corporate	integer (1/0) 1-true	1 for non-unique Corporate Identity Packages
author's ID	integer	a template's author identifier
author's nick	string	a template's author nickname
is full site template	integer (1/0) 1-true	1 for Full Site templates
is Real Size	integer (1/0) 1-true	1 if "Real Size" screenshot exists
screenshots list	list	the list of all screenshots of this template separated by <delimiter>, started with <list_begin> and ended with <list_end>. Full URL is displayed.
keywords list	list	a list of all keywords associated with the template separated by<delimiter> starting with <list_begin> and ending with <list_end>.
categories list (Identifiers)	list	a list of all category identifiers of this template separated by <delimiter> starting with <list_begin> and ending with <list_end>.
categories list (names)	list	a list of all category names of this template separated by <delimiter> starting with <list_begin> and ending with <list_end>.
sources	string	information about sources available for this template starting with <list_begin> and ending with <list_end>.
type	string	a type of the template starting with <list_begin> and ending with <list_end>.
description	string	a description of this template starting with <list_begin> and ending with <list_end>.
pages	list	a list of all pages of this template starting with <list_begin> and ending with <list_end>. Each page consists of the page name (starting with <list_begin> and ending with <list_end>) and the list of screenshots (starting with <list_begin> and ending with <list_end>). Each screenshot consists of the screenshot name (starting with <list_begin> and ending with <list_end>) and the screenshot URL (starting with <list_begin> and ending with <list_end>). Full URL is displayed.

Response example:

http://www.templatemonster.com/webapi/template_info2.php?delim=|&template_number=9005&list_delim=;&list_begin=[&list_end=]

9005|174|6960|2005-08-11|6|0|0|0|0|0|0|0|150|Monet|0|1|[http://images.templatemonster.com/screenshots/9000/9005-banner.jpg; http://images.templatemonster.com/screenshots/9000/9005-html.html;http://images.templatemonster.com/screenshots/9000/9005-m.jpg; http://images.templatemonster.com/screenshots/9000/9005-osc-b.jpg; http://images.templatemonster.com/screenshots/9000/9005-rs.jpg]| [shop;hardware;accessory;broadband;laptop;notebook;changer;stereo;system;player;computer;camera;phone;mobile;cellular;cable;CD;DVD; CD-RW;desktop;printer;Xerox;HP;monitor;barebone;mice;input;device;memory;server;wireless;MP3;player]|[42;50;63;83;84]|[Online store/shop;Electronics;Clean style;Most Popular;osCommerce Templates]|[ .PSD; .PHP]|[OS commerce 2.2]|[OsCommerce Templates are ready made solutions to use for on-line shops. OsCommerce Template is actually a combination of osCommerce 2.2 (ready made on-line shop) provided by osCommerce.com and the original osCommerce design. ]|[[[Homepage][[REAL SIZE SCREENSHOT][http://images.templatemonster.com/screenshots/9000/9005-rs.jpg]] [[][http://images.templatemonster.com/screenshots/9000/9005-html.html]] [[OSCommerce Main Page preview][http://images.templatemonster.com/screenshots/9000/9005-osc-b.jpg]]]]|

1.11. currency.php

URL:

http://www.templatemonster.com/webapi/currency.php

Description:

Returns a table of currency exchange rates.

Status:

0.1

Synopsis:

http://www.templatemonster.com/webapi/currency.php?[linebreak=<linebreak>][&delim=<delimiter>]

Parameters:

Parameter	Type	Description
linebreak	string	a sequence of characters used to separate the lines (default: \r\n)
delim	string	a sequence of characters used to separate the columns (default: \t)

Response:

Response is a plain text table delimited with <delimiter>. The table contains information about currency exchange rates. It consists of the following columns (without columns headers):

Column	Type
id of the currency	integer
name of the currency	string
exchange rate of the currency	float

Response example:

http://www.templatemonster.com/webapi/currency.php?delim=|

1|EUR|0.882503
2|CAD|1.21932
3|GBP|0.609381
4|JPY|127.203
5|AUD|1.4079

Prev	Up	Next
Chapter 1. Basic concepts	Home	2. Obtaining Screenshots.