# CollegeSoccer Scoring The CollegeSoccer API accepts a JSON file with a set of Academic and Athletic factors that are used to create a custom list of the ten colleges that best meet these criteria. This API relies on data from both the Department of Education and the NCAA. Here are the factors: ### Academics Factors - ACT Scores: The CollegeSoccer API awards points to colleges if the user's reported ACT scores are higher than the 25% and 75% percentile of students at that college. Those points are multiplied by 100 if the user considers this a critical item. - SAT Scores: The CollegeSoccer API award points to colleges if the user's reported SAT scores are higher than the 25% and 75% percentile of the students at that college. Those points are multiplied by 100 if the user considers this a critical item. - Admissions: The CollegeSoccer API awards points to colleges that match the acceptance rate that the user prefers. Possible options include:

-- Highly competitive - 5% acceptance or less

-- Very competitive - 5-25% acceptance (but not highly competitive)

-- Competitive - 25-50% acceptance (but not highly or very competitive)

-- Not competitive - >50% acceptance rate

Those points are multiplied by 100 if the user considers this a critical item. - All Male/All Female: The CollegeSoccer API awards points to colleges if the user prefers all-male (or all-female) schools. Those points are multiplied by 100 if the user considers this a critical item. - Major: The CollegeSoccer API awards points to colleges if the users prefers colleges that offer a specific major. If anyone from a college graduated with the type of major selected, the API awards points to that college. If the user considers it critical that the school is graduating students with that major, those points are multiplied by 100 to ensure it is near the top of the results. This dictionary structure contains all of the allowed values, and the corresponding code that the CollegeSoccer API will accept:

{ "majors": { "Agriculture, Agriculture Operations, And Related Sciences": "PCIP01", "Natural Resources And Conservation": "PCIP03", "Architecture And Related Services": "PCIP04", "Area, Ethnic, Cultural, Gender, And Group Studies": "PCIP05", "Communication, Journalism, And Related Programs": "PCIP09", "Communications Technologies/Technicians And Support Services": "PCIP10", "Computer And Information Sciences And Support Services": "PCIP11", "Personal And Culinary Services": "PCIP12", "Education": "PCIP13", "Engineering": "PCIP14", "Engineering Technologies And Engineering-Related Fields": "PCIP15", "Foreign Languages, Literatures, And Linguistics": "PCIP16", "Family And Consumer Sciences/Human Sciences": "PCIP19", "Legal Professions And Studies": "PCIP22", "English Language And Literature/Letters": "PCIP23", "Liberal Arts And Sciences, General Studies And Humanities": "PCIP24", "Library Science": "PCIP25", "Biological And Biomedical Sciences": "PCIP26", "Mathematics And Statistics": "PCIP27", "Military Technologies And Applied Sciences": "PCIP29", "Multi/Interdisciplinary Studies": "PCIP30", "Parks, Recreation, Leisure, And Fitness Studies": "PCIP31", "Philosophy And Religious Studies": "PCIP38", "Theology And Religious Vocations": "PCIP39", "Physical Sciences": "PCIP40", "Science Technologies/Technicians": "PCIP41", "Psychology": "PCIP42", "Homeland Security, Law Enforcement, Firefighting And Related Protective Services": "PCIP43", "Public Administration And Social Service Professions": "PCIP44", "Social Sciences": "PCIP45", "Construction Trades": "PCIP46", "Mechanic And Repair Technologies/Technicians": "PCIP47", "Precision Production": "PCIP48", "Transportation And Materials Moving": "PCIP49", "Visual And Performing Arts": "PCIP50", "Health Professions And Related Programs": "PCIP51", "Business, Management, Marketing, And Related Support Services": "PCIP52", "History": "PCIP54" } - College Location: The CollegeSoccer API awards points to every school located within the specified distance of the given zip code. If the user considers it critical that the school is graduating students with that major, those points are multiplied by 100 to ensure it is near the top of the results. - HBCU Preferred: The CollegeSoccer API awards points to colleges if the user prefers HBCU schools. Those points are multiplied by 100 if the user considers this a critical item. - Estimated Family Net Income: The CollegeSoccer API subdivides all the private and public schools into quartiles based on the average price paid by the student's family in the given household income range, and awards points to schools based on their relative affordability. This metric favors schools that are less expensive for the user (including the average financial aid offered), based on the family's income range they describe. - Religious Affiliation The CollegeSoccer API awards points to a college if the user prefers a specific Religious Affiliation. Those points are multiplied by 100 if the user considers this a critical item. Possible values for this factor are based on the Dept of Ed's coding, given here. Note that not all affiliations have colleges: "Religious Affiliation": { "Not reported": -1, "Not applicable": -2, "American Evangelical Lutheran Church": 22, "African Methodist Episcopal Zion Church": 24, "Assemblies of God Church": 27, "Brethren Church": 28, "Roman Catholic": 30, "Wisconsin Evangelical Lutheran Synod": 33, "Christ and Missionary Alliance Church": 34, "Christian Reformed Church": 35, "Evangelical Congregational Church": 36, "Evangelical Covenant Church of America": 37, "Evangelical Free Church of America": 38, "Evangelical Lutheran Church": 39, "International United Pentecostal Church": 40, "Free Will Baptist Church": 41, "Interdenominational": 42, "Mennonite Brethren Church": 43, "Moravian Church": 44, "North American Baptist": 45, "Pentecostal Holiness Church": 47, "Christian Churches and Churches of Christ": 48, "Reformed Church in America": 49, "Episcopal Church, Reformed": 50, "African Methodist Episcopal": 51, "American Baptist": 52, "American Lutheran": 53, "Baptist": 54, "Christian Methodist Episcopal": 55, "Church of God": 57, "Church of Brethren": 58, "Church of the Nazarene": 59, "Cumberland Presbyterian": 60, "Christian Church (Disciples of Christ)": 61, "Free Methodist": 64, "Friends": 65, "Presbyterian Church (USA)": 66, "Lutheran Church in America": 67, "Lutheran Church - Missouri Synod": 68, "Mennonite Church": 69, "United Methodist": 71, "Protestant Episcopal": 73, "Churches of Christ": 74, "Southern Baptist": 75, "United Church of Christ": 76, "Protestant, not specified": 77, "Multiple Protestant Denomination": 78, "Other Protestant": 79, "Jewish": 80, "Reformed Presbyterian Church": 81, "United Brethren Church": 84, "Missionary Church Inc": 87, "Undenominational": 88, "Wesleyan": 89, "Greek Orthodox": 91, "Russian Orthodox": 92, "Unitarian Universalist": 93, "Latter Day Saints (Mormon Church)": 94, "Seventh Day Adventists": 95, "The Presbyterian Church in America": 97, "Other (none of the above)": 99, "Original Free Will Baptist": 100, "Ecumenical Christian": 101, "Evangelical Christian": 102, "Presbyterian": 103, "General Baptist": 105, "Muslim": 106, "Plymouth Brethren": 107 } - High Degree Completion Rates (within 6 years) The CollegeSoccer API awards points to each college based on the percentage of students who graduate within 6 years. Those points are multiplied by 100 if the user considers this a critical item. - Campus Locale: The CollegeSoccer API awards points to each college based on the school's location. Possible options include:

--Rural

--Suburb

--Town

--City

Those points are multiplied by 100 if the user considers this a critical item. - Student Residences: The CollegeSoccer API awards points to colleges if the user's preference for a residential college over a commuter school matches the college's accomodations. Those points are multiplied by 100 if the user considers this a critical item. Possible options include:

--Residential

--Commuter

- School Size: The CollegeSoccer API awards points to colleges whose size matches the user's preference. Those points are multiplied by 100 if the user considers this a critical item. Possible options include:

--Very Small

--Small

--Medium

--Large

--Very Large

- Exclude 2 Year Programs: The CollegeSoccer API will filter out all of the 2 year programs if this value is selected.

## Men's Soccer Factors These factors are associated with the varsity men's soccer program and the possible opportunities to play at desired level of competition. - Contending Teams Preferred: The CollegeSoccer API awards points to colleges on a sliding scale based on their preseason ranking of the school. The top ranked school in Division I, II, III and NAIA gets the full points. The lowest ranked school gets ½ of those points. - Soccer Team Division: Award weight points if the school’s division matches the selected division. Possible choices are:

--Division 1

--Division 2

--Division 3

--NAIA

--Junior College

Those points are multiplied by 100 if the user considers this a critical item. ### Program Stability: - Minimum Head Coach Experience The CollegeSoccer API awards points if the coach has been at the school at least as long as the minimum value the user specifies. The API provides an extra 50% for coaches with double the minimum experience at the school. It also provide an extra 25% for coaches with triple the minimum. - Minimum Head Coach Winning Percentage at the current school: If the head coach at the school has a higher winning percentage than the percentage selected by the user, award points on a sliding scale. - Athletes Play as Freshmen: If a lot of athletes start as freshmen, award full points.

-- If anyone on the current team started as a freshmen at all in the past season, award half the points.

-- If a lot of athletes appeared in games as a freshmen in games last season, award all of the points.

- Preferred Position: Award points based on the number of games started by seniors who played the position selected by the user. (These schools presumably would be especially interested in recruiting athletes who play that soon-to-be-available position.) Positions include:

-- Goalkeeper: GK

-- Midfielder: M

-- Forward: F

-- Defender: D

## Sample JSON Input Form A sample JSON input form is given here. Note that each value is optional. Also note that the weights per factor are variable as well, so your application can be tailored as you see fit. Note that the "critical" value can be "true" or "false", and any factor that has "unimportant" set to "true" will be ignored. Other notes: 1. Family Net Income's value_pub and value_priv values refer to Dept. of Ed. variables, and should not be modified. {

"ACT cumulative score": {

"value": 30,

"critical": false,

"unimportant": false,

"weight": 6

"ACT english score": {

"value": 31,

"critical": false,

"unimportant": false,

"weight": 6

"ACT math score": {

"value": 32,

"critical": false,

"unimportant": false,

"weight": 6

"Family Net Income": {

"value_pub": "NPT43_PUB",

"value_priv": "NPT43_PRIV",

"critical": false,

"unimportant": false,

"weight": 5

"HBCU": {

"critical": false,

"unimportant": false,

"weight": 10

"SAT Score-critical reading": {

"value": 500,

"critical": false,

"unimportant": false,

"weight": 8

"SAT Score-math": {

"value": 500,

"critical": false,

"unimportant": false,

"weight": 8

"SAT Score-writing": {

"value": 500,

"critical": false,

"unimportant": false,

"weight": 8

"admission_rate": {

"value": "Highly Competitive",

"critical": false,

"unimportant": false,

"weight": 5

"all_men": {

"critical": false,

"unimportant": false,

"weight": 20

"all_women": {

"critical": false,

"unimportant": true,

"weight": 20

"major": {

"value": "PCIP01",

"critical": false,

"unimportant": false,

"weight": 5

"zipcode": {

"value_zipcode": "02134",

"value_radius": 50,

"critical": false,

"unimportant": false,

"weight": 5

"Religious Affiliation": {

"value": 74,

"critical": false,

"unimportant": false,

"weight": 5

"Complete In 6 Years": {

"critical": false,

"unimportant": false,

"weight": 5

"Locale" : {

"value": 40,

"critical": false,

"unimportant": false,

"weight": 5

"ResidentialVsCommuter" : {

"value": "Residential",

"critical": false,

"unimportant": false,

"weight": 10

"SchoolSize" : {

"value": "Large",

"critical": false,

"unimportant": false,

"weight": 10

"Exclude 2 Year Programs": {

"value": true

"Division" : {

"value": "NCAA D3",

"critical": false,

"unimportant": false,

"weight": 10

"Experience" : {

"value": 40,

"critical": false,

"unimportant": false,

"weight": 10

"Winning" : {

"value": 90,

"critical": false,

"unimportant": false,

"weight": 10

"Contender": {

"critical": false,

"unimportant": false,

"weight": 10

"Freshmen Play": {

"critical": false,

"unimportant": false,

"weight": 5

"Positions": {

"value": "D",

"critical": false,

"unimportant": false,

"weight": 5

}