Here's an updated API Documentation reflecting the new route /api/data/cards.

Cards API Documentation

Overview

The Cards API allows users to query, filter, paginate, and retrieve card data from the database. This endpoint is designed for flexibility, supporting advanced filters, search, sorting, and cursor-based pagination.

Base URL

<https://alpha.brogevity.com/api/data/cards>

HTTP Methods

GET `/api/data/cards`

Retrieve a list of cards with optional filters, sorting, and pagination.

Query Parameters

Pagination

Parameter	Type	Default	Description
`cursorId`	`string`	`null`	Cursor ID to fetch the next page of results.
`pageSize`	`integer`	`10`	Number of records to fetch per page.

Filters

Parameter	Type	Default	Description
`use_case`	`string[]`	`null`	Filter by one or more use cases.
`tool`	`string[]`	`null`	Filter by one or more tools.
`filters`	`JSON`	`{}`	Advanced filters (e.g., age range, gender, influencers). Format: JSON string.
`searchQuery`	`string`	`""`	Search query to match `title`, `description`, or `source`.

Sorting

Parameter	Type	Default	Description
`sorting`	`string`	`qualityScore`	Field to sort by (e.g., `qualityScore`, `createdAt`).