WhosTalkin API

Example URL:

http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4

Format:

RSS 2.0 (example responce)

HTTP Method:

GET

Authentication:

API key required

Parameters:

Required

Parameter Example Discription
q http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4 The query is a required parameter that contains the search term or keyword.
key http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4 The key is a required parameter that contains the client's API key.

Filters

Parameter Example Discription
urlfilter1 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&urlfilter1=blogspot One of three URL filters. Will filter out all URLs containing string. String must be encoded.
urlfilter2 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&urlfilter1=blogspot&urlfilter2=twitter One of three URL filters. Will filter out all URLs containing string. String must be encoded.
urlfilter3 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&urlfilter1=blogspot&urlfilter2=twitter&urlfilter3=livejournal One of three URL filters. Will filter out all URLs containing string. String must be encoded.
titlefilter1 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&titlefilter1=viagra One of three title filters. Will filter out all entries who's titles contain string. String must be encoded.
titlefilter2 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&titlefilter1=blogspot&titlefilter2=porn One of three title filters. Will filter out all entries who's titles contain string. String must be encoded.
titlefilter3 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&titlefilter1=blogspot&titlefilter2=twitter&titlefilter3=acai+berry One of three title filters. Will filter out all entries who's titles contain string. String must be encoded.

Sources

With the source parameters you can define the sources of the results. You can use up to three sources per request. Source attributes can be found below. If sources are not defined results will come from WhosTalkin's default results.

Parameter Example Discription
source1 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&source1=twitter One of three source parameters. When defined results will come from designated source.
source2 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&source1=twitter&source2=wordpresscom One of three source parameters. When defined results will come from designated source.
source3 http://api.whostalkin.com/search?q=cats&key=d963ba347735ac1f5662a0269fa2beb4&source1=twitter&source2=wordpresscom&source3=myspaceblogs One of three source parameters. When defined results will come from designated source.

Source Attributes

API Attribute Source
myspaceblogs Myspace Blogs
plurk plurk
friendfeed FriendFeed
omgili Omgili
backtype BackType
icerocket IceRocket
google Google Blog Search
twitter Twitter
wordpresscom WordPress.com
plazoo Plazoo
identica Identi.ca
indianpad IndianPad
ning Ning
xanga Xanga
netlog Netlog
lastfm Last.fm
linkedin LinkedIn
hi5 hi5
friendster Friendster
bebo bebo
facebook Facebook
myspace MySpace
yahoonews Yahoo News
googlenews Google News
bbc BCC News
topix Topix
newspad NewsPad
itn ITN
techmeme TechMeme
microsoft Bing News
asknews Ask News
youtube YouTube
yahoovideo Yahoo Video
metacafe MetaCafe
vimeo Vimeo
blinkx Blinkx
blip Blip.tv
dailymotion DailyMotion
viddler Viddler
picasa Picasa
flickr Flickr
yahooimage Yahoo Image Search
photobucket PhotoBucket
fortki Fotki
smugmug SmugMug
deviant DeviantArt
boardreader BoardReader
boardtracker BoardTracker
metafilter MetaFilter
delicious Delicious
blogmarks BlogMarks
bluedot Faves
reddit reddit
newsvines newsvine
jumptags jumptags
wordpresstag WordPress.com Tags

Examples:

PHP/cURL

<?php
$q = urlencode($_GET['q']);
$key = $_GET['key'];
$url = "http://api.whostalkin.com/search?q=".$q."&key=".$key;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$responce = curl_exec($ch);
curl_close($ch);
echo $responce;
?>