POST /api/studyaustralia/scholarships/search
Price: 10 credits
Search scholarships offered by Australian universities, colleges and schools by keywords, level of study, area of study and provider. Each scholarship carries its amount, duration, frequency, eligibility, application dates, who may apply, levels and fields of study and the offering providers.
Find scholarships for study in Australia, from school to postgraduate research, with amounts and eligibility. Filter by provider_ids for one institution's scholarships.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)count integer required — Max number of scholarships to return (min: 1; max: 500)offset integer — Number of matching scholarships to skip (default: 0; examples: 0, 20; min: 0; max: 9999)keywords string nullable — Search text (examples: "nursing", "research"; minLength: 1)levels_of_study array — Levels of study (default: []; one of: "undergraduate_vet", "postgraduate", "secondary_schooling", "primary_schooling"; examples: ["postgraduate"])areas_of_study array — Areas of study (default: []; one of: "accounting", "agriculture", "architecture", "built_environment", "business_and_management", "communications", "computing_and_information_technology", "creative_arts", "environmental_studies", "dentistry", "economics", "education_and_training", "engineering_and_technology", "rehabilitation", "health_services_and_support", "tourism_and_hospitality", "humanities_and_social_sciences", "languages", "law", "para_legal_studies", "pharmacy", "sport_and_leisure", "mathematics", "medicine", "nursing", "psychology", "sciences", "social_work", "surveying", "veterinary_science"; examples: ["nursing"], ["accounting","economics"])provider_ids array — Education providers, by Study Australia provider id or provider page URL (default: []; examples: ["ed72a788c15867049e20b2e5f048ec0a"])@type string (default: "StudyaustraliaScholarship")id string requiredscholarship_number string nullableurl string requiredalias string nullablename string requireddescription string nullablesummary string nullableeligibility string nullablewebsite_url string nullableamount_annual number nullableamount_max number nullableamount_info string nullableduration number nullableduration_unit_id string nullableduration_unit string nullablefrequency_id string nullablefrequency string nullablenumber_per_year integer nullableage_min integer nullableage_max integer nullableapplication_closes string nullableavailable_from string nullableavailable_until string nullableis_for_australian_students boolean nullableis_for_international_students boolean nullableis_tenable_overseas boolean nullableis_all_fields_of_study boolean nullablestudent_type_id string nullablestudent_type string nullablecitizenship object nullable@type string (default: "StudyaustraliaCode")id string nullablekey string nullablename string nullableeligible_countries string nullablelevels_of_study array (default: [])@type string (default: "StudyaustraliaCode")id string nullablekey string nullablename string nullablefields_of_study array (default: [])@type string (default: "StudyaustraliaFieldOfStudy")id string nullablekey string nullablename string nullabledescription string nullableproviders array (default: [])@type string (default: "StudyaustraliaScholarshipProvider")id string requiredprovider_number string nullableurl string requiredalias string nullablename string nullabledescription string nullabletype_id string nullabletype string nullabletype_key string nullablesimple_type_id string nullablesimple_type string nullablesimple_type_key string nullablecricos_code string nullablerto_code string nullablewebsite_url string nullableimage string nullablesites array (default: [])@type string (default: "StudyaustraliaScholarshipSite")id string nullablestate string nullablecountry object nullable (see schema StudyaustraliaCode)is_in_qld_scope boolean nullableis_in_vic_scope boolean nullablecreated_at integer nullable422 — 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 — The entity was not found, or a precondition failed 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.