• PXM Catalogs/
    PXM Catalog Latest Releases API for Administrators/
    Get a Node

    Get a Node in the Latest Release

    GET Get a Node from a Catalog Release

    https://api.moltin.com/pcm/catalogs/:catalogId/releases/latest/nodes/:nodeId
    

    Returns a node from a published catalog.

    Currently, published catalogs are limited to the current release and two releases prior to the current release.

    Use releaseId to delete a specific release than the latest catalog.

    You can see the parent nodes a node is associated with in the bread_crumb metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. For more information, see EP PXM Catalogs API.

    You can curate the products in a node. Product curation allows you to promote specific products within each of your nodes, enabling you to create unique product collections in your storefront. You can do this using a filter. See Filtering.

    Parameters

    Path parameters

    NameRequiredTypeDescription
    catalogIdRequiredstringThe unique identifier of the catalog.
    releaseIdRequiredstringThe unique identifier of a published version of the catalog or latestPublished for the most recently fully published catalog. You should use latestPublished in your storefront to make sure you have the latest fully published version of a catalog.
    nodeIdRequiredstringThe unique identifier of a hierarchy node.

    Headers

    NameRequiredTypeDescription
    AuthorizationRequiredstringThe Bearer token to grant access to the API. Implicit Bearer token only returns products with live status; products with draft status are not included.

    Filtering

    The following table describes the supported operator and attributes when applying filters to the Get a Node from a Catalog Release endpoint:

    OperatorDescriptionAttributes
    inReturns the specified product IDs in the order specified in the string. Wildcards are supported. For example, /catalogs/6dff977e-a8c4-4e32-8d2c-407266dde6dd/nodes/36bb85d0-4b7c-4667-a933-a4ff714f9282/products?filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)product Id

    You should add the products IDs in the order you want them to be displayed in your node. The first product ID is displayed first in the product list.

    • If you don't provide any curated_products, products are listed by their updated_at time in descending order, with the most recently updated product first.
    • If you configure curated_products for only a few products, the curated products are displayed first and the other products are displayed in the order of updated_at time.
    • You can only curate 20 products or less. You cannot have more than 20 curated products.
    • If a curated product is removed from a node, the product is also removed from the curated_products list.
    • A product that is curated has the "curated_product": true attribute displayed.

    An example filter is shown below.

    /catalogs/6dff977e-a8c4-4e32-8d2c-407266dde6dd/nodes/36bb85d0-4b7c-4667-a933-a4ff714f9282/products?filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)

    Request Example

    curl -X GET https://api.moltin.com/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/39f96a3f-5577-473f-a263-f21fb2013469 \
         -H "Authorization: Bearer XXXX" \
    

    Response Example

    200 OK

    {
        "data": {
            "id": "39f96a3f-5577-473f-a263-f21fb2013469",
            "type": "node",
            "attributes": {
                "created_at": "2021-03-08T17:50:14.629Z",
                "description": "All cooling units for food",
                "name": "Refrigerators",
                "slug": "Refrigerators-MA1",
                "curated_products": [
                   "57ddfc7c-81c1-4855-88a5-2dd9d2055897",
                   "42d940f9-fe26-4eed-9070-5e00234febe5",
                   "2ab84aa8-232c-4199-8cc5-e1554ff58884"
                ],
                "updated_at": "2021-03-08T17:50:14.629Z",
                "published_at": "2021-04-13T02:36:16.505Z"
            },
            "meta": {
                "bread_crumb": [
                  "04e748f1-83db-4013-85c8-9edfb0e1b5fa",
                  "94b882fa-85de-470e-acb3-5b11358e02de",
                  "a96a898b-444c-40b6-9c27-5fc74d08e685"
                ]
            },
            "relationships": {
                "children": {
                    "links": {
                        "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/39f96a3f-5577-473f-a263-f21fb2013469/relationships/children"
                    }
                },
                "hierarchy": {
                    "data": {
                        "id": "0e119de2-5fb0-4bca-9b84-b3fc6c903007",
                        "type": "hierarchy"
                    },
                    "links": {
                        "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/hierarchies/0e119de2-5fb0-4bca-9b84-b3fc6c903007"
                    }
                },
                "parent": {
                    "data": {
                        "id": "0e119de2-5fb0-4bca-9b84-b3fc6c903007",
                        "type": "node"
                    },
                    "links": {
                        "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/0e119de2-5fb0-4bca-9b84-b3fc6c903007"
                    }
                },
                "products": {
                    "links": {
                        "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/39f96a3f-5577-473f-a263-f21fb2013469/relationships/products"
                    }
                }
            }
        },
        "links": {
            "self": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/39f96a3f-5577-473f-a263-f21fb2013469"
        }
    }
    

    Was this helpful?

    Previous
    Get all Nodes