🚀 Getting Started with Insight API | LineupIQ Developer Guide

Introduction

Welcome to the Insight API, the core intelligence behind LineupIQ. This API provides AI-driven artist, venue and event recommendations, helping you optimize talent booking and venue planning with data-driven predictions.

Base URL

All API requests should be made to:

https://insight.lineupiq.io/api/

Authentication

Insight API requires authentication using API keys. Each request must include the following headers:

x-app-id: Your application ID (required)

x-api-key: Your API key (required)

Content-Type: application/json (for POST requests)

To obtain API credentials, visit your developer dashboard or contact support at support@lineupiq.io.

Rate Limits

To ensure fair usage and performance optimization, the Insight API enforces rate limits:

Plan	Request Limit
Basic Tier	1 request per second
Enterprise Tier	Custom rate limits available

For increased limits, contact our sales team.

Making Your First API Request

Here’s an example of a simple GET request to fetch all Discovery records:

curl --request GET 'https://insight.lineupiq.io/api/v1/discovery' \
  --header 'x-app-id: YOUR_APP_ID' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Accept: application/json'

Example Response:

{
  "discoveries": [
    {
      "request_id": "5112714f-8696-46ff-8427-b63581a648a4",
      "timestamp": "2025-02-07T20:59:04.760410Z",
      "venue_name": "Union Hall",
      "venue_capacity": 20000,
      "genres": ["country"]
    }
  ],
  "record_count": 1
}

Error Handling

The API returns standard HTTP response codes. Here’s a quick reference:

Status Code	Message	Description
`200`	`OK`	Request successful.
`400`	`Bad Request`	Invalid or missing parameters.
`401`	`Unauthorized`	Invalid API key or missing authentication headers.
`403`	`Forbidden`	Insufficient permissions.
`404`	`Not Found`	Resource does not exist.
`429`	`Too Many Requests`	Rate limit exceeded.
`500`	`Server Error`	Unexpected internal error.

Next Steps

Review the full API documentation for detailed endpoint usage.

Implement API pagination and caching for optimal performance.

Contact support@lineupiq.io for any integration assistance.

📌 Need Help? Check out our developer forum or contact our support team anytime.

Getting Started with Insight

Introduction#

Base URL#

Authentication#

Rate Limits#

Making Your First API Request#

Example Response:#

Error Handling#

Next Steps#