POST /api/daad/programs
Price: 5 credits
Get one programme from DAAD International Programmes in Germany by its id or page URL: degree, teaching languages, duration, start, dates, application periods, tuition fees, semester contribution, living costs, admission and language requirements, how to apply, services for international students, accommodation, the institution's profile with location and coordinates, and contact persons.
One programme by the `id` daad/programs/search returns. Each programme's page publishes its own set of labels, even within one course type, so an empty field means that programme's page does not state it; labels without a field of their own are in `other_details`.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)program string required — DAAD programme id or detail page URL (examples: "9012", "https://www2.daad.de/deutschland/studienangebote/international-programmes/en/detail/9012/")@type string (default: "DaadProgram")id string requiredname string nullableshort_name string nullablecourse_type string nullableinstitution string nullablecity string nullableinstitution_logo string nullableprogram_logo string nullabledegree string nullablelocation string nullableteaching_languages array (default: [])language_info string nullablecourse_language string nullablelanguage_levels array (default: [])study_modes array (default: [])mode_of_study string nullablepace string nullableattendance_in_germany string nullableduration string nullablebeginning string nullabledate_texts array (default: [])application_periods string nullableapplication_info_url string nullableis_combined_master_phd boolean nullableis_joint_degree boolean nullableis_adults_only boolean nullabledescription string nullablecurrent_information string nullabletarget_group string nullablefaculties string nullablecooperation_partners string nullabledates_prices_info string nullabledates_prices_more_info string nullablecourse_organisation string nullablecourse_organisation_image string nullablecourse_organisation_document_url string nullablecourse_components array (default: [])hours_per_week integer nullablegroup_size integer nullableects_credits integer nullablecertificates array (default: [])has_diploma_supplement boolean nullablehas_english_courses boolean nullablehas_german_courses boolean nullablehas_language_exams boolean nullablehas_student_status boolean nullablehas_data_protection boolean nullablehas_digital_didactics boolean nullablequalification_exam string nullablesubsequent_admission string nullablelanguage_course_info string nullableinternships string nullablestudy_abroad string nullableinternational_elements array (default: [])international_elements_info string nullablefunding_programmes array (default: [])daad_funding_programme string nullableteaching_opportunities string nullabledoctoral_programmes string nullabletuition_fees string nullabletuition_fee_amount number nullabletuition_fee_currency string nullabletuition_fees_note string nullabletuition_fee_exemptions string nullabletuition_fees_info_url string nullablesemester_contribution string nullableliving_costs string nullablecosts string nullableis_price_on_request boolean nullabledates_and_costs array (default: [])price_includes array (default: [])has_university_funding boolean nullableuniversity_funding string nullableadmission_requirements string nullableenglish_requirements string nullablegerman_requirements string nullablelanguage_requirements_info string nullablelanguage_exemptions string nullableapplication_documents array (default: [])application_channel string nullableapplication_url string nullableaccommodation string nullableaccommodation_arrangement string nullableaccommodation_type string nullablemeals string nullablehas_pickup_service boolean nullablehas_free_internet boolean nullablehas_visa_support boolean nullablehas_leisure_programme boolean nullableleisure_programme string nullablehas_financial_support boolean nullablehas_research_training boolean nullablehas_structured_research boolean nullablecareer_services string nullablepart_time_jobs string nullableinternational_support array (default: [])international_support_info string nullablerefugee_support string nullablefamily_support string nullabledisability_support string nullableother_details array (default: [])@type string (default: "DaadDetailItem")section string nullablelabel string requiredtext string nullableinstitution_profile object nullable@type string (default: "DaadInstitutionProfile")name string nullabledescription string nullablebanner string nullablebanner_caption string nullablebanner_copyright string nullablefacts array (default: [])@type string (default: "DaadFact")label string requiredvalue string nullablelocation_description string nullableaddress string nullablelatitude number nullablelongitude number nullableprograms array (default: [])@type string (default: "DaadInstitutionProgram")id string requiredname string nullablecategory string nullableinstitution string nullablecity string nullableurl string nullablecontact object nullable@type string (default: "DaadContact")institution string nullablewebsite_url string nullabledepartment string nullableaddress string nullablecourse_url string nullablecontact_form_url string nullablephone string nullableemail string nullablepeople array (default: [])@type string (default: "DaadContactPerson")name string nullablephone string nullableemail string nullablesocial_urls array (default: [])images array (default: [])@type string (default: "DaadPicture")image string requiredcaption string nullabletestimonials array (default: [])@type string (default: "DaadTestimonial")name string nullablerole string nullabletext string nullableimage string nullableimage_copyright string nullablevideos array (default: [])@type string (default: "DaadVideo")url string nullabletitle string nullabledescription string nullableimage string nullablepartners array (default: [])@type string (default: "DaadPartner")name string nullablewebsite_url string nullableimage string nullableimage_copyright string nullableurl string 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 — No DAAD programme has that id 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.