---
title: "List available insertion articles"
method: GET
path: "/catalog/{siteId}/articles"
tags: ["Catalog"]
---

# List available insertion articles

`GET /catalog/{siteId}/articles`

## Request

- Base URL: `https://nautilinks.co/api/v1/agent`
- URL: `https://nautilinks.co/api/v1/agent/catalog/{siteId}/articles`
- Auth: HTTP bearer

Lists sold-once existing articles available on a catalog site, with ranking queries and performance data. Identity fields stay masked until the site has been delivered to the buyer.

## Path parameters

- `siteId` integer, required

## Query parameters

- `limit` integer

## Response `200`

Available articles for this site.

- ArticlesResponse
  - `ok` true, required
  - `site_id` integer, required
  - `count` integer, required
  - `articles` Article[], required
    - `id` integer, required
    - `site_id` integer, required
    - `domain` string, nullable
    - `slug` string, nullable
    - `url` string, uri, nullable
    - `title` string, nullable
    - `top_queries` RankQuery[], required
      - `query` string, required
      - `position` number, required
      - `clicks` integer, required
      - `impressions` integer, required
    - `gsc_top_position` number, nullable
    - `gsc_total_impressions` integer, nullable
    - `state` 'available' | 'reserved' | 'sold', required

## Other responses

- `400`: The request is syntactically or semantically invalid.
- `401`: The API key is missing, invalid, or revoked.
- `403`: The key lacks the required scope or resource ownership.
- `404`: The resource does not exist or is not visible to this account.
- `429`: The request quota or rolling daily order cap was reached.
- `500`: Nautilinks encountered an unexpected internal error.
- `default`: Any non-success status not listed explicitly uses the same typed error envelope.

---

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