A View From My Seat API Documentation
Getting Started
Featured Photos
GET featured.php
Provides the most recent featured photos.
Parameters |
Description |
|---|---|
| page | A page number. Default is 1. |
| total | The total number of results. Default is 30. Max is 50. |
Sample API call
Result
([{
"index":"30285",
"image":"CoachShep-20140119144443.jpg",
"member":"CoachShep",
"avatar":"",
"venue":"American Airlines Center",
"section":"333",
"row":"A",
"seat":"15",
"home":"Dallas Mavericks",
"away":"Portland Trail Blazers",
"note":"Mavs get hammered but great seat",
"rating":"4.5",
"width":"1224",
"height":"1632",
"timestamp":"2014-01-19 14:44:43"
},
{...}
)]
1
Local Venues
GET geo.php
Provides a list of local venues within 0.5 degrees of any given geo coordinates.
Parameters |
Description |
|---|---|
| lat | latitude |
| lon | longitude |
Sample API call
Result
([
{"id":"1",
"name":"Citizens Bank Park",
"type":"MLB",
"address":"3501 S. Broad St.",
"city":"Philadelphia",
"state":"Pennsylvania",
"country":"United States",
"team":"Philadelphia Phillies",
"size":"136",
"gps":"39.9059, -75.1665",
"lat":"-75.1665",
"long":"39.9059",
"image":"EventMaster23-20140208175258.jpg"},
{...}
)]
1
Leaders
GET leaders.php
Provides an array of members for leader boards.
Parameters |
Description |
|---|---|
| type | The type of leaderboard results Supported values: "points", "photos", "venues", "cities", "trophies" |
Sample
Result
([
{"image":"hawk-20140127094703.jpg",
"member":"Hawk",
"avatar":"N02.png",
"name":"Hawk",
"points":"141"},
{"image":"ossiesdream-20120101145739.jpg",
"member":"ossiesdream",
"avatar":"soccer.png",
"name":"ossiesdream",
"points":"53"},
{"image":"Hackey-20140105071025.jpg",
"member":"Hackey",
"avatar":"soccer.png",
"name":"Hackey",
"points":"53"},
{...}
)]
1
Leagues
GET leagues.php
Provide all the AVFMS league names within a specific sport or type. European football is grouped under "Soccer".
Parameters |
Description |
|---|---|
| sport | The name of the sport you want photos or information on. Supported values: "Baseball", "Basketball", "Cricket", "Football", "Golf", "Hockey", "Lacrosse", "Race Tracks", "Roller Derby", "Rugby", "Soccer", "Tennis", "Theaters", "Volleyball" |
Sample
Result
([
{"name":"MLB",
"image":"kevinmcalpin-20121001191313.jpg",
"sport":"Baseball"},
{"name":"Minor League Baseball",
"image":"THampton-20120721143655.jpg",
"sport":"Baseball"},
{"name":"Spring Training",
"image":"igtwity-20120327150429.jpg",
"sport":"Baseball"},
{"name":"NPB","image":"fb520046881818-20130311223650.jpg",
"sport":"Baseball"},
{"name":"College Baseball",
"image":"BigOFitz-20120722192404.jpg",
"sport":"Baseball"},
{"name":"Professional Baseball","image":"eoberman-20120722160220.jpg",
"sport":"Baseball"},
{"name":"ABL","image":"ChrisBlackwell-20111222090024.jpg",
"sport":"Baseball"},
{"name":"College Softball",
"image":"lilvicstevens-20120327203513.jpg",
"sport":"Baseball"},
{"name":"LBPPR",
"image":"oscar-20110109143206.jpg",
"sport":"Baseball"},
{"name":"Baseball In Asia",
"image":"anonymous-20110610032319.jpg",
"sport":"Baseball"}
)]
1
Members
GET member.php
Provides public information associated with members. This can be used to return a member's photos.
Member Photos
Parameters |
Description |
|---|---|
| name | The name of the member who's photos will be displayed Example values: "frank", "missy" |
Sample
Result
([
{"index":"30656",
"image":"frank-20140209182856.jpg",
"member":"frank",
"avatar":"20100501220903-5.jpg",
"venue":"Amway Center",
"section":"228",
"row":"1",
"seat":"7",
"home":"Orlando Magic",
"away":"Indiana Pacers",
"note":"There is glass in the first row, but it isn't really in the way. Nice spot.",
"rating":"4.0",
"width":"1632",
"height":"1224",
"timestamp":"2014-02-09 18:28:56",
"favorite":"no"},
{...}
)]
1
Active Members
Shows who the most recently active members are.
Parameters |
Description |
|---|---|
| type | Values: "active" |
Sample
Result
([
{"image":"nofrills-20140217141924.jpg",
"member":"nofrills",
"avatar":"nofrills-IMAG0026.jpg"},
{"image":"augustblind-20140217130921.jpg",
"member":"augustblind","avatar":""},
{"image":"jaezhole-20140217001828.jpg",
"member":"jaez.hole","avatar":""},
{...}
)]
1
Searching For Members
Provides a way to search for member who have shared photos.
Parameters |
Description |
|---|---|
| type | Returns an array of members with this query in their name. Values: "search" |
| q | This is name or partial name that we want to search. Only members who have shared photos will be returned. Example Values: "tom", "phil", "yankie" |
Sample
Result
([
{"image":"stomps-20110125103200.jpg",
"member":"stomps"},
{"image":"tom-20110109143350.jpg",
"member":"tom"},
{"image":"TomHurley-20110716162949.jpg",
"member":"TomHurley"},
{"image":"tominator64-20131125192534.jpg",
"member":"tominator64"},
{"image":"tomjhansen-20110711180329.jpg",
"member":"tomjhansen"},
{...}
)]
1
My Favorite
GET my_favorite.php
Provides a list of a member's favorite venues or photos.
Favorite Venues
Parameters |
Description |
|---|---|
| type | This will return a list of this member's favorite venues. Value: "venue" |
| name | The name of the member. Example Values: "frank", "missy" |
Sample
Result
([
{"image":"anonymous-20140205123441.jpg",
"name":"AT&T Center"},
{"image":"jj3shu-20130522133747.jpg",
"name":"Bright House Field"},
{"image":"jonnyblue22-20140122170611.jpg",
"name":"Busch Stadium"},
{"image":"SUCKAFREE714-20140207014431.jpg",
"name":"Candlestick Park"},
{"image":"wasillakatie-20140215144123.jpg",
"name":"CenturyLink Field"},
{"image":"sipxaz-20140126203840.jpg",
"name":"Chase Field"},
{...}
)]
1
Favorite Photos
Parameters |
Description |
|---|---|
| type | This will return a list of this member's favorite photos. Value: "photos" |
| name | The name of the member. Example Values: "frank", "missy" |
App Sample
Result
([
{"index":"26758",
"image":"mcgettge-20130918085950.jpg",
"member":"mcgettge",
"avatar":"",
"venue":"Lincoln Financial Field",
"section":"201",
"row":"11",
"seat":"1",
"home":"Philadelphia Eagles",
"away":"San Diego Chargers",
"note":"09\/15\/2013",
"rating":"0",
"width":"3264",
"height":"2448",
"timestamp":"2013-09-18 08:59:50",
"photo_type":"football"},
{...}
)]
1
Photo
GET photo.php
Returns information associated with one photo. If a member's name is passed, the variable "favorite" will will let you know if this member has this photo in their favorites.
Parameters |
Description |
|---|---|
| photo_id | The index of the photo you want information on. Example Value: "6501" |
| name | Sets the variable "favorite" to either "yes" or "no". Example Value: "frank" |
Sample
Result
([
{"index":"6501",
"image":"geesnow-20110813232022.jpg",
"member":"geesnow",
"avatar":"",
"venue":"FedEx Field",
"section":"407",
"row":"14",
"seat":"15",
"home":"Washington Redskins",
"away":"Pittsburgh Steelers",
"note":"",
"rating":"0",
"width":"1632",
"height":"976",
"timestamp":"2011-08-15 10:32:27",
"photo_type":"football",
"favorite":"no",
"comments":[]}
)]
1
Recent Photos
GET recent.php
Provides the most recent approved photos.
Sample
Result
([
{"index":"30747",
"image":"nofrills-20140217141924.jpg",
"member":"nofrills",
"avatar":"nofrills-IMAG0026.jpg",
"venue":"Air Canada Centre",
"section":"108",
"row":"13",
"seat":"21",
"home":"Toronto Marlies",
"away":"Texas Stars",
"note":"",
"rating":"5.0",
"width":"2688",
"height":"1520",
"timestamp":"2014-02-17 14:19:24"},
{...}
)]
1
Search
GET search.php
Returns a list of venues that match the supplied query.
Parameters |
Description |
|---|---|
| q | Term to search. This can be a venue, team, city or state. Example Values: "Phillies", "New York", "Giants" |
Sample
Result
([
{"id":"313",
"name":"Bright House Field",
"image":"jj3shu-20130522133747.jpg",
"team":"Philadelphia Phillies, Clearwater Threshers"},
{"id":"1","name":"Citizens Bank Park",
"image":"EventMaster23-20140208175258.jpg",
"team":"Philadelphia Phillies"},
{"id":"223",
"name":"FirstEnergy Stadium (Reading)",
"image":"mrc209-20130828194946.jpg",
"team":"Reading Phillies"}]}
)]
1
Search Venue Names
GET search_venue.php
This is a very fast search that only returns names of venues for a given query.
Parameters |
Description |
|---|---|
| q | Term to search. This can be part of a venue name. Example Values: "citi" |
Sample
Result
([
{"name":"Citi Field"},
{"name":"Citibank Ballpark"},
{"name":"Citizens Bank Park"},
{"name":"Citizens Business Bank Arena"},
{"name":"Fox Cities Stadium"}
)]
1
Sports
GET sport.php
Provides a list of venues within a league. League names, that can be used, can be pulled from the leagues.php API..
Parameters |
Description |
|---|---|
| league | The name of the league you want venue information on. Example Values: "MLB", "College Basketball", "Race Tracks" |
Sample
Result
([
{"name":"Arrowhead Stadium",
"image":"anonymous-20131222165548.jpg",
"team":"Kansas City Chiefs"},
{"name":"AT&T Stadium",
"image":"anonymous-20131230233016.jpg",
"team":"Dallas Cowboys"},
{"name":"Bank of America Stadium",
"image":"anonymous-20140119154508.jpg",
"team":"Carolina Panthers"},
{"name":"Candlestick Park",
"image":"SUCKAFREE714-20140207014431.jpg",
"team":"San Francisco 49ers"},
{"name":"CenturyLink Field",
"image":"wasillakatie-20140205222118.jpg",
"team":"Seattle Seahawks, Seattle Sounders FC"},
{...}
)]
1
Trophies
GET trophies.php
Returns a list of trophies earned by a specific member.
Parameters |
Description |
|---|---|
| name | The name of the member who's trophies you want to see. Example Values: "frank", "missy", "hawk" |
Sample
Result
([
{"id":"165",
"name":"76ers Game",
"photos":"3",
"image":"\/trophys\/wellsfargocenter.png",
"points":"100",
"comment":"3 photos of the Philadelphia 76ers from the Wells Fargo Center",
"grouping":"team",
"type":"Wells Fargo Center",
"team":"Philadelphia 76ers",
"trophy_id":"165"},
{...}
)]
1
Trophy Details
Provides details on any specific trophy.
Parameters |
Description |
|---|---|
| trophy_id | The id of a specific trophy. Example values: "50", "27" |
Sample
Result
([
{"id":"50",
"name":"White Sox Fan",
"photos":"20",
"image":"\/trophys\/whitesox.png",
"points":"100",
"comment":"20 Photos of the Chicago White Sox from U.S. Cellular Field",
"grouping":"team",
"type":"U.S. Cellular Field",
"team":"Chicago White Sox"}
)]
1
Venues
GET venue.php
Provides a variety of information about a venue.
Venue Photos
Parameters |
Description |
|---|---|
| venue | The name of the venue you want photos or information on. Example values: "Citizens Bank Park", "Madison Square Garden" |
| section | When venue and section are both set, photos from that section in that venue will be provided. Requires: venue Example values: "130", "SRO" |
Sample
https://aviewfrommyseat.com/avf/api/venue.php?appkey=YourAppKey&venue=Citizens+Bank+Park§ion=130
Result
([
{"index":"125",
"image":"20100501220903-20100506152440.jpg",
"member":"frank",
"avatar":"20100501220903-5.jpg",
"venue":"Citizens Bank Park",
"section":"130",
"row":"20",
"seat":"14",
"home":"Philadelphia Phillies",
"away":"",
"note":"Good section for the Philly Phanatic.",
"rating":"0",
"width":"2048",
"height":"1536",
"timestamp":"2011-08-11 09:51:13",
"favorite":"no"},
{...}
)]
1
Venue Information
Provides additional venue details. This is not available for every venue.
Parameters |
Description |
|---|---|
| venue | The name of the venue you want information on. Example values: "Citizens Bank Park", "Citi Field" |
| info | Requires: venue Value: "true" |
Sample
https://aviewfrommyseat.com/avf/api/venue.php?appkey=YourAppKey&venue=Citizens+Bank+Park&info=true
Result
([
{"id":"1",
"name":"Citizens Bank Park",
"type":"MLB",
"address":"3501 S. Broad St.",
"city":"Philadelphia",
"state":"Pennsylvania",
"country":"United States",
"team":"Philadelphia Phillies",
"gps":"39.9059, -75.1665",
"stats":"<b>Capacity:<\/b> 43,647<br><b>Construction Cost:<\/b> $458 million<br><b>Opened:<\/b> April 3, 2004<br><b>Surface:<\/b> Kentucky Blue Grass<br>"}
)]
1
Venue Section List
provides a list of sections that have approved photos, along with that section's average rating.
Parameters |
Description |
|---|---|
| venue | The name of the venue you want. Example values: "Citizens Bank Park", "Citi Field" |
| section_list | Requires: venue Value: "true" |
App Sample
Result
([
{"section":"Suite 57",
"rating":"0",
"image":"\/images\/rating\/rating_0.png"},
{"section":"Suite 7",
"rating":"5",
"image":"\/images\/rating\/rating_5.png"},
{"section":"Suite 8",
"rating":"0",
"image":"\/images\/rating\/rating_0.png"},
{"section":"101",
"rating":"5",
"image":"\/images\/rating\/rating_5.png"},
{"section":"102",
"rating":"4.5",
"image":"\/images\/rating\/rating_5.png"},
{"section":"103",
"rating":"4",
"image":"\/images\/rating\/rating_4.png"},
{"section":"104",
"rating":"4",
"image":"\/images\/rating\/rating_4.png"},
{"section":"105",
"rating":"4",
"image":"\/images\/rating\/rating_4.png"},
{...}
)]
1
Important Paths
This is a collection of useful paths for accessing photos and image.
800px wide photos
http://aviewfrommyseat.com/wallpaper/IMAGE-NAME
400px wide photos
http://aviewfrommyseat.com/thumb/IMAGE-NAME
200px wide photos
http://aviewfrommyseat.com/small/IMAGE-NAME
100px wide photos
http://aviewfrommyseat.com/smaller/IMAGE-NAME
Trophies
These are the icons associated with trophies.
http://aviewfrommyseat.com/trophys/IMAGE-NAME
Avatars
These are the images that members use as avatars.
http://aviewfrommyseat.com/avatar/IMAGE-NAME
Other Tips
All variables need to be url encoded. No spaces are allowed in API calls.
A rating of "0" means that the photo has NOT been rated.
Members can can give a photo a rating between 0.5 and 5.0.
All team names include their city of origin.
Example: Philadelphia Phillies
We can map your venue names against ours to help ensure you always get results.
For non-ssl requests, you can also use the short domain: http://api.avf.ms/
Contact us if you need a custom API.