Deprecated Documentation

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.

Method Name suggest

HTTP Method GET

Parameters

Name	Required	Default	Type
`q`	`Y`		`string`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/suggest?appid=<your-API-key>&format=json"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

all_scores

A news feed of all the most recent scores for all teams.

Method Name all_scores

HTTP Method GET

Parameters

Name	Required	Default	Type
`start`	`N`	`0`	`int`
`rows`	`N`	`20`	`int`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/all_scores?appid=&format=json"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

scores

Call to return the scores for a given league resource.

Method Name scores

HTTP Method GET

Parameters

Name	Required	Default	Type
`resource`	`Y`		`Team or League Resource`
`start`	`N`	`0`	`int`
`rows`	`N`	`20`	`int`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/scores?appid=&format=json&resource=team://nfl/pittsburgh_steelers"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

geo_feed

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.

Method Name geo_feed

HTTP Method GET

Parameters

Name	Required	Default	Type
`start`	`N`	`0`	`int`
`rows`	`N`	`20`	`int`
`lat`	`N`		`decimal`
`long`	`N`		`decimal`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/geo_feed?appid=&format=json"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

search

Provides a news feed for a given query string.

Method Name search

HTTP Method GET

Parameters

Name	Required	Default	Type
`q`	`Y`		`string`
`start`	`N`	`0`	`int`
`rows`	`N`	`20`	`int`
`filter`	`N`	`search`	`ApiSearchSort`
`date`	`N`	`all-time`	`ApiDateFilter`
`content_type`	`N`	`all`	`ApiContentTypeFilter`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/search?appid=&format=json&q=steelers"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

article

Provides formatted article text for a given article resource

Method Name article

HTTP Method GET

Parameters

Name	Required	Default	Type
`resource`	`Y`		`A recap or ss_story Article resource`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/article?appid=&format=json&resource=article://nhl/tuesdays_recaps/2009/06/02/gonchar_leads_confident_pens_past_wings_pittsburgh_4_detroit_2"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

recap

Gets the recap of an event

Method Name recap

HTTP Method GET

Parameters

Name Required Default Type

resource

Y

Event Resource

using the scores call

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/recap?appid=&format=json&resource=event://20091130nhl--nyrangers-0"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

boxscore

Gets the boxscore of an event

Method Name boxscore

HTTP Method GET

Parameters

Name Required Default Type

resource

Y

Event Resource

using the scores call

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/boxscore?appid=&format=json&resource=event://20091130nhl--nyrangers-0"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

schedule

Gets the schedule for a team resource.

Method Name schedule

HTTP Method GET

Parameters

Name	Required	Default	Type
`resource`	`Y`		`Team Resource`

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/schedule?appid=&format=json&resource=team://nhl/detroit_red_wings"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

resource_feed

Gets a list of articles for a resource

Method Name resource_feed

HTTP Method GET

Parameters

Name	Required	Default	Type
`resource`	`Y`		`Resource`
filter	N	newest	by-hotness most-views, fewest-views most-comments highest-rated lowest-rated, newest
type	N	all	all, blogs, videos, twitter, image, news, recruiting, updates, columnists, fantasy
date	N	all-time	all-time, last-hour, today, yesterday, week, month, year, last24
strictness	N	strict	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}

View Example Code

<?php

    $url = "http://api.fanfeedr.com/basic/resource_feed?appid=&format=json&resource=team://nfl/pittsburgh_steelers"
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response_body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if (intval($status) != 200) die("Error: $response_body");
    var_dump(json_decode($response_body));
?>

version 44 as of 5 months ago by Benn

0 Comments

Please sign in to post a comment.

Deprecated Documentation

Concepts

HTTP Requests

Tiering

Rate Limiting

URL Structure

API Methods

suggest

all_scores

scores

geo_feed

search

article

recap

boxscore

schedule

resource_feed

0 Comments

Docs Navigation