# Pex SDK - Release Notes

<details>

<summary>Version 4.7.0</summary>

#### **Search: Pex Registry Updates**

**Search by ISRC**

* In addition to performing a search with a fingerprint generated from a media file, you can now also initiate a search using an ISRC. If a corresponding asset can be located for the ISRC, the search will initiate and you will receive the same standard search response you would get from a fingerprint-based search

This allows you to search the Pex Registry when you don’t have a source media file but do have a known identifier.

#### **Search: Custom Database Updates**

**Retrieve status of a particular custom database asset**

* A new "Get Entry" function lets you retrieve fingerprint information and status for a specific asset in your custom database. Returned data includes:
  * Fingerprint Types (Audio, Melody, Phonetic)
    * This will inform what fingerprint types you have ingested for the corresponding asset
  * Status (Active, Pending)
    * Active: Fingerprint is live and searchable
    * Pending: Fingerprint is processing and will be searchable soon

This provides better visibility into ingestion progress and fingerprint availability for a specific asset.

**List Entries enhancement**

* The existing "List Entries" functionality has been updated so that in addition to a list of assets that are currently ingested in your custom database, it will return each asset's corresponding status (active, pending)

This provides better visibility into the status of your custom database as a whole.

#### **Other Updates**

**CLI Helper Tool**

* A lightweight CLI tool is now provided for basic one-off searches against the Pex Registry and your Custom Database. It can also handle basic catalog management functions for Custom Database clients. It can be run via the `pexsearch` command

*In order to access these new features, you will need to:*

* *Update your language bindings to the 4.7.0 release. Please see* [Language Bindings](/search/sdk-integration/getting-started/language-bindings.md) *for more details.*
* *Install the latest version of the SDK core library to ensure compatibility. Please see* [Core Library (SDK)](/search/sdk-integration/getting-started/core-library-sdk.md) *for more details.*

</details>

<details>

<summary>Version 4.6.1</summary>

* **Enhanced Cover Song Detection**
  * Melody lookups can now include an additional **phonetic fingerprint** in the same request.
  * Detection can identify matches based on either melody or phonetic similarity to assets in the Pex registry.
  * More details can be found at [Search Types & Use Cases](/search/faq/search-types-and-use-cases.md)
* **Content Classification**
  * Analyze a query file to detect if it contains any **music**, **speech**, and/or **silence** segments.
  * Can be combined with an audio lookup to identify music content that contain no matches to any commercial tracks in the Pex registry
  * More details can be found at [Content Classification](/search/faq/content-classification.md)
* **Melody Matching Improvements**
  * Optimizations to the melody matching (approximately 35% higher true positive rate)

In order to access these new features, update your language bindings to the 4.6.1 release. Please see [Language Bindings](/search/sdk-integration/getting-started/language-bindings.md)for more details.

</details>

<details>

<summary>Version 4.5.0</summary>

This version includes internal updates to prepare for upcoming new features

</details>

<details>

<summary>Version 4.4.0</summary>

* Archive Functionality (for Search: Custom Database clients) - allows client to remove a fingerprint from their custom database, so it will no longer be available for matching. For more details on using this functionality, please visit [Basic Usage](/search/sdk-integration/search-custom-database/basic-usage.md)
* Database List Functionality (for Search: Custom Database clients) - allows client to retrieve a list of what fingerprints (via provided\_id) are currently in their custom database. For more details on using this functionality, please visit [Basic Usage](/search/sdk-integration/search-custom-database/basic-usage.md)
* Improvements made to the "Identify Music" search type for audio matching for DJ mixes, mashups, and long compilations.
* Better Logging Information - Additional information added to the logs to assist with troubleshooting issues
* Bug Fix: Fix for SDK occasionally erroring out after long period of connectivity with no activity

In order to access these new features, update your language bindings to the 4.4.0 release. Please see [Language Bindings](/search/sdk-integration/getting-started/language-bindings.md)for more details.

</details>

<details>

<summary>Version 4.2.1 </summary>

* A `confidence` value is now returned for every match segment in the search response. You can find it in the `segments` object in the `match_details` section.
* For more details, visit the **Search Response** page for [Search: Pex Registry](/search/sdk-integration/search-pex-registry/search-response.md) or [Search: Custom Database](/search/sdk-integration/search-custom-database.md)
* Bug Fix: The SDK will no longer return an invalid input error when attempting to create an audio fingerprint from a file that contains no or low level audio&#x20;

</details>

<details>

<summary>Version 4.1.2</summary>

* When performing an audio or melody search against the Pex Registry, you can now also designate a specific **search type** to perform: an "identify music" search or a "find matches" search. A `identify music` search allows you to check any media file for copyrighted music. A `find matches` search allows you to find commercially distributed versions of your own copyrighted asset. To designate a search type, you will pass an additional parameter when creating the search request. Note: if no search type is designated, the search will default to the "identify music" search type.
* For more details on how to prepare the search request and designate a search type, visit: [Basic Usage](/search/sdk-integration/search-pex-registry/basic-usage.md#initiate-search)
* For more details on the two search types, visit: [Search Types & Use Cases](/search/faq/search-types-and-use-cases.md)

In order to access these new features, update your language bindings to the 4.1.2 release. Please see [Language Bindings](/search/sdk-integration/getting-started/language-bindings.md)for more details.

</details>

<details>

<summary>Version 4.0.10</summary>

* When searching against the Pex Registry, DSP links (if available) are now returned for matched assets in the search response. You can find it in the `dsp` object in the `asset` section.
* For more details, visit the **Search Response** page for [Search: Pex Registry](/search/sdk-integration/search-pex-registry/search-response.md)

</details>

<details>

<summary>Version 4.0.3</summary>

* When searching against the Pex Registry, the release date is now returned for the album associated with the matched asset. You can find it in the `release_date` object in the `asset` section.
* For more details, visit the **Search Response** page for [Search: Pex Registry](/search/sdk-integration/search-pex-registry/search-response.md)

</details>

<details>

<summary>Version 4.0.0</summary>

* The search response has been expanded to include more asset metadata and match details for a matched asset.
  * Asset metadata now includes: ISRC, Title, Subtitle, Artist, Album/Release Name, Barcode, Label, Distributor
  * Match details now includes: Query Match Duration, Query Match %, Asset Match Duration, Asset Match %
  * Match segment details now includes: Query Start, Query End, Asset Start, Asset End, Pitch Modification, Speed Modification, Transposition information
* For more details, visit the **Search Response** page for [Search: Pex Registry](/search/sdk-integration/search-pex-registry/search-response.md) or [Search: Custom Database](/search/sdk-integration/search-custom-database.md)

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pex.com/search/changelog/pex-sdk-release-notes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
