Sign Up

temperature-blanket.com uses RapidAPI for delivering the Yarn Colorways API.

Access to the API requires users to send their RapidAPI key along with every request. Create an account and subscribe to one of the plans to get a key for accessing the Yarn Colorways API. The free plan allows up to 500 calls per month.

Choosing a Version

Unless you have a specific reason to use a previous version, you should use the latest (v3) version. Selecting a version below will update this page to show the relevant documentation.

This version was introduced on 4/9/2026. Compared to the previous version, the changes are:

• For the Colorways endpoint, the default behavior of the name parameter is now 'contains' instead of 'exact match'. So for example, a request with ?name=blue will now return all colorways with 'blue' in the name, instead of only colorways with the exact name 'blue'.
• The Find Yarn by Color endpoint also accepts a name parameter to filter the results by colorway name.
• The Colorways and Find Yarn by Color endpoints accept an optional exactName parameter for exact matching.
• The Colorways, Find Yarn by Color, and Yarns endpoints now return unavailable and unavailableDate if the yarn link is no longer available.

Making a Request

This is the base URL for all endpoints:

https://yarn-colorways.p.rapidapi.com/v3

Include the following headers:

"X-RapidAPI-Key": 'your-rapidapi-key',
"X-RapidAPI-Host": "yarn-colorways.p.rapidapi.com"

All requests should use the GET method.

Reading a Response

A successful response will return a JSON object that contains two properties: meta and data. The meta object provides general information about the data. The data property is an array that contains the actual data output.

Here's an example of a successful response from the /colorways endpoint.

{ "meta": { "limit": 50, // the maxmimum number of results "offset": 0, // the starting index of the results "total": 6743 // the total number of results }, "data": [ { "name": "Olive" "hex": "#665e3f" "brandId": "bernat" "brandName": "Bernat" "yarnId": "blanket" "yarnName": "Blanket" "yarnWeightId": 'sb' "dateAccessed": "2024-01-19" "href": "https://www.yarnspirations.com/products/bernat-blanket-yarn-300g-10-5oz-1" }, ... ] }

If you encouter an error, look at the Status Codes to find out why.

Status Codes

Responses will have one of the following status codes: