🗺️ Continents

Geographic continent groupings for regional distribution and territorial management

Resource Overview

Continents provide high-level geographic grouping for countries, enabling efficient regional distribution management and territorial organization. This reference data simplifies continent-based filtering and regional strategy implementation for global music distribution. Continents are read-only reference data with country relationships.

Base Endpoint
/continents
Resource Type
continents
Access Level
Read-only reference data

Schema

Read-only Attributes

Field Type Description
id string Unique identifier
key string Continent code key (e.g., "AF", "AS", "EU", "NA", "SA", "CA", "OC")

Relationships

Relationship Type Description
countries HasMany All countries belonging to this continent

Usage in Other Resources

🔗 Related Resources

  • • Countries: Each country belongs to a continent for regional grouping
  • • Regional Filtering: Filter countries by continent for distribution strategies
  • • Geographic Organization: High-level territorial classification
  • • Distribution Management: Continent-based regional planning

List Continents

GET /continents Read Only 
GET /continents
Authorization: Bearer {token}
Accept: application/vnd.api+json

Query Parameters

Filtering

  • • filter[key] - Filter by continent key/name
  • • filter[has-countries] - Filter continents with countries

Other Parameters

  • • include - Include countries data
  • • sort - Sort by key
  • • page[number] - Page number
  • • page[size] - Results per page

Example Request

GET /continents?include=countries&sort=key

Success Response

200 OK 
{
  "data": [
    {
      "type": "continents",
      "id": "1",
      "attributes": {
        "key": "AF"
      },
      "relationships": {
        "countries": {
          "data": [
            {"type": "countries", "id": "45"},
            {"type": "countries", "id": "78"},
            {"type": "countries", "id": "123"}
          ]
        }
      }
    },
    {
      "type": "continents",
      "id": "2",
      "attributes": {
        "key": "NA"
      },
      "relationships": {
        "countries": {
          "data": [
            {"type": "countries", "id": "39"},
            {"type": "countries", "id": "40"},
            {"type": "countries", "id": "135"}
          ]
        }
      }
    },
    {
      "type": "continents",
      "id": "3",
      "attributes": {
        "key": "EU"
      },
      "relationships": {
        "countries": {
          "data": [
            {"type": "countries", "id": "67"},
            {"type": "countries", "id": "89"},
            {"type": "countries", "id": "156"}
          ]
        }
      }
    }
  ],
  "meta": {
    "page": {
      "current-page": 1,
      "per-page": 20,
      "total": 7,
      "last-page": 1
    }
  }
}

Get Single Continent

GET /continents/{id} 
GET /continents/2?include=countries
Authorization: Bearer {token}
Accept: application/vnd.api+json

Success Response

200 OK 
{
  "data": {
    "type": "continents",
    "id": "2",
    "attributes": {
      "key": "AS"
    },
    "relationships": {
      "countries": {
        "data": [
          {"type": "countries", "id": "39"},
          {"type": "countries", "id": "40"},
          {"type": "countries", "id": "135"}
        ]
      }
    }
  },
  "included": [
    {
      "type": "countries",
      "id": "39",
      "attributes": {
        "name": "United States",
        "alpha2-code": "US"
      }
    },
    {
      "type": "countries",
      "id": "40",
      "attributes": {
        "name": "Canada",
        "alpha2-code": "CA"
      }
    },
    {
      "type": "countries",
      "id": "135",
      "attributes": {
        "name": "Mexico",
        "alpha2-code": "MX"
      }
    }
  ]
}

Continental Overview

🌍 África (AF)

  • • 54 países
  • • Sudáfrica (ZA)
  • • Nigeria (NG)
  • • Kenia (KE)
  • • Ghana (GH)
  • • Marruecos (MA)

� Asia (AS)

  • • 48 países
  • • Japón (JP)
  • • Corea del Sur (KR)
  • • China (CN)
  • • India (IN)
  • • Tailandia (TH)

� Europa (EU)

  • • 44 países
  • • Reino Unido (GB)
  • • Alemania (DE)
  • • Francia (FR)
  • • España (ES)
  • • Italia (IT)

🌎 Norte América (NA)

  • • 3 países principales
  • • Estados Unidos (US)
  • • Canadá (CA)
  • • México (MX)

� Sur América (SA)

  • • 12 países
  • • Brasil (BR)
  • • Argentina (AR)
  • • Chile (CL)
  • • Colombia (CO)
  • • Perú (PE)

� Centro América/Caribe (CA)

  • • Territorios centroamericanos
  • • Guatemala (GT)
  • • Costa Rica (CR)
  • • Panamá (PA)
  • • Jamaica (JM)
  • • República Dominicana (DO)

🌏 Oceanía (OC)

  • • 14 países
  • • Australia (AU)
  • • Nueva Zelanda (NZ)
  • • Fiyi (FJ)
  • • Papúa Nueva Guinea (PG)
  • • Samoa (WS)

Regional Management

Continental Country Filtering

Retrieve countries by continent for regional distribution planning:

# Get all European countries
curl -X GET "/countries?filter[continent-id]=3&include=continent" \
  -H "Authorization: Bearer {token}"

# Get continent with all its countries
curl -X GET "/continents/2?include=countries" \
  -H "Authorization: Bearer {token}"

# Filter continents with countries
curl -X GET "/continents?filter[has-countries]=true" \
  -H "Authorization: Bearer {token}"

Regional Distribution Strategy

Use continents for high-level territorial planning:

# Plan European distribution
curl -X GET "/continents/3?include=countries" \
  -H "Authorization: Bearer {token}"

# Get North American territories
curl -X GET "/continents/2?include=countries" \
  -H "Authorization: Bearer {token}"

Continental Market Analysis

Analyze distribution reach by continent:

# Check albums distributed in Asia
curl -X GET "/albums?include=countries.continent&filter[countries.continent]=4" \
  -H "Authorization: Bearer {token}"

# Regional performance analysis
curl -X GET "/continents?include=countries&sort=key" \
  -H "Authorization: Bearer {token}"

Integration Guidelines

💡 Best Practices

  • • Cache continent data for performance
  • • Use for high-level geographic grouping
  • • Include countries for detailed territory data
  • • Implement continent-based regional strategies
  • • Consider time zones for release planning

✅ Regional Strategy

  • • Norte América (NA): Principales mercados de streaming
  • • Europa (EU): Cumplimiento regulatorio UE
  • • Asia (AS): Mercados emergentes e influencia K-pop
  • • África (AF): Crecimiento en mercados digitales
  • • Sur América (SA): Dominancia del mercado brasileño
  • • Centro América/Caribe (CA): Diversidad territorial
  • • Oceanía (OC): Mercados de Australia y Nueva Zelanda
  • • Latin America: Spanish/Portuguese markets
  • • Africa: Growing mobile-first markets

⚠️ Important Notes

  • • Continents are read-only reference data
  • • Used for geographic organization only
  • • All countries must belong to a continent
  • • Continental groupings follow UN standards
  • • 7 standard continents supported

🌐 Global Organization

  • • Hierarchical geographic structure
  • • Simplified regional management
  • • Continent-based reporting and analytics
  • • Regional distribution coordination
  • • Global market segmentation support