• infoIntroduction

    The FanSided API is a custom application augmenting and supporing FanSided's Multisite WordPress Network. Built with Slim, Guzzle and PSR on a standard MVC pattern, the Amazon Aurora-hosted API powers mobile apps and portions of the WordPress front-end using core resources like Sites, Topics and soon Users.

    The API also houses mission-critical systems for FanSided including User Payments, Emails and Topic Taxonomies, as well as supporting applications like Analytics and Internal Ads.

  • view_listResource Index
    RESOURCE ENDPOINTS
    Ads
    2
    RSS
    2
  • vpn_lock Authentication
    Browser Requests

    To test API calls in the browser, get a cookie that will be connected to your API key. This is only required in the live environment.

    Server Requests

    To authenticate requests from a server, set your API key in the request headers as the value for "X-API-KEY".

    Levels of Authentication

    Not every API key is created equal. Keys are provisioned access to the resources they need.

  • contact_phoneContact
    FanSided Technology Team

    [email protected]


dashboard Ads

  • GET
    /ads/mobile-app/ html
    lock_open

    Generates Mobile App Download Prompt, Inheriting Branding and using magic links to App Stores.

    launchExample
    Option Type Description Example Required
    device
    string
    Will be either <pre>ios</pre> or <pre>android</pre> ios YES
    s_id
    int
    Site ID passed from TIME, Inc. AdFactory in FanSided VIP 229 YES
    a_id
    int
    App ID passed from TIME, Inc. AdFactory in FanSided VIP 1 YES
    dark
    string
    Hexidecimal color minus the hex ffb313 YES
    light
    string
    Hexidecimal color minus the hex cd1713 YES
    cat
    string
    Category passed from TIME, Inc. AdFactory in FanSided VIP. May override App ID in logic. Star+Wars NO
  • GET
    /ads/newsletter/ html
    lock_open

    Generates Newsletter Signup Prompt to pass user through to FanSend Signup.

    launchExample
    Option Type Description Example Required
    s_id
    int
    Site ID passed from TIME, Inc. AdFactory in FanSided VIP 229 YES
    cat
    string
    Category passed from TIME, Inc. AdFactory in FanSided VIP Star+Wars NO

rss_feed RSS

  • GET
    /rss/{partner_slug}/ xml
    lock_open

    XML feed of full content posts.

    launchExample
    Option Type Description Example Required
    post_tags
    string
    Tags associated with post. A csv list of tags uses OR condition. {AND} can be used in a single csv entry to enforce and AND condition between two tags. post_tags=arizona+cardinals,arizona+coyotes, post_tags=usc+trojans+{AND}+football NO
    network_id
    int
    The posts associated newtork id. network_id=4 NO
    app_id
    int
    The posts associated app id. app_id=4 NO
    blog_id
    int
    FS Network WordPress blog_id. blog_id=229, blog_id!=229 NO
    post_date_utc
    string
    The publish date of post. post_date_utc>=2016-7-20 00:00:00 NO
    vertical
    string
    FS Network vertical Current verticals - MLB, NFL, NHL, NBA, EXTRA, NCAA, SOCCER, LOCAL, ENTERTAINMENT, NCAABB, NCAAF, TV, LIFESTYLE vertical=nhl,nba NO
    limit
    int
    Limit the amount of posts returned in a single call. limit=10 NO
    page
    int
    Select the page number to return. Changing the limit is allow with the field as long as all calls use the same limit value. page=2, page=2&limit=30 NO
  • GET
    /rss/{partner_slug}/partial/ xml
    lock_open

    XML feed of partial post content. See base /rss/ for options.

    launchExample

    No endpoint options.

  • GET
    /rss/{partner_slug}/json/ json
    lock_open

    JSON feed of partial post content. See base /rss/ for options.

    launchExample

    No endpoint options.

  • GET
    /rss/{partner_slug}/json/partial/ json
    lock_open

    JSON feed of partial post content. See base /rss/ for options.

    launchExample

    No endpoint options.