---
title: "Get curation items"
method: GET
path: "/curation/items"
tags: ["Curation"]
---

# Get curation items

`GET /curation/items`

## Request

- Base URL: `https://socialbu.com/api/v1`
- URL: `https://socialbu.com/api/v1/curation/items`
- Auth: HTTP bearer

Returns a list curation items

## Query parameters

- `page` integer
- `per_page` integer
- `authors` string[]
- `feed_id` integer
- `search` string
- `sort` 'relevance' | 'newest' | 'oldest'
- `source_scope` 'all' | 'global' | 'private' | 'team'
- `team_id` integer
- `time_range` 'last_7_days' | 'last_14_days' | 'last_30_days' | 'last_3_months'
- `layout` 'cards' | 'rows'
- `from` string, date
- `to` string, date

## Response `200`

successful operation id, feed_id, title, link, description, media, published_at, authors, tags, score.

- object
  - `items` CurationItem[]
    - `id` integer: Unique identifier for the item.
    - `feed_id` integer: Identifier of the feed to which this item belongs.
    - `title` string: Title of the item.
    - `link` string: Public URL to the original content of the item.
    - `description` string: Detailed description or summary of the content.
    - `media` string: URL to any media (e.g., image, video) associated with the item.
    - `published_at` string, date-time: Timestamp indicating when the item was published.
    - `authors` string: The list of authors.
    - `tags` string: Comma-separated list of tags associated with the item.
    - `score` integer: Popularity score of the feed item.
  - `currentPage` integer: The current page number of the paginated results.
  - `lastPage` integer: The last page number of the paginated results.
  - `nextPage` integer: The next page number, or null if this is the last page.
  - `total` integer: Total number of result items.

## Other responses

- `400`: Bad Request
- `404`: Resource not found
- `405`: Validation exception

---

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