Mihalism Web Search Protocol
Mihalism Web Search allows you to search the Internet for web pages.
Mihalism, Inc. has developed a simple GET-based protocol for serving search results.
Search administrators have complete control over how search results are requested and
presented to the end user. This document describes the technical details of the search
request and results formats. It assumes that the reader has basic understanding
of web development.
For the free pre-built search engine that uses this protocol, click here
to view its page.
Request URL
http://xml.mihalismsearch.com/
Request Parameters
If you are running the Mihalism Web Search pre-built search engine, then you need to edit the file
/source/data.php in order to add these parameters to the search.
| Parameter |
Value |
Description |
| query |
string (required) |
The query to search for. |
| page |
integer: default 0 |
The starting result position. The finishing position (page + 10) cannot exceed 1000. |
| language |
string: default no value (all languages) |
The language the results are written in. Supported Languages. |
| site |
string: default no value (all sites) |
A single domain to restrict your searches to (e.g. www.mihalismsearch.com). |
Response Errors
Below is a list of the various error code responses you might see when making a query request. If there is a problem serving your request, you'll receive a response with an error code and an error message.
| Code |
Message |
| 1 |
Empty query |
| 2 |
Your page parameter exceeds 1000. We provide only the 1000 most relevant search results for a query. |
| 3 |
Invalid page parameter (e.g. using "one" instead of 1). |
| 4 |
No results found |
Response Fields
Mihalism Web Search responds to queries with a set of results in XML format. Below is an easy to understand description of the layout of the XML file.
| Field |
Description |
| searchresult |
Root element |
| properties |
Contains information related to the requested query. |
| resultset |
Contains the results of the requested query. |
| properties:query |
The requested query. |
| properties:page |
The current page of the requested query. |
| properties:timestamp |
The time that the query was requested. |
| properties:tracking_id |
The tracking_id element is used by us to track the requested query. |
| properties:first_result |
The numerical value of the first result to be shown. |
| properties:last_result |
The numerical value of the last result to be shown. |
| properties:speller |
Contains spelling suggestions when needed. |
| resultset attr:total |
The total results to be shown. The total results are an estimation. |
| resultset attr:real_total |
The total results in a user friendly manner. (e.g. instead of 1054646 it will show 1,054,646) |
| resultset attr:real_results |
See resultset attr:real_total |
| resultset:search_suggestions |
Contains related searches. |
| resultset:search_ideas |
Child of resultset:search_suggestions and contains a single related search. |
| resultset:results |
Contains the actual web page results. |
| resultset:results:title |
The page title of the selected result. |
| resultset:results:desc |
The page description of the selected result. |
| resultset:results:url |
The page URL of the selected result. |
| resultset:results:redirecturl |
See resultset:results:url. |
| resultset:results:captionurl |
Contains a shorter version of the actual page URL. |
| resultset:results:language |
The page language of the selected result. Supported Languages. |
Sample Response
The following is a sample response for the query monkey:
<?xml version="1.0" encoding="UTF-8"?>
<searchresult protocol_version="1.4" protocol="http://xml.mihalismsearch.com/protocol.php">
<properties>
<query>monkey</query>
<page>0</page>
<timestamp>1210363371</timestamp>
<tracking_id>6a0b62eebf9010d5eaef8c7cd6b38f25</tracking_id>
<first_result>1</first_result>
<last_result>10</last_result>
<speller></speller>
</properties>
<resultset total="88200000" real_total="88,200,000" real_results="88,200,000">
<search_suggestions>
<search_ideas>Monkey Pictures</search_ideas>
<search_ideas>Funny Monkey Pictures</search_ideas>
<search_ideas>Baby Monkey Pictures</search_ideas>
<search_ideas>Yahoo</search_ideas>
<search_ideas>Monkey Games</search_ideas>
<search_ideas>Monkeys For Sale</search_ideas>
<search_ideas>Crazy Monkey Games</search_ideas>
<search_ideas>Play Crazy Monkey Games</search_ideas>
</search_suggestions>
<results>
<title>Monkey - Wikipedia, the free encyclopedia</title>
<desc>A monkey is any member of either the New World monkeys or Old World monkeys , two of the three groupings of simian primates , the third group being the apes</desc>
<url>http://en.wikipedia.org/wiki/Monkey</url>
<redirecturl>http://en.wikipedia.org/wiki/Monkey</redirecturl>
<captionurl>en.wikipedia.org/wiki/Monkey</captionurl>
<language>en</language>
</results>
<results>
<title>monkey.org:/</title>
<desc>international house of primates ... 1996-2008 monkey.org inc., all rights reserved. </desc>
<url>http://www.monkey.org/</url>
<redirecturl>http://www.monkey.org/</redirecturl>
<captionurl>www.monkey.org</captionurl>
<language>en</language>
</results>
<results>
<title>monkey.org:/food</title>
<desc>here are some monkey approved ann arbor food holes. most of them deliver. if you find any errors, feel a menu is too out of date, or have a scanned menu or link to contribute ... </desc>
<url>http://www.monkey.org/food/</url>
<redirecturl>http://www.monkey.org/food/</redirecturl>
<captionurl>www.monkey.org/food</captionurl>
<language>en</language>
</results>
<results>
<title>monkey - Definitions from Dictionary.com</title>
<desc>Definitions of monkey at Dictionary.com. ... Facts About Monkeys Get better answers and references on Ask.com. Use Ask.com now!</desc>
<url>http://dictionary.reference.com/search?q=monkey</url>
<redirecturl>http://dictionary.reference.com/search?q=monkey</redirecturl>
<captionurl>dictionary.reference.com/search?q=monkey</captionurl>
<language>en</language>
</results>
<results>
<title>Infinite Monkeys & Company </title>
<desc>Designs, develops, and markets an eclectic mix of software development tools, software testing tools, and network security tools.</desc>
<url>http://www.monkeys.com/</url>
<redirecturl>http://www.monkeys.com/</redirecturl>
<captionurl>www.monkeys.com</captionurl>
<language>en</language>
</results>
<results>
<title>Monkey, Monkeys, Monkey Pictures at LiveScience.com</title>
<desc>LiveScience.com explains monkey, monkeys, monkey pictures, monkey picture and jungle monkey. All About Monkeys. One of most recognizable animals in the world, a monkey is a long ... </desc>
<url>http://www.livescience.com/monkeys/</url>
<redirecturl>http://www.livescience.com/monkeys/</redirecturl>
<captionurl>www.livescience.com/monkeys</captionurl>
<language>en</language>
</results>
<results>
<title>monkey.com.au- free australian classifieds</title>
<desc>The Australian classifieds where you can place an unlimited number of FREE listings. All FREE listings include a colour photograph. There are no joining or listing fees & no ... </desc>
<url>http://www.monkey.com.au/</url>
<redirecturl>http://www.monkey.com.au/</redirecturl>
<captionurl>www.monkey.com.au</captionurl>
<language>en</language>
</results>
<results>
<title>Welcome to MONKEYmedia - Text Only</title>
<desc> ... version (both versions require a javascript- and frames-capable browser). 611 South Congress Avenue Austin, Texas 78704 USA +1 (512) 440-8000 voice +1 (512) 440-1050 fax info1@monkey ... </desc>
<url>http://www.monkey.com/</url>
<redirecturl>http://www.monkey.com/</redirecturl>
<captionurl>www.monkey.com</captionurl>
<language>en</language>
</results>
<results>
<title>The Primates: Monkeys</title>
<desc>Monkeys. There are at least 145 living species of the suborder Anthropoidea . Over 90% of them are monkeys. The remaining species are apes and humans.</desc>
<url>http://anthro.palomar.edu/primate/prim_4.htm</url>
<redirecturl>http://anthro.palomar.edu/primate/prim_4.htm</redirecturl>
<captionurl>anthro.palomar.edu/primate/prim_4.htm</captionurl>
<language>en</language>
</results>
<results>
<title>Monkey Toes</title>
<desc>Monkey-Toes, uniquely hand-painted children's shoes. We are friends for your children's feet! We come in many different shapes and sizes and would love to come live at your house</desc>
<url>http://monkey-toes.com/</url>
<redirecturl>http://monkey-toes.com/</redirecturl>
<captionurl>monkey-toes.com</captionurl>
<language>en</language>
</results>
</resultset>
</searchresult>
Supported Languages
The following language codes are supported in the language parameter requests:
| Code |
Language |
| sq |
Albanian |
| ar |
Arabic |
| bg |
Bulgarian |
| ca |
Catalan |
| zh_chs |
Chinese Simplified |
| zh_cht |
Chinese Traditional |
| hr |
Croatian |
| cs |
Czech |
| da |
Danish |
| nl |
Dutch |
| en |
English |
| et |
Estonian |
| fi |
Finnish |
| fr |
French |
| de |
German |
| el |
Greek |
| he |
Hebrew |
| hu |
Hungarian |
| is |
Icelandic |
| id |
Indonesian |
| it |
Italian |
| ja |
Japanese |
| ko |
Korean |
| lv |
Latvian |
| lt |
Lithuanian |
| ms |
Malay |
| nb |
Norwegian |
| fa |
Persian |
| pl |
Polish |
| pt_br |
Portuguese (Brazil) |
| pt_pt |
Portuguese (Portugal) |
| ro |
Romanian |
| ru |
Russian |
| sr |
Serbian (Cyrillic) |
| sk |
Slovak |
| sl |
Slovenian |
| es |
Spanish |
| sv |
Swedish |
| th |
Thai |
| tr |
Turkish |
| uk |
Ukrainian |
|