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 &amp; 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 &amp; 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