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;
?>
