{"id":16621752,"url":"https://github.com/lewdhutao/lyrics-api","last_synced_at":"2025-12-25T01:11:15.823Z","repository":{"id":241520005,"uuid":"804422724","full_name":"LewdHuTao/lyrics-api","owner":"LewdHuTao","description":"A simple lyrics api to fetch lyrics from Musixmatch, and YouTube","archived":false,"fork":false,"pushed_at":"2025-12-13T19:27:48.000Z","size":273,"stargazers_count":41,"open_issues_count":9,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-14T07:19:17.741Z","etag":null,"topics":["api","lyrics","lyrics-api","lyrics-fetcher","lyrics-finder","typescript"],"latest_commit_sha":null,"homepage":"https://lyrics.lewdhutao.my.eu.org/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LewdHuTao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-22T14:57:45.000Z","updated_at":"2025-12-08T14:20:44.000Z","dependencies_parsed_at":"2024-05-28T21:29:30.131Z","dependency_job_id":"57e3cc54-7233-435a-8329-55dcfd11180e","html_url":"https://github.com/LewdHuTao/lyrics-api","commit_stats":null,"previous_names":["lewdhutao/lyrics-api"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/LewdHuTao/lyrics-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LewdHuTao%2Flyrics-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LewdHuTao%2Flyrics-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LewdHuTao%2Flyrics-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LewdHuTao%2Flyrics-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LewdHuTao","download_url":"https://codeload.github.com/LewdHuTao/lyrics-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LewdHuTao%2Flyrics-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28015085,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","lyrics","lyrics-api","lyrics-fetcher","lyrics-finder","typescript"],"created_at":"2024-10-12T02:48:20.353Z","updated_at":"2025-12-25T01:11:15.818Z","avatar_url":"https://github.com/LewdHuTao.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lyrics API\n\nA simple lyrics API that fetches lyrics from sources like Musixmatch and YouTube Music.\n\n## Getting Started\n\n### Requirements\n\n- Node.js 18 or higher\n\n### Installation\n\n```bash\ngit clone https://github.com/lewdhutao/lyrics-api\ncd lyrics-api\nnpm install\n```\n\n### Running\n\n```bash\nnpm run dev\n```\n\nOnce running, open: `http://localhost:3000`\n\n---\n\n## API Endpoints\n\n### `/v2/musixmatch/lyrics`\n\nSearch for lyrics using Musixmatch.\n\n**Method:** `GET`\n\n**Query Parameters:**\n- `trackId` (optional): Track Id\n- `title` (optional): Song title\n- `artist` (optional): Artist name\n\u003e ⚠️ **Note:** At least one of `title` or `trackid` must be provided. Both cannot be null or empty.\n\n**Examples:**\n\n```\nGET /v2/musixmatch/lyrics?trackid=349001048\nGET /v2/musixmatch/lyrics?title=back%20to%20friends\nGET /v2/musixmatch/lyrics?title=back%20to%20friends\u0026artist=sombr\n```\n\n### `/v2/musixmatch/recommendation`\n\nSearch for song recommendations.\n\n**Method:** `GET`\n\n**Query Parameters:**\n- `country` (optional): Country code.\n\n**Examples:**\n\n```\nGET /v2/musixmatch/recommendation\nGET /v2/musixmatch/recommendation?country=us\n```\nRefer to [ISO_3166-1_alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) for full country codes.\n\n### `/v2/musixmatch/metadata`\n\nRetrieve metadata for up to five songs matching the given title.\n\n**Method:** `GET`\n\n**Query Parameters:**\n- `title` (required): Song title.\n\n**Examples:**\n\n```\nGET /v2/musixmatch/metadata?title=Maps\n```\n\n---\n\n### `/v2/youtube/lyrics`\n\nSearch for lyrics using YouTube Music.\n\n**Method:** `GET`\n\n**Query Parameters:**\n- `trackId` (optional): Track Id\n- `title` (optional): Song title\n- `artist` (optional): Artist name\n\u003e ⚠️ **Note:** At least one of `title` or `trackid` must be provided. Both cannot be null or empty.\n\n**Examples:**\n\n```\nGET /v2/youtube/lyrics?trackid=dbEY-JVHJWg\nGET /v2/youtube/lyrics?title=back%20to%20friends\nGET /v2/youtube/lyrics?title=back%20to%20friends\u0026artist=sombr\n```\n\n---\n\n## Example JSON Response\n\n```json\n{\n  \"data\": {\n    \"artistName\": \"Sombr\",\n    \"trackName\": \"Back to Friends\",\n    \"trackId\": \"dbEY-JVHJWg\",\n    \"searchEngine\": \"YouTube\",\n    \"artworkUrl\": \"https://example.com/art.jpg\",\n    \"lyrics\": \"Touch my body tender\\n'Cause the feeling makes me weak...\"\n  },\n  \"metadata\": {\n    \"apiVersion\": \"2.0\"\n  }\n}\n```\n\n---\n\n## Translated Lyrics\n### Note: Translated lyrics are only available for Musixmatch\n\n**Examples:**\n\n```\nGET /v2/musixmatch/lyrics?trackid={trackId}\u0026translate={lang_code}\nGET /v2/musixmatch/lyrics?title={title}\u0026translate={lang_code}\nGET /v2/musixmatch/lyrics?title={title}\u0026artist={artist}\u0026translate={lang_code}\n```\n\n**Supported Languages**\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand full list\u003c/summary\u003e\n\n| Language Name    | ISO-1 | ISO-3 |\n|------------------|----|-----|\n| Afar             | aa | aar |\n| Abkhazian        | ab | abk |\n| Afrikaans        | af | afr |\n| Akan             | ak | aka |\n| Albanian         | sq | sqi |\n| Amharic          | am | amh |\n| Arabic           | ar | ara |\n| Aragonese        | an | arg |\n| Armenian         | hy | hye |\n| Assamese         | as | asm |\n| Asturian         | a3 | ast |\n| Avaric           | av | ava |\n| Avestan          | ae | ave |\n| Aymara           | ay | aym |\n| Azerbaijani      | az | aze |\n| Bashkir          | ba | bak |\n| Bambara          | bm | bam |\n| Basque           | eu | eus |\n| Belarusian       | be | bel |\n| Bengali          | bn | ben |\n| Bihari Languages | bh | bh0 |\n| Bislama          | bi | bis |\n| Bosnian          | bs | bos |\n| Breton           | br | bre |\n| Bulgarian        | bg | bul |\n| Burmese          | my | mya |\n| Catalan          | ca | cat |\n| Cebuano          | c2 | ceb |\n| Chamorro         | ch | cha |\n| Chechen          | ce | che |\n| Chinese (Simplified) | zh | zho |\n| Church Slavic    | cu | chu |\n| Chuvash          | cv | chv |\n| Cornish          | kw | cor |\n| Corsican         | co | cos |\n| Czech            | cs | ces |\n| Danish           | da | dan |\n| Divehi           | dv | div |\n| Dutch            | nl | nld |\n| Dzongkha         | dz | dzo |\n| English          | en | eng |\n| Esperanto        | eo | epo |\n| Estonian         | et | est |\n| Fijian           | fj | fij |\n| Filipino         | f1 | fil |\n| Finnish          | fi | fin |\n| French           | fr | fra |\n| German           | de | deu |\n| Greek            | el | ell |\n| Gujarati         | gu | guj |\n| Hebrew           | he | heb |\n| Hindi            | hi | hin |\n| Hungarian        | hu | hun |\n| Icelandic        | is | isl |\n| Indonesian       | id | ind |\n| Italian          | it | ita |\n| Japanese         | ja | jpn |\n| Japanese (Romanized) | rj | rja |\n| Korean**         | ko | kor |\n| Korean (Romanized) | rk | rkr |\n| Khmer, Central   | km | khm |\n| Lao              | lo | lao |\n| Latin            | la | lat |\n| Lithuanian       | lt | lit |\n| Macedonian       | mk | mkd |\n| Malay            | ms | msa |\n| Malayalam        | ml | mal |\n| Malayalam (Romanized) | m8 | ma8 |\n| Marathi          | mr | mar |\n| Marathi (Romanized) | m9 | ma9 |\n| Mongolian        | mn | mon |\n| Nepali           | ne | nep |\n| Nepali (Romanized) | n5 | ne5 |\n| Norwegian        | no | nor |\n| Oriya            | or | ori |\n| Oriya (Romanized) | o1 | or1 |\n| Panjabi          | pa | pan |\n| Panjabi (Romanized) | p5 | pa5 |\n| Persian          | fa | fas |\n| Polish           | pl | pol |\n| Portuguese       | pt | por |\n| Romanian         | ro | ron |\n| Russian       | ru | rus |\n| Russian (Romanized) | r2 | ru2 |\n| Sanskrit         | sa | san |\n| Sanskrit (Romanized) | s4 | sa4 |\n| Serbian          | sr | srp |\n| Sinhala          | si | sin |\n| Slovak           | sk | slk |\n| Slovenian        | sl | slv |\n| Spanish          | es | spa |\n| Swahili          | sw | swa |\n| Swedish          | sv | swe |\n| Tamil            | ta | tam |\n| Tamil (Romanized) | t2 | ta2 |\n| Telugu           | te | tel |\n| Telugu (Romanized) | t3 | te3 |\n| Thai             | th | tha |\n| Thai (Romanized) | t4 | tr1 |\n| Turkish          | tr | tur |\n| Ukrainian        | uk | ukr |\n| Urdu             | ur | urd |\n| Urdu (Romanized) | u1 | ur1 |\n| Uzbek            | uz | uzb |\n| Vietnamese       | vi | vie |\n| Welsh            | cy | cym |\n| Xhosa            | xh | xho |\n| Yoruba           | yo | yor |\n| Zulu             | zu | zul |\n\n\u003c/details\u003e\n\n---\n\n## Status Codes\n\n| Code | Description            |\n|------|------------------------|\n| 200  | OK                     |\n| 400  | Bad Request            |\n| 404  | Not Found              |\n| 429  | Too Many Requests      |\n| 500  | Internal Server Error  |\n\n## Public API Demo\n\nhttps://lyrics.lewdhutao.my.eu.org\n\n---\n\n## Deploy to Vercel\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/import/project?template=https://github.com/LewdHuTao/lyrics-api\u0026env[API_URL]=http://localhost:8888\u0026env[NODE_ENV]=production\u0026env[RATELIMIT]=false)\n\n---\n\n## License\nISC © 2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flewdhutao%2Flyrics-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flewdhutao%2Flyrics-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flewdhutao%2Flyrics-api/lists"}