Stage APIstage.ma ↗

"""Walkthrough: Stage.ma SDK — search and inspect Moroccan internships."""
from parse_apis.stage_ma_api import StageMa, Specialty, RemoteType, InternshipNotFound

client = StageMa()

# Search internships filtered by specialty (Marketing)
for internship in client.internship_summaries.search(specialty=Specialty.MARKETING, limit=3):
    print(internship.title, "|", internship.location, "|", internship.duration)

# Drill into the first IT internship for full details
it_result = client.internship_summaries.search(
    specialty=Specialty.INFORMATIQUE, limit=1
).first()
if it_result:
    detail = it_result.details()
    print(detail.title, detail.city, detail.salary, detail.availability)
    print(detail.description[:120])

# Search with remote type filter and paid only
for internship in client.internship_summaries.search(
    remote_type=RemoteType.ONSITE, salary="true", limit=3
):
    print(internship.title, internship.company, internship.tags)

# Typed error handling: attempt to get a non-existent internship
if it_result:
    try:
        detail = it_result.details()
        print(detail.title, detail.published_date)
    except InternshipNotFound as exc:
        print(f"Not found: {exc.slug}")

print("exercised: search (specialty/remote_type/salary filters) / details / error handling")