Social Mention API DocumentationSocial Mention provides an API for developers query for social media search results in several different formats. Search APIThe search API provides a single stream of real-time search data aggregated from numerous social media properties. It is available in several formats. Base URL prefix: http://socialmention.com/search REST Parameters: | Parameter | Description | | q | url encoded query terms (can include exception ex: "iphone apps -blackberry") | | f | response format (json, rss, php, csv) | | t | single search type (blogs, microblogs, bookmarks, comments, events, images, news, videos, audio, questions, networks, all) | | t[] | multiple search types (ex: http://socialmention.com/search?q=iphone&t[]=blogs&t[]=microblogs) | | src[] | specific social media sources (ex: http://socialmention.com/search?q=iphone&src[]=twitter&t[]=youtube) | | lang | (optional) 2 letter ISO 639-1 language code (if null - source default language will be returned | | l | location string (city and state/province). Required if search type is "events" | | callback | (optional) required for JSONP compatible requests | | key | (optional) required for commercial requests |
Example: http://socialmention.com/search?q=iphone+apps&f=json&t=microblogs&lang=fr Response PropertiesThe search API will return the following properties for JSON and PHP response formats. Not all meta data is available for every item. - count - number of items
- items (array)
- title
- description
- link
- timestamp
- image - story or item image
- embed - video embed script
- user - author's username
- user_image - author's profile image
- user_link - author's profile url
- domain - the original source's domain
- source - the original source's name
- favicon - the original source's favicon
- type - mention type, ie: blogs, microblogs, comments etc.
|
