Insight API
HomeContact Us
HomeContact Us
LinkedIn
Github
    • Getting Started with Insight
    • Example Requests
    • Recognition & Branding Requirements
    • Discovery
      • Generate New Discovery
        POST
      • Get a Specific Discovery
        GET
      • Get All Discoveries
        GET
    • Genres
      • Get Genres
        GET
    • Artists
      • Search Artists
        GET
      • Get a Specific Artist
        GET
    • Venues
      • Search Venues
        GET
      • Get a Specific Venue
        GET
    • Pulse AI
      • Chat Completions API
      • Get Models
        GET
      • Chat Completions Endpoint
        POST
      • Healthcheck
        GET

    Genres

    Genres API Overview#

    Authentication Required
    All requests must be signed with {X-App-Id} and {X-Api-Key}.
    πŸ’‘

    What is the Genres API?#

    The Genres API in LineupIQ Insight provides access to the master list of recognized music genres. This API enables applications to retrieve a structured and standardized set of genres used across our platform for artist classification, event curation, and music analytics.

    Authentication & Headers#

    All requests to the Genres API require authentication via API keys. The following headers must be included in each request:
    x-app-id: Your application ID (required)
    x-api-key: Your API key (required)
    For security reasons, never expose your API credentials in public repositories or client-side applications.

    Rate Limits#

    The Genres API enforces request limits to ensure system stability. Default rate limits:
    Basic Tier: 1 request per second
    Enterprise Tier: Custom rate limits available
    For higher request volumes, contact our sales team to discuss enterprise plans.

    Best Practices for Usage#

    Cache responses where possible to minimize redundant API calls.
    Use the master genre list to standardize categorization across your platform.
    Validate API responses to handle potential missing or unexpected values.
    Monitor API usage to stay within rate limits and prevent throttling.

    Accessing Endpoint Details#

    For a complete list of available endpoints, request parameters, and response structures, visit the full API documentation.

    Need Support? Contact our support team at support@lineupiq.io for assistance.
    Previous
    Get All Discoveries
    Next
    Get Genres
    Built with