Skip to content
Praxrr

Evaluate releases against custom formats

POST
/entity-testing/evaluate
curl --request POST \
  --url https://example.com/api/v1/entity-testing/evaluate \
  --header 'Content-Type: application/json' \
  --data '{ "databaseId": 1, "releases": [ { "id": 1, "title": "example", "type": "movie" } ] }'

Parses release titles and evaluates them against all custom formats in the specified database.

This endpoint:

  • Parses each release title to extract metadata (resolution, source, languages, etc.)
  • Matches regex patterns using .NET-compatible regex via the parser service
  • Evaluates each release against all custom formats in the database
  • Returns which custom formats match each release

Results are cached for performance - repeated requests with the same titles will be faster.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
databaseId

Database ID to use for custom format evaluation. If omitted, only parsing is performed (no CF matching).

integer
releases
required

Releases to evaluate

Array<object>
object
id
required

Release ID

integer
title
required

Release title to parse and evaluate

string
type
required

Type of media

string
Allowed values: movie series

Responses

Section titled “Responses”

200

Section titled “200”

Evaluation results

Media typeapplication/json
object
parserAvailable
required

Whether the parser service is available

boolean
evaluations
required

Evaluation results for each release

Array<object>
object
releaseId
required

Release ID

integer
title
required

Release title

string
parsed

Parsed release info (null if parsing failed)

object
source
required

Detected source (e.g., bluray, webdl, webrip)

string
resolution
required

Detected resolution (e.g., 1080p, 2160p)

string
modifier
required

Quality modifier (e.g., remux, none)

string
languages
required

Detected languages

Array<string>
releaseGroup

Detected release group

string
nullable
year
required

Detected year

integer
edition

Detected edition (e.g., Director’s Cut)

string
nullable
releaseType

Release type for series (single_episode, season_pack, etc.)

string
nullable
cfMatches
required

Map of custom format ID to whether it matches

object
key
additional properties
boolean
Examplegenerated
{
  "parserAvailable": true,
  "evaluations": [
    {
      "releaseId": 1,
      "title": "example",
      "parsed": {
        "source": "example",
        "resolution": "example",
        "modifier": "example",
        "languages": [
          "example"
        ],
        "releaseGroup": "example",
        "year": 1,
        "edition": "example",
        "releaseType": "example"
      },
      "cfMatches": {
        "additionalProperty": true
      }
    }
  ]
}

400

Section titled “400”

Invalid request (missing databaseId or releases)

500

Section titled “500”

Database cache not available