Common

finder

Returns TMDB id results after Keytalk input. Multiple Keytalk inputs are possible.

get

💡 https://2xg3kcbbw6.execute-api.us-west-1.amazonaws.com/dev/finder/{vertical}?start=0&rows=10&keytalks={keytalk1},{keytalk2}

Header

Field	Type	Description
x-api-key	String	api key Default value: 9Og722RZv26s1IMUobdSv3mtEpbpe4G43f9inT4R
token	String	token Default value: Token issued by the Keytalk AI.

• Header-Example:

{
  "x-api-key": "aV8FZtOXsQ2zqs3w85JBuasA0j0dEmIm9QrzNHod",
  "Content-Type": "application/json",
  "Access-Control-Allow-Origin": "*",
  "token": "Token issued by the Keytalk AI."
}

Parameter

Field	Type	Description
vertical	String	type Allowed values: “movie”, “tvshow”
start	Number	default: 0
rows	Number	default: 10
keytalks	String	Delimiter is comma(,) Allowed values: “,”

• Success-Response:

{
  "total": 112151,
  "rows": 3,
  "start": 0,
  "data": [
    {
      "id": "158204",
      "title": "Garden: Takamine-ke no Nirinka The Animation"
    },
    {
      "id": "66732",
      "title": "Stranger Things"
    },
    {
      "id": "76479",
      "title": "The Boys"
    }
  ]
}

Keytalk

Returns Keytalk list sorted by category

get

💡 https://2xg3kcbbw6.execute-api.us-west-1.amazonaws.com/dev/keytalks?vertical={vertical}

Header

Field	Type	Description
x-api-key	String	api key Default value: 9Og722RZv26s1IMUobdSv3mtEpbpe4G43f9inT4R
token	String	token Default value: Token issued by the Keytalk AI.

• Header-Example:

{
  "x-api-key": "aV8FZtOXsQ2zqs3w85JBuasA0j0dEmIm9QrzNHod",
  "Content-Type": "application/json",
  "Access-Control-Allow-Origin": "*",
  "token": "Token issued by the Keytalk AI."
}

Parameter

Field	Type	Description
vertical	String	Allowed values: movie, tvshow

• Success-Response:

{
    "keytalks": {
        "Genre": [{
            "kf_pk": 14022,
            "kf_name": "Action",
            "kf_type": "meta",
            "kf_order": 1
        },
        {
            "kf_pk": 14023,
            "kf_name": "Adventure",
        ],
    "MMPA Rating": [
        {
            "kf_pk": 14042,
            "kf_name": "G",
            "kf_type": "meta",
            "kf_order": 1
        },
        {
            "kf_pk": 14043,
            "kf_name": "PG",
            "kf_type": "meta",
            "kf_order": 2
        }]
    }
}

• 400 Error-Response:

{
  "status_message": "Bad Request"
}