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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate lines (default: \r\n)
delimstringa sequence of characters used to separate columns (default: \t)
fromintegera starting template number (inclusive, default: 1)
tointegeran ending template number (inclusive, default: a maximum item number available)
last_added=YesstringTemplates from the last 'new templates report' will be listed only if this parameter exists and has a nonzero length.
sold=YesstringSold and permanently removed from TemplateMonster templates will be listed only if this parameter exists and has a nonzero length.
filterintegerIf 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.

keywordsstringA 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.
categoryintegerIf 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_bystringIf 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 )stringThe default order is ascending. Acceptable values:
  • asc - ascending order

  • desc - descending order

list_delimstringa sequence of characters used to separate list items (default: , )
list_beginstringa sequence of characters used to mark the beginning of the list (default: { )
list_endstringa sequence of characters used to mark the end of the list (default: } )
full_pathstringif this parameter exists and its value is 'true' a full path to screenshots is returned.
currency3 charsIf 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):

ColumnTypeDescription
idintegeran item number of the template
priceintegera regular price of the template
exclusive priceintegeran exclusive price of the template
date of additiondatethe date when the template was added to the database in YYYY-MM-DD format
number of downloadsintegerthe number of downloads
is hostinginteger (1/0) 1-trueequals 1 for Hosting Website templates
is flashinteger (1/0) 1-trueequals 1 for Flash Intro templates
is adultinteger (1/0) 1-trueequals 1 for Adult templates
is unique logointeger (1/0) 1-trueequals 1 for unique Logo templates
is non unique logointeger (1/0) 1-trueequals 1 for non-unique Logo templates
is unique corporateinteger (1/0) 1-trueequals 1 for unique Corporate Identity Packages
is non unique corporateinteger (1/0) 1-trueequals 1 for non-unique Corporate Identity Packages
author's IDintegera template's author identifier
is full site templateinteger (1/0) 1-trueequals 1 for Full Site templates
number of pagesintegerthe number of subpages (some templates are not full site templates but still contain several subpages).
screenshots listlista 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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
fromintegeran item number of the first template (inclusive, default: 1)
tointegeran 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):

ColumnType
idinteger
sourcesstring

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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
fromintegeran item number of the first template (inclusive, default: 1)
tointegeran 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):

ColumnType
idinteger
keywordsa 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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa 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):

ColumnType
author's IDinteger
author's nicknamestring

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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
localestring2 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):

ColumnType
id of categoryinteger
name of categorystring

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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa 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):

ColumnType
id of styleinteger
name of stylestring

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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
fromintegeran item number of the first template (inclusive, default: 1)
tointegeran 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):

ColumnType
id of templateinteger
id of categoryinteger

Response example:

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

9005|42
9005|50
9005|63
9005|83
9005|84
9006|42
9006|50
9006|63
9006|83
9006|84
9007|40
9007|66
9007|68
9008|27
9008|68

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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
fromintegeran item number of the first template (inclusive, default: 1)
tointegeran 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):

ColumnType
id of templateinteger
id of styleinteger

Response example:

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

9002|5
9003|2
9003|5
9003|16
9004|16
9005|4
9005|16
9006|4
9007|5
9007|9
9008|16

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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
typestringa 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_info3.php

URL:

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

Description:

Returns the info about the selected template.

Status:

0.2

Synopsis:

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

Parameters:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa sequence of characters used to separate the columns (default: \t)
template_numberintegeran item number of the template (default: 1)
list_delimstringa sequence of characters used to separate list items (default: , )
list_beginstringa sequence of characters used to mark the beginning of the list (default: { )
list_endstringa 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):

ColumnTypeDescription
idintegeran item number of the template
priceintegera template price (in USD)
exclusive priceintegeran exclusive price of the template (in USD)
date of additiondatedate of addition in YYYY-MM-DD format
number of downloadsintegerthe number of downloads
is hostinginteger (1/0) 1-true1 for Hosting Website templates
is flashinteger (1/0) 1-true1 for Flash Intro templates
is adultinteger (1/0) 1-true1 for Adult templates
is unique logointeger (1/0) 1-true1 for unique Logo templates
is non unique logointeger (1/0) 1-true1 for non-unique Logo templates
is unique corporateinteger (1/0) 1-true1 for unique Corporate Identity Packages
is non unique corporateinteger (1/0) 1-true1 for non-unique Corporate Identity Packages
author's IDintegera template's author identifier
author's nickstringa template's author nickname
is full site templateinteger (1/0) 1-true1 for Full Site templates
is Real Sizeinteger (1/0) 1-true1 if "Real Size" screenshot exists
screenshots listlistthe list of all screenshots of this template separated by <delimiter>, started with <list_begin> and ended with <list_end>. Full URL is displayed.
keywords listlista list of all keywords associated with the template separated by<delimiter> starting with <list_begin> and ending with <list_end>.
categories list (Identifiers)lista list of all category identifiers of this template separated by <delimiter> starting with <list_begin> and ending with <list_end>.
categories list (names)lista list of all category names of this template separated by <delimiter> starting with <list_begin> and ending with <list_end>.
sourcesstringinformation about sources available for this template starting with <list_begin> and ending with <list_end>.
typestringa type of the template starting with <list_begin> and ending with <list_end>.
descriptionstringa description of this template starting with <list_begin> and ending with <list_end>.
pageslista 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_info3.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:

ParameterTypeDescription
linebreakstringa sequence of characters used to separate the lines (default: \r\n)
delimstringa 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):

ColumnType
id of the currencyinteger
name of the currencystring
exchange rate of the currencyfloat

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