Search (AI Search) | Movie Knight Server

curl -X POST https://{{baseurl}}/api/ai/search \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "query": "mind-bending sci-fi movies about dreams"
}'

{
  "ok": true,
  "data": [
    {
      "id": 27205,
      "adult": false,
      "title": "Inception",
      "video": false,
      "overview": "Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets, is offered a chance to regain his old life.",
      "genre_ids": [
        28,
        878,
        12
      ],
      "popularity": 95.13,
      "vote_count": 36219,
      "poster_path": "/oYuLEt3zVCKq57qu2F8dT7NIa6f.jpg",
      "release_date": "2010-07-15",
      "vote_average": 8.369,
      "backdrop_path": "/s3TBrRGB1iav7gFOCNx3H31MoES.jpg",
      "original_title": "Inception",
      "original_language": "en"
    },
    {
      "id": 550,
      "adult": false,
      "title": "Fight Club",
      "video": false,
      "overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy.",
      "genre_ids": [
        18
      ],
      "popularity": 65.482,
      "vote_count": 28543,
      "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
      "release_date": "1999-10-15",
      "vote_average": 8.438,
      "backdrop_path": "/hZkgoQYus5vegHoetLkCJzb17zJ.jpg",
      "original_title": "Fight Club",
      "original_language": "en"
    }
  ],
  "aiUsage": {
    "used": 1,
    "limit": 5,
    "remaining": 4
  }
}

What: Turn a natural-language query into up to 50 real TMDB movies (Gemini proposes titles+years; each is resolved against TMDB).

Auth: Bearer token required. Spends 1 daily AI action on success.

Body (JSON):

Field	Type	Required	Description	Example
query	string	yes	Natural-language search. Blank = 400.	`mind-bending sci-fi about dreams`
exclude_ids	array	no	TMDB ids on screen (Smart Reroll soft filter).	`[27205]`

Returns: data = [tmdbMovie] (raw TMDB objects, no reason) + sibling aiUsage.

**What:** Turn a natural-language query into up to 50 real TMDB movies (Gemini proposes titles+years; each is resolved against TMDB). **Auth:** Bearer token required. Spends 1 daily AI action on success. **Body (JSON):** | Field | Type | Required | Description | Example | |---|---|---|---|---| | query | string | yes | Natural-language search. Blank = 400. | `mind-bending sci-fi about dreams` | | exclude_ids | array | no | TMDB ids on screen (Smart Reroll soft filter). | `[27205]` | **Returns:** `data = [tmdbMovie]` (raw TMDB objects, no reason) + sibling `aiUsage`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

querystringRequired

Response

okboolean

datalist of objects

aiUsageobject

Errors

400

Bad Request Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error