Overview

The FanFeedr API allows developers to access aggregated sports content and data.

Our platform contains over 8,000 feeds from mainstream media, blogger, and other sports sources that are categorized in real-time against 55,000 athletes and 4,000 teams. In addition, our API provides access to various data for events and team resources.

The FanFeedr API provides access to:

  • Content: news, blogs, photos, videos for any resource in our system as well as individual content sources
  • Data: schedules, standings, scores, team rosters, game recaps, and boxscores
  • Geolocated content and information
  • Trending entities

The API is a RESTful resource

The FanFeedr API conforms to the design principles of Representational State Transfer (REST).

Methods to retrieve data from the FanFeedr API require a GET request. The API presently supports JSON only.

Each available resource is a collection that contains members. Each member is associated with an UUID, that can be queried to obtain its properties.

Sports resources are divided into an inheritance structure of:

  • leagues
  • divisions
  • conferences
  • teams
  • persons

In order to obtain information about a specific resource, users must query the 'parent' resources.

For example, to get a list of all teams for the NFL, you would call /leagues for the relevant nfl_id. A call for /leagues/{nfl_id}/teams returns the team UUIDs. Calls for each team_id return which detailed member information.

Other resources include:

  • geo
  • events
  • content
  • images
  • sources
  • trending

Parent resources are used to pare down what data is returned by these collections.

For example, to get a list of events currently happening for the NBA, you would call /leagues/{nba_id}/events/live for event UUIDs. Calls for specific event_id return detailed member information.

To learn about the resources, methods, and data available through the FanFeedr API, please review our documentation.

Limits

API usage is rate limited. Premium plans are available for developers that require higher request limits.

Status and support

The status monitor  [Coming Soon] and @FanFeedr API share information about any known issues with the FanFeedr API.

Current defects and priorities can be viewed on our issue tracker. [Coming Soon]

We provide assistance through our API support options.