> For the complete documentation index, see [llms.txt](https://docs.acrcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acrcloud.com/reference/identification-api/metadata/humming.md).

# Humming

### JSON structure

```bash
{
    "metadata": {
        "humming": [
            {
                "external_ids": {

                },
                "title": "As Long As You Love Me",
                "artists": [
                    {
                        "name": "Backstreet Boys"
                    }
                ],
                "acrid": "2167d4c8d51d2944881be2fc128372f6",
                "external_metadata": {
                    "deezer": {
                        "album": {
                            "id": "76662",
                            "name": "Beautiful"
                        },
                        "artists": [
                            {
                                "name": "Backstreet Boys",
                                "id": "330"
                            }
                        ],
                        "track": {
                            "name": "As Long As You Love Me",
                            "id": "602351"
                        }
                    },
                    "spotify": {
                        "album": {
                            "id": "1c7PDfu5CEUWE5M79pSHeD",
                            "name": "Race For Life The Official Soundtrack 2011"
                        },
                        "artists": [
                            {
                                "name": "Backstreet Boys",
                                "id": "5rSXSAkZ67PYJSvpUpkOr7"
                            }
                        ],
                        "track": {
                            "name": "As Long as You Love Me",
                            "id": "11Oj3hu53ZVOqzcw35elvh"
                        }
                    },
                    "youtube": {
                        "vid": "0Gl2QnHNpkA"
                    }
                },
                "album": {
                    "name": "Beautiful"
                },
                "score": "0.88"
            },
            {
                "external_ids": {

                },
                "external_metadata": {

                },
                "score": "0.87",
                "title": "As Long As You Love Me",
                "duration_ms": "213093",
                "genres": [
                    {
                        "name": "Pop"
                    }
                ],
                "acrid": "d4c6ff541580d20c7f35ef4a390eac41",
                "album": {
                    "name": "Beautiful"
                },
                "artists": [
                    {
                        "name": "Backstreet Boys"
                    }
                ]
            },
            {
                "external_ids": {

                },
                "title": "If You Love Me",
                "artists": [
                    {
                        "name": "Kys"
                    }
                ],
                "external_metadata": {

                },
                "acrid": "103fc2e9df3712151bb9601189fe3751",
                "album": {
                    "name": ""
                },
                "score": "0.67"
            },
            {
                "external_ids": {

                },
                "external_metadata": {

                },
                "score": "0.64",
                "title": "Hurt (Album Version)",
                "duration_ms": "243626",
                "genres": [
                    {
                        "name": "Pop"
                    }
                ],
                "acrid": "2c7939c273ac5b83922b0d7be45d0743",
                "album": {
                    "name": "Hurt"
                },
                "artists": [
                    {
                        "name": "Christina Aguilera"
                    }
                ]
            },
            {
                "external_ids": {

                },
                "title": "打开爱",
                "artists": [
                    {
                        "name": "Vee"
                    }
                ],
                "external_metadata": {

                },
                "acrid": "7c23c2f6b9d7c8eb5cc0b877e1782691",
                "album": {
                    "name": ""
                },
                "score": "0.62"
            }
        ]
    },
    "status": {
        "msg": "Success",
        "version": "1.0",
        "code": 0
    }
}
```

### Metadata fields

| Name               | Description                                   |
| ------------------ | --------------------------------------------- |
| humming            | Humming Recognition fields                    |
| acrid              | ACRCloud unique identifier                    |
| timestamp\_utc     | Server time of sending results, UTC time zone |
| score              | Humming score                                 |
| title              | Track title                                   |
| album              | Album fields                                  |
| id                 | Identifier of the artists or album            |
| name               | Name of the artists or album                  |
| artists            | Artists fields                                |
| duration\_ms       | Duration of the track in millisecond          |
| play\_offset\_ms   | Position of the recognition in millisecond    |
| external\_ids      | External standard code                        |
| isrc               | ISRC code                                     |
| upc                | UPC code                                      |
| external\_metadata | External 3rd party IDs and metadata           |
| track              | Track fields                                  |
| genres             | Genres fields                                 |

{% hint style="info" %}
Only ACRID, Title, Artist and Score are required fields.
{% endhint %}