---
title: "Resolve a Reddit URL (live)"
method: GET
path: "/api/data/reddit/resolve/live"
tags: ["Reddit (live)"]
---

# Resolve a Reddit URL (live)

`GET /api/data/reddit/resolve/live`

## Request

- Base URL: `https://api.xpoz.ai`
- URL: `https://api.xpoz.ai/api/data/reddit/resolve/live`
- Auth: HTTP bearer

Resolve a permalink or share link into its identifiers. Returns one result with `kind` (`post` or `comment`), `subreddit`, `postId`, `commentId` and `shortCode`. Resolving a share link calls Reddit once; a permalink is parsed locally. An expired or invalid share link returns 400. Fetches directly from the platform. Not available for trial access keys.

## Query parameters

- `url` string, required

## Response `200`

Results.

- CursorResponse: Envelope for on-demand `/live` endpoints: one provider page plus a cursor.
  - `results` object[], required
  - `count` integer, required
  - `dataSource` 'database' | 'api' | 'hybrid', required: Where the results came from.
  - `has_more` boolean, required
  - `next_page_cursor` string, nullable, required

## Other responses

- `400`: Validation failed.
- `401`: Missing or invalid credentials.
- `403`: On-demand search is not available for trial access keys.
- `default`: The request could not be fulfilled. Status is 400 for an empty or invalid search query, 402 when CSV export is blocked by plan limits, 500 otherwise.

---

[API](https://skmtc.dev/xpoz/apis/xpoz-api.md) · [All operations](https://skmtc.dev/xpoz/apis/xpoz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xpoz/apis/xpoz-api/revisions/c18261f587a4?raw)