By Location and Language

Our product content distributed by the API is localized by both location and language to ensure that users receive the most relevant information. We strongly recommend using this method to retrieve product data as the entire product list will be exposed in the JSON file for your language and location. This assures you are getting all the relevant content even if you choose not to display certain parts of it at this time.

US/English Endpoint:

https://www.crown.com/graphql/execute.json/product-api/get-product-by-locale;countryAndLanguage=us-en

Referencing the Endpoint using the URL above will load all the products and their information into the JSON output for US/English. This file size is currently 262KB for all the information, and only needs to be referenced once per page load. So, referencing the entire Endpoint's data should not cause any abnormal page load issues due to file size or complexity.

The first part of interacting with the Crown PRR API, will be constructing the data-path URL to gather our data. This can be done in a few different ways, let's look at how to do it via location and language.

The final result would be:

▲

By Specific Product

Our product content distributed by the API is localized by both location and language to ensure that users receive the most relevant information. We strongly recommend using this method to retrieve product data as the entire product list will be exposed in the JSON file for your language and location. This assures you are getting all the relevant content even if you choose not to display certain parts of it at this time. However, you can also target a specific product if you wish to only load that product's information. This is a better use of resources for a page on your site that features just that one product.

To request the endpoint's JSON to only contain information about the one specific product, we will first need to view the full JSON file for your location and language and locate the product's .productBaseCode and use it to reconstruct the URL data-path.

1. Load the full US-EN endpoint:
• https://www.crown.com/graphql/execute.json/product-api/get-product-by-locale;countryAndLanguage=us-en
2. Scan through the output and look for the product you require (CTRL+F to help search). Locate the values for the following keys:
• countryAndLanguage
• productCategory
• productBaseCode
3. Iterate through each instance as every product will have its own specific productBaseCode until you have found the product you want to focus on.
4. Record the values for the keys:
• countryAndLanguage
• productCategory
• productBaseCode
5. Construct the URL to target that specific product using the following format:
   Note: the URL reverses the language and location from the countryAndLanguage key to form the end of the URL path. An example is a value of "us-en" for the countryAndLanguage and "en-us" for the URL path.

   https://www.crown.com/graphql/execute.json/product-api/get-product-by-path;path=/content/dam/products/[productCategory]/[productBaseCode]/[productBaseCode]/[countryAndLanguage(reversed)]/[productBaseCode]-[countryAndLanguage(reversed)]-base

For example, the data-path URL for the SP-1500 Forklift would be:

• countryAndLanguage: us-en
• productCategory: Forklifts
• productBaseCode: SP-1500

The final result would be:

Visiting that endpoint URL in your browser you will see the same JSON construction as the full Endpoint, but this one will only include information about the SP-1500.

This method is recommended for pages that are dedicated to a single product as it will reduce the amount of data being transferred and parsed on your page.

▲

Grouping by Product Category

Our product content distributed by the API is categorized by several key/value pairs in the endpoint’s JSON file that you can reference. Using the data-path for your Language and Location, you can then further isolate what is displayed with local JavaScript (or your parsing language of choice for JSON).

Since JSON is designed to be human-readable, you can reference the endpoint to find a key/value pair that you’d like to use to parse out the specific products you wish to share.

A primary example of that type of parsing and sorting would be based on the “Product Category”. This would allow you to display all of our products that are in one category (ex: Counterbalance).

The key to reference in your code to extract that from the JSON would be localizedProductFeature.forkliftType

Available categories (.forkliftType):

• Automated
• Electric Counterbalance Forklifts
• IC Counterbalance Forklifts
• Man Up Order Pickers
• Pallet Trucks
• Reach Trucks
• Stackers

You can categorize or sub-categorize on drive-train power type as well with localizedProductFeature.powerType

Available powertrains (.powerType):

• Diesel
• Electric
• LPG
• Manual

Sample JavaScript

The script below is a sample to be used for testing and to help to understand how best to parse data out of the API. This is not meant to be the only code you need. The web developers for the site that will utilize our API can refer to this and expand or create their own unique code for your unique site.

/*
  Crown PRR API – simple filter example
  - Fetches the full product list for US English
  - Filters to forkliftType === "Stackers" (case-insensitive)
  - Prints a few fields into #data-container
*/

const url = "https://www.crown.com/graphql/execute.json/product-api/get-product-by-locale;countryAndLanguage=us-en";
const targetType = "Stackers"; // <-- change this if you want a different category

const container = document.getElementById("data-container");
if (container) container.textContent = "Loading data...";

fetch(url)
  .then(res => {
    if (!res.ok) throw new Error("Network/API error");
    return res.json();
  })
  .then(json => {
    // Safely grab the items array (fallback to empty array if anything is missing)
    const items = json?.data?.baseProductList?.items ?? [];

    // Filter by forklift type (case-insensitive)
    const matches = items.filter(p => {
      const type = p?.localizedProductFeature?.forkliftType;
      return typeof type === "string" && type.toLowerCase() === targetType.toLowerCase();
    });

    // Build a simple HTML output
    const html = matches.map(p => {
      const seriesId = p?.productSeries?.seriesId ?? "(no seriesId)";
      const type     = p?.localizedProductFeature?.forkliftType ?? "(no type)";
      const power    = p?.localizedProductFeature?.powerType ?? "(no powerType)";

      return `
        <div>
          <p><strong>Series ID:</strong> ${seriesId}</p>
          <p><strong>Forklift Type:</strong> ${type}</p>
          <p><strong>Power Type:</strong> ${power}</p>
          <hr>
        </div>
      `;
    }).join("");

    // Render results (or a friendly message if none)
    if (container) {
      container.innerHTML = html || `No matching products found for "${targetType}".`;
    }
  })
  .catch(err => {
    console.error("Error fetching API data:", err);
    if (container) container.textContent = "Error loading data.";
  });

▲

Sample HTML

The HTML provided below is a sample that can be used if you want to have the JavaScript in a separate JS file. The sample JavaScript (above) will target the various HTML tag ID strings to place the code output where it needs to go.

Again, this code is being provided as a sample and could even be copy and pasted into your own web environment, possibly with slight changes, for testing. Your site's developers will know how best to code for and implement the end result of the API's endpoint JSON.

<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>Crown Dealer API | Filter Example</title>
	<script src="example.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
</head>
<body>
	<!-- Data output container -->
	<div id="data-container" class="product-detail-inner-wrapper">
		Loading data...
	</div>

	<div class="scroll-back-to-top">
		<a href="#navigation">Scroll Back to Top ^</a>
	</div>

	<!-- Link to external JS file -->
	<script src="script-filter-example.js"></script>
</body>
</html>