curl "https://api.topyappers.com/api/v1/songs?action=countries" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=countries" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=weeks&country_code=US" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=rankings&country=US&week=2026-W04" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=global&week=2026-W04" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=new-entries&country=US" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=search&q=trending" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=song-history&song_id=123456&country_code=US" \
  -H "x-ty-api-key: your-api-key"

curl "https://api.topyappers.com/api/v1/songs?action=compare&country=US&week1=2026-W03&week2=2026-W04" \
  -H "x-ty-api-key: your-api-key"

{
  "message": "OK",
  "action": "rankings",
  "credits_used": 10,
  "response": {
    // Action-specific data
  }
}

{
  "error": "Missing required parameter: action",
  "available_actions": [
    "countries",
    "weeks", 
    "date-ranges",
    "rankings",
    "global",
    "new-entries",
    "search",
    "song-history",
    "compare"
  ],
  "example_usage": {
    "countries": "/api/v1/songs?action=countries",
    "weeks": "/api/v1/songs?action=weeks&country_code=US",
    "rankings": "/api/v1/songs?action=rankings&country=US&week=2026-W04",
    "global": "/api/v1/songs?action=global&week=2026-W04",
    "search": "/api/v1/songs?action=search&q=trending",
    "song_history": "/api/v1/songs?action=song-history&song_id=123&country_code=US",
    "compare": "/api/v1/songs?action=compare&country=US&week1=2026-W03&week2=2026-W04"
  }
}