Skip to main content
GET
/
pages
/
{pageId}
TypeScript
import { DiscovrClient } from "discovr";
import type { Page } from "discovr";

const discovr = new DiscovrClient("your-client-id", {
  basePath: "https://api.discovr.media",
});

// After sign-in and profile selection …
const response: Page = await discovr.getPage("example");
console.log(response);
{
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "hero": [
    {
      "id": "<string>",
      "title": "<string>",
      "media_type": "movie",
      "type": "media",
      "overview": "<string>",
      "logo_path": "<string>",
      "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "backdrop_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg"
    }
  ],
  "name": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication.

  • Identity-tier endpoints (/profiles, /auth/session-token, /auth/session) accept a long-lived refresh token (rt_<hex>).
  • Session-tier endpoints (/pages/*, /profile/*) accept a short-lived session JWT.

SDK clients use two typed API accessors (identityApi() with the refresh token vs sessionApi() with the session JWT) — see the SDK DiscovrAuth helper.

Format: Authorization: Bearer {token}

Path Parameters

​
pageId
string
required

The unique identifier of the page to retrieve

Response

Page retrieved successfully

A recommendation page containing rows of media titles. Scoped to a session and profile.

​
id
string
required

Unique identifier for the page

​
createdAt
string<date-time>
required

Creation timestamp

​
hero
object[]
required

Array of exactly 10 popular HeroItems for the hero section

Required array length: 10 elements
​
name
string

Human-readable page title as a breadcrumb path (e.g. "Movies & Series • Anime • Fantasy"). Only present for pages derived from a page graph node (genre/keyword navigation pages). Absent for top-level pages (home, movies, series).