Submit a site ($10) RSS



API

CSSMania’s API is a never ending developed API, and could change depending on our readers interests. Depending on our readers response we will continue working on future releases to parse more data in case it is needed.

HTTP methods & Character Encoding

CSSMania’s API only allows GET method. Encoding is delivered in UTF-8 format.

Rate Limit & Time Stamps

We currently do not have any rate limit, but we will keep an eye on possible bad API usage and limit in the near future. We may also ban your IP from our server. So, be advised. (yes, it is a lifetime ban to the apache server, so… no jokes).

Time Stamps are delivered in format YYYY-MM-DD HH:mm:ss

API Keys & Formats

To use CSSMania’s API there is no need for an API Key. In case you are going to use CSSMania’s screenshots stored on our server, we most likely will need to give you access to them as the hotlinking is limited to certain domains up to date. Just contact us if you have doubts or need some assistance.

CSSMania’s API supports JSON only.

API Usage

Format: http://cssmania.com/api/api.php?search=xxxxxxxxxxxxx

Minimum length on the query must be 7 characters.

The output will be JSON with this data :

Example 1:
http://www.cssmania.com/api/api.php?search=authentic

[{"id":"5865","url":"http:\/\/www.authenticjobs.com\/","developed":"Cameron Moll",
 "developed_url":"http:\/\/www.cameronmoll.com\/","country":"U.S","rating":"5",
"totalscore":"104","numbervotes":"20","colours_0":"f0f0e0","colours_1":"e0e0e0",
"colours_2":602000,"colours_3":600000,"colours_4":"f0e0e0",
"url_screenshot":"http:\/\/cssmania.com\/screenshots\/authenticjobscom",
"time_created":"2006-09-28 14:05:38", "last_screenshot_version":"2006-09-28 14:14:22"},
{"id":"9979","url":"http:\/\/www.authenticstyle.co.uk\/","developed":"William Smith",
"developed_url":"http:\/\/www.authenticstyle.co.uk\/","country":"United Kingdom",
"rating":"6","totalscore":"56","numbervotes":"9","colours_0":202000,"colours_1":200000,
"colours_2":202020,"colours_3":"000000","colours_4":606060,
"url_screenshot":"http:\/\/cssmania.com\/screenshots\/authenticstylecouk_fav",
"time_created":"2008-04-20 19:20:58",
"last_screenshot_version":"2008-04-20 19:21:17"}]

id = Screenshot ID ( for future releases)

url = Screenshot URL

developed = Screenshot Developer

country = Developer Country

rating = Actual Rating

totalscore = Summatory of Votes

numbervotes = Number of Votes

colours_0 … 5 = Top 5 colours used on the design (in HEX)

url_screenshot = URL to the screenshot on our servers (please read above the API Key section).

time_created = First time screenshot seen onto CSSMania.com

last_screenshot_version = Last time screenhot updated onto CSSMania.com

Example 2:
http://www.cssmania.com/api/api.php?search=apple.com

[{"id":"8806","url":"http:\/\/www.apple.com\/","developed":"Apple Crew",
"developed_url":"http:\/\/www.apple.com\/","country":"U.S","rating":"6",
"totalscore":"288","numbervotes":"43","colours_0":"000000", "colours_1":202020,
"colours_2":404040,"colours_3":808080,"colours_4":"a0a0a0",
 "url_screenshot":"http:\/\/cssmania.com\/screenshots\/applecom",
"time_created":"2007-06-12 23:08:20","last_screenshot_version":"2007-06-14 21:31:38"}]

id = Screenshot ID ( for future releases)

url = Screenshot URL

developed = Screenshot Developer

country = Developer Country

rating = Actual Rating

totalscore = Summatory of Votes

numbervotes = Number of Votes

colours_0 … 5 = Top 5 colours used on the design (in HEX)

url_screenshot = URL to the screenshot on our servers (please read above the API Key section).

time_created = First time screenshot seen onto CSSMania.com

last_screenshot_version = Last time screenhot updated onto CSSMania.com

HTTP Status Codes

200 OK: Everything fine.

304 Not Modified: No new data to return.

400 Bad Request: Invalid Request.

404 Not Found: Resource not found.

500 Internal Server Error: Something is wrong with our server

503 Service Unavailable: CSSMania is overloaded. Try later.




WordPress RSS Top

CSSMania, 2014 · Inspiring you since 2004. About · Contact · Legal · Blog