Cross-domain search

GET https://api.rewind.rest/v1/search

Full-text search across all data domains (listening, running, watching, collecting, reading).

Authorization

Authorizationheaderstringrequired

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

Query Parameters

qquerystringrequired

Search query string

domainqueryenum (string)

Filter results to a specific domain

Allowed valueslisteningrunningwatchingcollectingreading

limitquerystring

Results per page (1-100, default 20)

pagequerystring

Page number (default 1)

modequeryenum (string)

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

Allowed valueskeywordsemantichybrid

Response

application/json

Search results with pagination

dataarray of objectrequired

properties

paginationobjectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/search' \
  -H 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "domain": "string",
      "entity_type": "string",
      "entity_id": "string",
      "title": "string",
      "subtitle": "string",
      "image_key": "string",
      "image": {
        "cdn_url": "\u2026",
        "thumbhash": "\u2026",
        "dominant_color": "\u2026"
      },
      "url": "string",
      "instapaper_url": "string",
      "instapaper_app_url": "string",
      "author": "string",
      "score": 0
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}