{
  "item": [
    {
      "id": "8a779d4a-373d-4a07-9b64-38286630f257",
      "name": "Recognition",
      "description": {
        "content": "",
        "type": "text/plain"
      },
      "item": [
        {
          "id": "cfae2191-729c-431d-9a73-87aeca48c598",
          "name": "Identify a song from an audio clip (the first 12 seconds are analyzed; ≤10 MB)",
          "request": {
            "name": "Identify a song from an audio clip (the first 12 seconds are analyzed; ≤10 MB)",
            "description": {
              "content": "Standard music recognition. Send a file directly (multipart) or pass\na URL the AudD server downloads.\n\nOnly the first 12 seconds of the audio are analyzed. To recognize music\nbeyond the first 12 seconds of a file, use the enterprise endpoint\n(`POST https://enterprise.audd.io/`), which scans the whole file.",
              "type": "text/plain"
            },
            "url": {
              "protocol": "https",
              "path": [
                ""
              ],
              "host": [
                "api",
                "audd",
                "io"
              ],
              "query": [],
              "variable": []
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "multipart/form-data"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "method": "POST",
            "auth": null,
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "api_token",
                  "value": "<string>",
                  "type": "text",
                  "description": "(Required) From https://dashboard.audd.io."
                },
                {
                  "key": "url",
                  "value": "<uri>",
                  "type": "text",
                  "description": "HTTPS URL of the audio file. One of `url`, `file`, or `audio` is required."
                },
                {
                  "key": "file",
                  "type": "file",
                  "description": "Multipart file upload. One of `url`, `file`, or `audio` is required."
                },
                {
                  "key": "audio",
                  "value": "<string>",
                  "type": "text",
                  "description": "Base64-encoded audio. Discouraged; limited support."
                },
                {
                  "key": "return",
                  "value": "<string>",
                  "type": "text",
                  "description": "Comma-separated metadata identifiers. Valid values:\n`apple_music`, `spotify`, `deezer`, `napster`, `musicbrainz`.\n"
                },
                {
                  "key": "market",
                  "value": "<string>",
                  "type": "text",
                  "description": "ISO country code for Apple Music / iTunes / Spotify regional results. Default `us`."
                }
              ]
            }
          },
          "response": [
            {
              "id": "f2fd0d86-6c0c-45a6-8d54-8e084784bf95",
              "name": "Recognition processed. The response is a `success` payload (with\n`result` either populated or null when no match was found) or an\n`error` payload.\n",
              "originalRequest": {
                "url": {
                  "protocol": "https",
                  "path": [
                    ""
                  ],
                  "host": [
                    "api",
                    "audd",
                    "io"
                  ],
                  "query": [],
                  "variable": []
                },
                "header": [
                  {
                    "description": {
                      "content": "Added as a part of security scheme: apikey",
                      "type": "text/plain"
                    },
                    "key": "api_token",
                    "value": "<API Key>"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "body": {
                  "mode": "formdata",
                  "formdata": [
                    {
                      "description": {
                        "content": "(Required) From https://dashboard.audd.io.",
                        "type": "text/plain"
                      },
                      "key": "api_token",
                      "value": "<string>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "HTTPS URL of the audio file. One of `url`, `file`, or `audio` is required.",
                        "type": "text/plain"
                      },
                      "key": "url",
                      "value": "<uri>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Multipart file upload. One of `url`, `file`, or `audio` is required.",
                        "type": "text/plain"
                      },
                      "key": "file",
                      "value": "<binary>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Base64-encoded audio. Discouraged; limited support.",
                        "type": "text/plain"
                      },
                      "key": "audio",
                      "value": "<string>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Comma-separated metadata identifiers. Valid values:\n`apple_music`, `spotify`, `deezer`, `napster`, `musicbrainz`.\n",
                        "type": "text/plain"
                      },
                      "key": "return",
                      "value": "apple_music,spotify",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "ISO country code for Apple Music / iTunes / Spotify regional results. Default `us`.",
                        "type": "text/plain"
                      },
                      "key": "market",
                      "value": "us",
                      "type": "text"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"summary\": \"Public-DB match with apple_music + spotify + musicbrainz return\",\n  \"externalValue\": \"https://raw.githubusercontent.com/AudDMusic/audd-openapi/63414c0a939be98c9ec6d9c2eb5c4c7b92b60a51/fixtures/recognize_with_metadata.json\"\n}",
              "cookie": [],
              "_postman_previewlanguage": "json"
            }
          ],
          "event": [],
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          }
        },
        {
          "id": "846abf95-0a06-47c2-8b36-c0f580d9bc85",
          "name": "Same as POST recognize, but with parameters in the query string",
          "request": {
            "name": "Same as POST recognize, but with parameters in the query string",
            "description": {
              "content": "GET form of `/`. Useful for quick tests in a browser; POST is preferred.",
              "type": "text/plain"
            },
            "url": {
              "protocol": "https",
              "path": [
                ""
              ],
              "host": [
                "api",
                "audd",
                "io"
              ],
              "query": [
                {
                  "disabled": false,
                  "key": "api_token",
                  "value": "<string>",
                  "description": "(Required) "
                },
                {
                  "disabled": false,
                  "key": "url",
                  "value": "<uri>"
                },
                {
                  "disabled": false,
                  "key": "return",
                  "value": "<string>"
                },
                {
                  "disabled": false,
                  "key": "market",
                  "value": "<string>"
                }
              ],
              "variable": []
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "method": "GET",
            "auth": null
          },
          "response": [
            {
              "id": "5faccf5a-5204-457f-a16c-0f3bb39e0d02",
              "name": "Same shapes as POST.",
              "originalRequest": {
                "url": {
                  "protocol": "https",
                  "path": [
                    ""
                  ],
                  "host": [
                    "api",
                    "audd",
                    "io"
                  ],
                  "query": [
                    {
                      "key": "api_token",
                      "value": "<string>"
                    },
                    {
                      "key": "url",
                      "value": "<uri>"
                    },
                    {
                      "key": "return",
                      "value": "<string>"
                    },
                    {
                      "key": "market",
                      "value": "<string>"
                    }
                  ],
                  "variable": []
                },
                "header": [
                  {
                    "description": {
                      "content": "Added as a part of security scheme: apikey",
                      "type": "text/plain"
                    },
                    "key": "api_token",
                    "value": "<API Key>"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "method": "GET",
                "body": {}
              },
              "status": "OK",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"externalValue\": \"https://raw.githubusercontent.com/AudDMusic/audd-openapi/63414c0a939be98c9ec6d9c2eb5c4c7b92b60a51/fixtures/recognize_with_metadata.json\"\n}",
              "cookie": [],
              "_postman_previewlanguage": "json"
            }
          ],
          "event": [],
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          }
        },
        {
          "id": "25d5e2bc-7264-4ab5-a59c-816b8928277b",
          "name": "Recognize music in large audio/video files (hours- or days-long)",
          "request": {
            "name": "Recognize music in large audio/video files (hours- or days-long)",
            "description": {
              "content": "Enterprise endpoint. Send an HTTPS URL or a multipart file (streamed,\nno in-memory buffering needed). The endpoint chunks the audio into\n12-second segments and counts each scanned chunk as 1 request.\n\nSDKs default to a 1-hour read timeout for this endpoint and enable TCP\nkeepalive on the transport.",
              "type": "text/plain"
            },
            "url": {
              "protocol": "https",
              "path": [
                "enterprise",
                ""
              ],
              "host": [
                "enterprise",
                "audd",
                "io"
              ],
              "query": [],
              "variable": []
            },
            "header": [
              {
                "key": "Content-Type",
                "value": "multipart/form-data"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "method": "POST",
            "auth": null,
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "api_token",
                  "value": "<string>",
                  "type": "text",
                  "description": "(Required) "
                },
                {
                  "key": "url",
                  "value": "<uri>",
                  "type": "text",
                  "description": ""
                },
                {
                  "key": "file",
                  "type": "file",
                  "description": ""
                },
                {
                  "key": "return",
                  "value": "<string>",
                  "type": "text",
                  "description": "Comma-separated metadata identifiers. Same as the standard\nendpoint — but **Spotify is NOT supported** on enterprise.\n"
                },
                {
                  "key": "accurate_offsets",
                  "value": "<string>",
                  "type": "text",
                  "description": "When 'true', return per-match start/end offsets within each 12-second chunk. (This can only be one of true,false)"
                },
                {
                  "key": "skip",
                  "value": "<integer>",
                  "type": "text",
                  "description": "Number of 12-second chunks to skip after each scanned chunk."
                },
                {
                  "key": "every",
                  "value": "<integer>",
                  "type": "text",
                  "description": "Number of consecutive chunks to scan."
                },
                {
                  "key": "limit",
                  "value": "<integer>",
                  "type": "text",
                  "description": "Upper bound on the number of chunks to recognize. **Always\nset this in dev/test environments to control cost.**\n"
                },
                {
                  "key": "skip_first_seconds",
                  "value": "<integer>",
                  "type": "text",
                  "description": ""
                },
                {
                  "key": "use_timecode",
                  "value": "<string>",
                  "type": "text",
                  "description": "When 'true', use the `t`/`time_continue`/`start` URL parameter\nof the source URL as `skip_first_seconds`. Mutually exclusive\nwith `skip_first_seconds`.\n (This can only be one of true,false)"
                },
                {
                  "key": "response_type",
                  "value": "<string>",
                  "type": "text",
                  "description": "Output format. Default json. (This can only be one of json,csv)"
                }
              ]
            }
          },
          "response": [
            {
              "id": "ba7881ae-6a7f-436a-80e8-4a17b5326684",
              "name": "Recognition processed. JSON or CSV depending on `response_type`.",
              "originalRequest": {
                "url": {
                  "protocol": "https",
                  "path": [
                    "enterprise",
                    ""
                  ],
                  "host": [
                    "enterprise",
                    "audd",
                    "io"
                  ],
                  "query": [],
                  "variable": []
                },
                "header": [
                  {
                    "description": {
                      "content": "Added as a part of security scheme: apikey",
                      "type": "text/plain"
                    },
                    "key": "api_token",
                    "value": "<API Key>"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "body": {
                  "mode": "formdata",
                  "formdata": [
                    {
                      "description": {
                        "content": "(Required) ",
                        "type": "text/plain"
                      },
                      "key": "api_token",
                      "value": "<string>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "",
                        "type": "text/plain"
                      },
                      "key": "url",
                      "value": "<uri>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "",
                        "type": "text/plain"
                      },
                      "key": "file",
                      "value": "<binary>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Comma-separated metadata identifiers. Same as the standard\nendpoint — but **Spotify is NOT supported** on enterprise.\n",
                        "type": "text/plain"
                      },
                      "key": "return",
                      "value": "<string>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "When 'true', return per-match start/end offsets within each 12-second chunk. (This can only be one of true,false)",
                        "type": "text/plain"
                      },
                      "key": "accurate_offsets",
                      "value": "<string>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Number of 12-second chunks to skip after each scanned chunk.",
                        "type": "text/plain"
                      },
                      "key": "skip",
                      "value": "<integer>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Number of consecutive chunks to scan.",
                        "type": "text/plain"
                      },
                      "key": "every",
                      "value": "<integer>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Upper bound on the number of chunks to recognize. **Always\nset this in dev/test environments to control cost.**\n",
                        "type": "text/plain"
                      },
                      "key": "limit",
                      "value": "<integer>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "",
                        "type": "text/plain"
                      },
                      "key": "skip_first_seconds",
                      "value": "<integer>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "When 'true', use the `t`/`time_continue`/`start` URL parameter\nof the source URL as `skip_first_seconds`. Mutually exclusive\nwith `skip_first_seconds`.\n (This can only be one of true,false)",
                        "type": "text/plain"
                      },
                      "key": "use_timecode",
                      "value": "<string>",
                      "type": "text"
                    },
                    {
                      "description": {
                        "content": "Output format. Default json. (This can only be one of json,csv)",
                        "type": "text/plain"
                      },
                      "key": "response_type",
                      "value": "<string>",
                      "type": "text"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"externalValue\": \"https://raw.githubusercontent.com/AudDMusic/audd-openapi/63414c0a939be98c9ec6d9c2eb5c4c7b92b60a51/fixtures/enterprise_with_isrc_upc.json\"\n}",
              "cookie": [],
              "_postman_previewlanguage": "json"
            }
          ],
          "event": [],
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          }
        }
      ],
      "event": []
    }
  ],
  "event": [],
  "variable": [
    {
      "type": "string",
      "value": "https://api.audd.io",
      "key": "baseUrl"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "api_token"
      },
      {
        "key": "value",
        "value": "{{apiKey}}"
      },
      {
        "key": "in",
        "value": "header"
      }
    ]
  },
  "info": {
    "_postman_id": "f40d0e49-0938-4e7b-a4f5-33d0fcbe8082",
    "name": "AudD Music Recognition API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": {
      "content": "The AudD music recognition API identifies songs from short audio clips\n(`api.audd.io/`), large audio/video files (`enterprise.audd.io/`), and\nreal-time audio streams (callback or longpoll based on `api.audd.io/`).\n\nThis OpenAPI document is the canonical contract for the API. Every\nofficial AudD SDK validates its parser against the fixtures shipped\nalongside this spec.\n\nDocumentation: https://docs.audd.io\nGet an api_token: https://dashboard.audd.io\nSupport: api@audd.io\n\nContact Support:\n Name: AudD API Support\n Email: api@audd.io",
      "type": "text/plain"
    }
  }
}