| Mefeedia has over 5 million monthly users searching across over 10 million videos found on over 15 thousand media sites. Our search is now available to publishers of all sizes looking for a powerful free tool that is easy to implement and tailored to their content. |
| Get started: |
Log in or register for a free mefeedia account to get your PARTNERID. |
| |
|
| Manage feeds: |
While logged in, add any media RSS feeds that you want to search across. These feeds can be published from your site or any site of your choosing. You may also search across over 40 thousand feeds we are currently indexing to find more relevant content for your sites audience. |
| |
|
| Request: |
Submit all searches to our API Request URL: http://mefeedia.com/query.php?partner=PARTNERID.
Example:
http://mefeedia.com/query.php?q=humor&partner=120581&api=xml
| Format your requests by appending the following to our API url |
Param |
Value |
Description |
Example |
| api |
xml |
Response is a XML response to be interpreted by your choosing. |
&api=xml |
| api |
iframe |
Returns HTML response convenient for placing in an iframe. Example |
&api=iframe |
| |
|
|
|
| q |
|
Search terms. Supports quoted keyword grouping and boolean (AND OR) search terms. Empty queries will produce results with newest entries first. |
&q=baseball |
| |
|
|
|
| feed |
|
Optional: Specifying a feed title will narrow results to only that feed (or the closes title match) |
&feed=cardinals+videos |
| |
|
|
|
| date_end |
|
Optional: Latest publish date for the results. mm/dd/yy format. |
&date_end=05/15/08 |
| date_start |
|
Optional: Earliest publish date for the results. mm/dd/yy format that is older that the date_end. Defaults to 2004. |
&date_start=04/15/08 |
|
| |
|
| Response: |
Our XML response (example) consists of 2 nodes: <response> and <results>
<response> |
Param |
Description |
| query |
Keywords submitted. Sometimes different that the q parameter if special characters are removed. |
| time |
Time results are generated. Mefeedia sometimes will cache results so this time may be different that the actual request time. |
| total |
Total number of items available in the search result. |
| from |
Result number of the first result. |
| to |
Result number of the highest result on this page. Typically 20 more that from. |
| related_keywords |
List of possible related search terms compiled from analyzing the result set. |
| partner |
Your PARTNERID |
| is_adult |
If your search appears to contain adult content or is requesting adult content. |
| page |
Page of current result set |
| error |
Error reporting. Results may not appear. |
<results> |
Param |
Description |
| number |
Result number relative to all results available. |
| url |
Url to the permalink from the feed. |
| title* |
Entry title. |
| feed_title* |
Title of the source RSS feed the entry was located in. |
| media |
URL of the media . |
| tags |
Comma separated available tag list for this entry. Common tags such as "video" may be omitted. |
| feed_img |
Available image for the source feed. |
| description* |
Text description of the entry. |
| publishdate |
Date the entry was published. |
| thumb |
Available image for the entry. To maintain integrity of our result presentation, most images are cached to images.mefeedia.com. |
| *Text may have html and special characters omitted. Text is usually shortened to 256 characters. |
|
| |
|
| Formatting: |
Although all the data presented by our results should be sufficient to present a basic search page on your site, some publisher may want to include more information. When searching across only your feeds, mapping our results to your internal data set could allow you add more images or text or comments. |
| |
|
| Code Sample |
A very simple PHP request and response handling example is available here. |
| Feedback: |
Questions, bug reports, feature requests and general feedback are encouraged and could be be sent to paul at mefeedia dot com. |
