POST /api/bigfuture/colleges/profile
Price: 10 credits
Get one US college's full BigFuture profile by its vanity slug or profile URL: the complete college record (admissions, costs, net price by income band, financial aid, student body, campus life, majors and AP policy) plus a list of similar colleges
Get one college's full profile by its vanity slug or BigFuture URL (alias from bigfuture/colleges/search), with similar colleges. By numeric id use bigfuture/colleges. A slug the college has redirected from is accepted too. An unknown slug returns 412.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)college string required — BigFuture college vanity slug or profile URL (examples: "harvard-college", "https://bigfuture.collegeboard.org/colleges/stanford-university"; minLength: 1)@type string (default: "BigfutureCollegeProfile")id string requiredname string requiredalias string nullableurl string nullablecity string nullablestate string nullablestate_name string nullablezip_code string nullablecountry string nullablecountry_name string nullablestreet_address string nullablelatitude number nullablelongitude number nullablephone string nullablewebsite_url string nullableapplication_url string nullablenet_price_calculator_url string nullablevirtual_tour_url string nullablecommon_application_url string nullableimage string nullablebanner_url string nullablesocial_media object nullable@type string (default: "BigfutureSocialMedia")facebook array (default: [])twitter array (default: [])instagram array (default: [])youtube array (default: [])linkedin array (default: [])other array (default: [])description string nullableipeds_id string nullablecollege_board_code string nullableschool_setting string nullablelocation_code string nullableschool_type string nullableschool_years integer nullableschool_size string nullablecampus_type string nullableis_vocational boolean nullablereligious_affiliation string nullableis_historically_black boolean nullableis_tribal_college boolean nullableis_hispanic_serving boolean nullableis_mens_college boolean nullableis_womens_college boolean nullableinstitution_types array (default: [])degrees_offered array (default: [])study_options array (default: [])redirect_aliases array (default: [])acceptance_rate number nullabletotal_applicants integer nullableadmitted_applicants integer nullableenrolled_applicants integer nullablegraduation_rate number nullablesophomore_return_percent number nullablestudent_faculty_ratio number nullableapplication_fee integer nullableapplications_accepted array (default: [])early_decision boolean nullableearly_action_deadline string nullableearly_decision_deadline string nullableregular_decision_deadline string nullablenotification_deadline string nullableresponse_deadline string nullablefee_waiver_available boolean nullablefee_waiver_code string nullablestandardized_test_policy string nullablehigh_school_gpa_policy string nullablehigh_school_rank_policy string nullableprep_courses_policy string nullablerecommendations_policy string nullableap_placement_awarded boolean nullableap_credit_awarded boolean nullableap_policy_url string nullableap_policy_description string nullablesat_math_25 integer nullablesat_math_75 integer nullablesat_ebrw_25 integer nullablesat_ebrw_75 integer nullablesat_composite_25 integer nullablesat_composite_75 integer nullableact_composite_25 integer nullableact_composite_75 integer nullablegpa_distribution object nullable@type string (default: "BigfutureGpaDistribution")gpa_4_0_plus number nullablegpa_3_75_to_3_99 number nullablegpa_3_50_to_3_74 number nullablegpa_3_25_to_3_49 number nullablegpa_3_00_to_3_24 number nullablegpa_2_50_to_2_99 number nullablegpa_2_00_to_2_49 number nullablegpa_1_00_to_1_99 number nullablegpa_below_1_0 number nullableaverage_net_price integer nullablein_state_tuition integer nullableout_of_state_tuition integer nullableprivate_tuition integer nullableaverage_housing_cost integer nullablebooks_and_supplies_cost integer nullableestimated_personal_expenses integer nullabletransportation_cost integer nullablenet_price_below_30k integer nullablenet_price_30k_to_48k integer nullablenet_price_48k_to_75k integer nullablenet_price_75k_to_110k integer nullablenet_price_above_110k integer nullablefinancial_need_met_percent number nullablestudents_receiving_aid_percent number nullablefreshmen_with_need_aid_percent number nullableaverage_aid_awarded integer nullableneed_based_award integer nullableneed_based_loan_amount integer nullablenon_need_based_aid integer nullablegraduation_debt integer nullablefinancial_aid_priority_deadline string nullablefinancial_aid_office_phone string nullablefinancial_aid_deadline string nullableneed_based_aid_for_international boolean nullablenon_need_based_aid_for_international boolean nullabletotal_undergraduates integer nullabletotal_graduates integer nullablefull_time_enrolled integer nullablepart_time_enrolled integer nullableout_of_state_percent number nullableafrican_american_percent number nullableasian_percent number nullablehispanic_percent number nullablemultiracial_percent number nullablenative_american_percent number nullablepacific_islander_percent number nullablewhite_percent number nullableunknown_race_percent number nullableinternational_percent number nullablefirst_year_housing_percent number nullablehousing_options array (default: [])student_activities array (default: [])student_sports array (default: [])@type string (default: "BigfutureSport")name string requiredlevel string nullablegender string nullablemajors array (default: [])@type string (default: "BigfutureOfferedMajor")name string requiredcip_code string nullablecip_description string nullablecip_definition string nullableap_credits array (default: [])@type string (default: "BigfutureApCredit")exam string requiredpolicies array (default: [])@type string (default: "BigfutureApCreditPolicy")min_score integer nullablecredits_awarded string nullablecourse_equivalent string nullableapplies_to string nullablecredit_used_for string nullablesimilar_colleges array (default: [])@type string (default: "BigfutureCollegeCard")id string requiredname string requiredalias string nullableurl string nullablecity string nullablestate string nullablestate_name string nullablezip_code string nullablecountry string nullablecountry_name string nullableschool_setting string nullableschool_type string nullableschool_years integer nullableschool_size string nullableis_vocational boolean nullableaverage_net_price integer nullablegraduation_rate number nullablestandardized_test_policy string nullablecommon_application_url string nullablesat_math_25 integer nullablesat_math_75 integer nullablesat_ebrw_25 integer nullablesat_ebrw_75 integer nullablesat_composite_25 integer nullablesat_composite_75 integer nullableact_composite_25 integer nullableact_composite_75 integer nullableap_placement_awarded boolean nullableap_credit_awarded boolean nullableap_policy_url string nullableap_policy_description string nullableimage string nullablebanner_url string nullableredirect_aliases array (default: [])social_media object nullable@type string (default: "BigfutureSocialMedia")facebook array (default: [])twitter array (default: [])instagram array (default: [])youtube array (default: [])linkedin array (default: [])other array (default: [])422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — No college profile with this slug. Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.