Cross-domain search

GET

Cross-domain search

curl --request GET \
  --url https://api.rewind.rest/v1/search \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "domain": "listening",
      "entity_type": "artist",
      "entity_id": "189",
      "title": "Nirvana",
      "subtitle": null,
      "image_key": null,
      "image": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 9,
    "total_pages": 1
  }
}

Authorizations

Authorization

string

header

required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

string

required

Search query string

domain

enum<string>

Filter results to a specific domain

Available options:

listening,

running,

watching,

collecting,

reading

limit

string

Results per page (1-100, default 20)

page

string

Page number (default 1)

mode

enum<string>

Ranking mode. keyword = FTS only (default). semantic = Vectorize only (reading domain). hybrid = FTS + semantic via reciprocal rank fusion (reading domain).

Available options:

keyword,

semantic,

hybrid

Response

Search results with pagination

data

object[]

required

Show child attributes

pagination

object

required

Show child attributes

Health checkReturns API health status and current timestamp.

Cross-domain search

curl --request GET \
  --url https://api.rewind.rest/v1/search \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "domain": "listening",
      "entity_type": "artist",
      "entity_id": "189",
      "title": "Nirvana",
      "subtitle": null,
      "image_key": null,
      "image": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 9,
    "total_pages": 1
  }
}