Explore Experiences

Guide: Story Trends

First time using the Bllush API? First, read the Getting Started guide.

Why Story Trends?

Wearing the latest fashion trends helps people feel special. Help educate your users about new trends and show them how to wear these products. Providing users with educational content increases the loyalty they feel towards the store and increases the likelihood they will buy.

What are we building?

In this example, we’re going to open to create a new user experience to enable product discovery from inspiration content. This will be placed on a new page, where the content will be shown. Users will be able to read an article about a trend and browse various fashion outfits that are connected by the same trend and navigate to the products linked to those outfits.

How do I build this experience?

For this experience, our starting point will be pulling a specific article. We will use the get_cb_by_id endpoint which will return the requested content batch.

Once you have all the data – you can design your content block using your preferred framework and the data provided by us.

Here is an example using pseudo-code:

Call BlushApi(path = get_cb_by_id)
ForEach cb in response:
    ForEach cu in cb.content_units:
        ForEach product in cu.product_matches:
            Enrich(product.sku)//Enrich product data from DB using SKU
            CreateContentBlock(CU)// as shown here

Further Details

  • In this example, we pulled a specific content_batch. In reality, you’ll probably want to publish a page that shows all the articles, in blog format. For this, you’ll need to use the get_cb_list endpoint
  • It will be better to make the enrichment call once providing a list of all product_matches SKUs and then sorting/enriching on the client-side.
  • You can create a pagination mechanism using our limit and offset options in our API. Here is an example in PHP.

Final Result

That’s about it. 

We’ve used some styling to make it look a bit nicer and published this project. You can view the live example here.


Want to learn more?

Talk to one of our content experts!

Book a call