The FanFeedr API provides a simple RESTful interface with lightweight JSON or XML formatted responses to use many of the FanFeedr website's features, including blog posts, player tweets, articles from local newspapers and videos, and much more. This document provides information to developers on how to integrate with the FanFeedr API.
Concepts
HTTP Requests
The FanFeedr API uses a RESTful calling style that works with standard HTTP GET calls. Any web programming language (PHP, Ruby, Perl, Python, Java...) should be able to make and receive HTTP networking calls.
Tiering
The FanFeedr API is also tier-based. This allows the FanFeedr API to be more flexible for developer needs. There are four tiers currently available:
Basic (Free)
Gold ($250/month)
Platinum ($1,220/month)
Unlimited ($10,000/month)
When you register for a developer account and create a new application, you will automatically have a Basic tier key issued and can get up and running in just a few minutes.
For more detailled information and a list of features for each tier, please see Plans & Pricing.
Rate Limiting
Rate limits vary by tier.
Basic (100 queries/hour)
Gold (250 queries/hour)
Platinum (2,500 queries/hour)
Unlimited (unlimited queries/hour)
You will receive an automated email when you approach a limit. If your application needs more than the allotted amount of calls, contact us at info@fanfeedr.com with a description of the application and an estimate on call usage. We're more than happy to work with you to establish a setup that works best for your application. If you find you are running into query limits often, you may want to investigate using caching in your application to keep the number of calls to a minimum, and make your application faster.
URL Structure
The basic URL structure is: http://api.fanfeedr.com/basic/{method}?format={json|xml}&{method_params...}&appId=<your-api-key>
API Methods
suggest
This call provides typeahead suggestion for entity resource lookups, ie for the query red you recieve path and resource info for the Red Sox, Chris Redman, and Detriot Red Wings.
Provides a news feed based on teams found near a given geo location. This is particulary useful if you have access to geolocation data from ip lookups or from an iPhone app.
strict, severe (severe indicates that only articles in which the entity specified is without doubt the most prominent entity will be returned. This DRASTICALLY reduces results)
content_type
N
all
video, articles, all
appid
Y
(developer's appid)
source
N
Origin/Source resource in which results will be limited to.
clean
N
false
true, false (indicates whether internal tagging should be removed from headlines and summaries)
Example
http://api.fanfeedr.com/basic/resource_feed?resource=team://mlb/ny_yankees&format=json&filter=by-hotness&date=all-time&type=news&source=origin://espn&clean=true&appid={YOUR BASIC APP ID CHANGE THE "BASIC" TO YOUR LEVEL OF SERVICE IF YOU ARE NOT A BASIC USER}
0 Comments
Please sign in to post a comment.