An API for embroidery floss colours and numbers. Currently includes the "basic" DMC colours. Search by name, DMC number, or hex code. CORS is enabled.
See it at https://embroidery-floss-api.herokuapp.com/
The base url is https://embroidery-floss-api.herokuapp.com/api/
For a list of all flosses: https://embroidery-floss-api.herokuapp.com/api/full
To search for a DMC number: /number/<number>
Eg: https://embroidery-floss-api.herokuapp.com/api/number/912
To search by name: /name/<name>
Eg: https://embroidery-floss-api.herokuapp.com/api/name/red
Exact matches are prioritised: if an exact match is found, it will return only the exact match. If an exact match is not found, it will return any colours with names that include the search term.
If you want all the matching flosses even when an exact match is found, add a query parameter: /name/<name>?searchtype=all
Eg: https://embroidery-floss-api.herokuapp.com/api/name/red?searchtype=all
Will currently only work for exact hex code matches.. Hex codes should not include the #.
To search by hex code: /api/hex/<hex code>
Eg: https://embroidery-floss-api.herokuapp.com/api/hex/393068
- Expanded floss list: add data for non-"basic" DMC colours, Anchor, Kreinik, etc. Contributions very welcome - this issue has more details. You don't need to be a technical person to help with this!
- Hex colour matching: search by hex colour and find closest matches. Hex colour search currently only returns exact matches.
- Colour family search: return all floss within a colour family. Searching by colour will only return flosses with the searched colour in the name - eg searching "purple" won't return anything, since the purple colours are all called things like "lavender". Will require some decisions about which categories to include, how to handle overlapping colours (eg is "teal" blue, green, or it's own category?), and probably an amount of manual data entry.