---
title: "One random article"
method: GET
path: "/random"
---

# One random article

`GET /random`

## Request

- Base URL: `https://www.edgechat.ai/api/v1`
- URL: `https://www.edgechat.ai/api/v1/random`
- Auth: none declared

## Query parameters

- `new` '1'
- `topic` string
- `geo` string
- `fields` string

## Response `200`

A random article

- RandomArticleResponse
  - `result` ArticleSummary
    - `id` string, required
    - `slug` string, required
    - `title` string, required
    - `topic` string, nullable: The top-level branch of the topic tree the article is under. Its own topic is the last entry of the article's `topic_path`.
    - `excerpt` string, required: The corpus snippet when available, otherwise the article opening as plain text. Older listing excerpts may end in an ellipsis (…).
    - `url` string, uri, required
    - `markdown_url` string, uri, required
    - `api_url` string, uri, required
    - `snippet` string: Optional corpus-authored summary, separate from the article opening. Present on corpus-v1.5 articles and their preview results.
    - `node` string: Current concept-tree node of the article, when available. May change when the corpus tree is revised.
  - `license` License
    - `name` string, required
    - `url` string, uri, required
    - `summary` string
    - `spdx` string

## Other responses

- `400`: `unknown_parameter`: the request carries a query parameter this route does not read (or one given twice). Each route reads only the parameters listed for it.
- `405`: `method_not_allowed`: the API is read-only; use GET or HEAD (OPTIONS answers CORS preflights). The `Allow` header lists the methods.
- `429`: An error
- `503`: Briefly unavailable; try again

---

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