My favorites | Sign in
Logo
                
Search
for
Updated Nov 15, 2009 by jon.cianciullo
APIDocumentation  

Social Mention API Documentation

Social Mention provides an API for developers query for social media search results in several different formats.

Search API

The 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
qurl 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 Properties

The search API will return the following properties for JSON and PHP response formats. Not all meta data is available for every item.

Hosted by Google Code