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.