> ## Documentation Index
> Fetch the complete documentation index at: https://docs.patchline.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Playlists

> Playlist targeting for tracks in your catalog. Paste a Spotify link or pick a catalog track — Aria finds matching playlists, ranks them by fit and curator responsiveness, and gives you the inspector view before you pitch.

export const AriaPromptCard = ({prompt, surface = "web"}) => {
  const surfaces = {
    web: {
      href: "https://patchline.ai/dashboard",
      label: "Try in dashboard"
    },
    telegram: {
      href: "https://t.me/AriaMusicBizBot",
      label: "Try in Telegram"
    },
    claude: {
      href: "https://patchline.ai/claude",
      label: "Try in Claude"
    },
    mcp: {
      href: "https://patchline.ai/mcp",
      label: "Install MCP first"
    }
  };
  const s = surfaces[surface] ?? surfaces.web;
  return <div style={{
    display: "flex",
    justifyContent: "space-between",
    alignItems: "center",
    gap: "16px",
    padding: "12px 16px",
    marginBottom: "12px",
    borderRadius: "10px",
    border: "1px solid rgba(255,255,255,0.10)",
    background: "rgba(255,255,255,0.03)"
  }}>
      <code style={{
    fontFamily: "var(--font-family-mono)",
    fontSize: "14px",
    color: "inherit",
    flex: 1
  }}>
        "{prompt}"
      </code>
      <a href={s.href} target="_blank" rel="noopener noreferrer" style={{
    fontSize: "12px",
    fontWeight: 600,
    padding: "6px 12px",
    borderRadius: "999px",
    background: "linear-gradient(92deg, #00E6E2, #0068FF)",
    color: "#FFFFFF",
    textDecoration: "none",
    whiteSpace: "nowrap"
  }}>
        {s.label} →
      </a>
    </div>;
};

export const TierBadge = ({tier}) => {
  const styles = {
    free: {
      label: "Free",
      color: "#A1A1AA"
    },
    starter: {
      label: "Starter+",
      color: "#00E6E2"
    },
    pro: {
      label: "Pro+",
      color: "#0068FF"
    },
    scale: {
      label: "Scale+",
      color: "#7A5BFF"
    },
    enterprise: {
      label: "Enterprise",
      color: "#FF7A59"
    },
    all: {
      label: "All plans",
      color: "#22C55E"
    }
  };
  const t = styles[tier?.toLowerCase()] ?? styles.all;
  return <span style={{
    display: "inline-flex",
    alignItems: "center",
    gap: "4px",
    padding: "2px 10px",
    borderRadius: "999px",
    border: `1px solid ${t.color}40`,
    background: `${t.color}1A`,
    color: t.color,
    fontSize: "12px",
    fontWeight: 600,
    fontFamily: "var(--font-family-mono)",
    verticalAlign: "middle"
  }}>
      {t.label}
    </span>;
};

export const AICallout = ({page}) => {
  const slug = page ?? "";
  const mdUrl = `https://docs.patchline.ai${slug}.md`;
  return <div style={{
    marginTop: "32px",
    padding: "16px 20px",
    borderRadius: "12px",
    border: "1px solid rgba(0,230,226,0.25)",
    background: "linear-gradient(135deg, rgba(0,230,226,0.08), rgba(0,104,255,0.05))",
    color: "inherit",
    fontSize: "14px",
    lineHeight: 1.6
  }}>
      <strong style={{
    display: "block",
    marginBottom: "6px",
    color: "#00E6E2"
  }}>
        For AI agents reading this page
      </strong>
      The canonical machine-readable version of this page is at{" "}
      <a href={mdUrl}>
        <code>{mdUrl}</code>
      </a>
      . For product actions, connect to{" "}
      <code>www.patchline.ai/api/mcp/v1</code>
      {" "}and call MCP <code>tools/list</code> for the current tool schema.
      Rules for navigating these docs:{" "}
      <a href="https://docs.patchline.ai/AGENTS.md">
        <code>docs.patchline.ai/AGENTS.md</code>
      </a>
      .
    </div>;
};

The **Playlists** tab is your pitching workspace. Pick a track from your
catalog — or paste any Spotify link — and Aria surfaces playlists worth
your time, with the context you need to pitch right.

<TierBadge tier="all" />   Available on every tier. Match depth and curator intelligence expand on paid tiers.

## What you can do here

* **Match playlists for a specific track.** Aria ranks them by sonic
  fit plus curator responsiveness — not just follower count.
* **Inspect a playlist.** Curator identity, recent adds, freshness,
  turnover rate, submission status — everything you need before you
  spend a pitch.
* **Pitch with grounding.** Aria drafts the pitch using your real
  track context. Uploaded tracks can use their
  [AI caption](/catalog/sonic-analysis); imported tracks use available
  metadata.

## Where to find it

Sidebar → **Playlists**.

From inside a playlist match, you can hand a pitch over to
[Launchpad](/launchpad/overview) and ship a public pitch link to the
curator directly.

## How to use it

<Steps>
  <Step title="Pick a track">
    Either choose a track from your catalog or paste a Spotify track
    URL into the search bar at the top of the tab.
  </Step>

  <Step title="Review the ranked matches">
    Aria returns playlists with a match score, follower count, curator
    handle, and recent activity. The score weighs sonic fit + curator
    responsiveness, not just size.
  </Step>

  <Step title="Inspect the top 2-3">
    Click into the playlists you're seriously considering. Read the
    curator profile, recent additions, and submission status before
    you decide to pitch.
  </Step>

  <Step title="Pitch via Launchpad">
    Generate a pitch in [Launchpad](/launchpad/overview) — Aria drafts
    a contextual pitch link you can send the curator.
  </Step>
</Steps>

## Prompts you can use in Aria

<AriaPromptCard prompt="Find playlists for my latest track." />

<AriaPromptCard prompt="Inspect this Spotify playlist for me." />

<AriaPromptCard prompt="Show me playlists where the curator added a similar artist recently." />

<AriaPromptCard prompt="Draft a pitch for the top match." />

## Related pages

* [AI-discoverable tracks](/catalog/sonic-analysis) — captions for uploaded audio
* [Catalog upload](/catalog/upload) — get tracks in first
* [Launchpad](/launchpad/overview) — where pitches ship from
* [Use cases](/aria/prompts) — more playlist-shaped prompts

<AICallout page="/playlists/overview" />