minmagnet is friendly and likes to work with other web sites and applications. Use this form to configure the content stream you'd like to see and select an output file or data format. You may also want to consider translating your query topic first.

If you'd like to programmatically construct the URL in your own software:

The base URL for the minmagnet API service is http://api.minmag.net/index.php

The following additional parameters can be used to control the content. Bold type in the following paragraphs denotes specific words which could appear in the request URL as either a key or a value.

topic specifies the string to be aggregated, which can be any valid Unicode string.

Sources can be switched on and off individually in order to return the desired content types -- news, blogs, social networking posts, videos, images, and shopping. Set the value for any desired content types to the string value on (not simply a binary 1 or 0 nor a Boolean true or false). The content type all can be set to the string value on in order to return all content types; this is also the default if no content types are specified in your API request.

output specifies a data or other format to be returned. Setting this value to html returns an easily-readable dump of minmagnet's internal PHP associative array as rendered by the print_r() function. Setting this value to json returns a JavaScript object suitable for use in most languages, and setting it to xml returns a simple XML document. Setting it to feed returns an RSS2.0 XML document, the well-formedness of which can sometimes be compromised by the aggregated feed content. Selecting php returns a long string that corresponds to the output of the original internal associative array as rendered by PHP's serialize() function. text is a simple text dump of every key and its value for all collected items, delimited by a set of asterisks (*****) -- this is the data output format that's easiest for most people to read, but if your primary concern is human readability rather than machine readability then you should probably consider using one of our visualizations instead of the data API.

Each individual collected item in the minmagnet output contains a set of item-specific properties -- the author, the date it was posted, and so forth. These item properties are normalized by minmagnet no matter where they came from, which means that you can sort all items in the output set by any of these properties -- just specify sort=[property] in your request. Not all items contain all properties -- Twitter posts don't contain a value corresponding to Facebook "Likes," for example. Items that do not contain the value you used for sorting will be sorted to the end of the content set. For a list of all available item sub-property names from the current collected content set, view the output=html version of your query.

The minmagnet API will not change the sort order or direction for you, so for example you can't sort by name both from A to Z and then also from Z to A. Instead, you should reverse the order of the feed or array in the receiving script or application.

For example, consider the following URL:

This would collect videos and social networking posts that mention the word "Radiohead," sort them according to the author's name, and output the results as an XML document.