{"name":"ID Crate API","version":"v1","description":"API for querying your library, monitors and tracked tracks - and for creating tracks, link detections and monitors","authentication":{"api_key":"X-API-Key: mih_live_<your_key>","api_key_alt":"Authorization: ApiKey mih_live_<your_key>","jwt":"Authorization: Bearer <jwt>"},"endpoints":{"GET /api/v1/me":"Identity (sanity check that auth works)","GET /api/v1/library":"List local library tracks (?q=&format=&genre=&limit=&offset=)","GET /api/v1/library/:id":"Get a single library track","GET /api/v1/library/duplicates":"Detect duplicate groups in your library (?min_score=)","GET /api/v1/library/match":"Check whether a given artist+title is in your library (?artist=&title=)","GET /api/v1/tracks":"List tracked tracks (?status=&limit=&offset=)","GET /api/v1/tracks/:id":"Single tracked track including matches (with library_match info)","POST /api/v1/tracks":"Start hunting an ID: {artist_name, track_title, remix?, context?} - auto-scans in the background","POST /api/v1/detect":"Detect songs from a link: {url} (YouTube/Instagram/TikTok/SoundCloud…) - queued; poll the detect endpoints for results","GET /api/v1/detect":"List your recent detections (?limit=&offset=)","GET /api/v1/detect/:id":"Detection status + identified songs (status: pending → processing → completed)","GET /api/v1/monitors":"List monitors","GET /api/v1/monitors/:id":"Single monitor","GET /api/v1/monitors/:id/results":"Results found by a monitor (?include_dismissed=)","POST /api/v1/monitors":"Create a monitor: {type: artist|label|title|lyrics, value, platforms?} - auto-scans in the background"},"examples":{"track_a_song":"curl -X POST -H 'X-API-Key: mih_live_xxx' -H 'Content-Type: application/json' -d '{\"artist_name\":\"KH\",\"track_title\":\"Looking at Your Pager\"}' 'https://app.idcrate.co.uk/api/v1/tracks'","detect_from_link":"curl -X POST -H 'X-API-Key: mih_live_xxx' -H 'Content-Type: application/json' -d '{\"url\":\"https://www.instagram.com/reel/xyz/\"}' 'https://app.idcrate.co.uk/api/v1/detect'","check_library":"curl -H 'X-API-Key: mih_live_xxx' 'https://app.idcrate.co.uk/api/v1/library/match?artist=KH&title=Looking+at+Your+Pager'"},"notes":["All responses are JSON.","Pagination uses limit/offset; defaults limit=100, max 500.","Writes share the app limits: track/monitor counts per plan, and scan credits for detections - 402 when exhausted.","API keys need a Pro or Pro Plus plan. Requests per day: Pro 1,000, Pro Plus 10,000 - 429 when exceeded.","Detections run on a queue; poll GET /api/v1/detect/:id until status is completed (typically 1-3 minutes).","The `library_match` info on tracks/monitor results indicates whether a release is already in your local library.","API keys can be created at /settings → API Access. They show your prefix in the key list; the full key is shown only once at creation."]}