Celebrity API endpoint and product data

[prosperent brian]

Today we are launching a new Celebrity endpoint for the Prosperent API. This new endpoint allows you to query and get a list of celebrities that have products associated with them in our catalog. The endpoint also gives you an image of the Celebrity (in multiple sizes). Once you pull back a list of celebs, you can make use of the new filterCelebrity filter in the product endpoint. Doing so gives you back all of the products associated with the celebrity, or celebrities that you are interested in. Full documentation is live along with examples of pulling products for specific celebs, and of course an updated php api class.

We are working with merchants to get more celeb data, but as of now we have around 1600 products that are connected to our celebs.


What are some potential uses for this?

Build a celebrity style site that shows pictures of popular celebs along with the clothing and accessories that they have been seen wearing. This would be a great addition to any celebrity related blog or site.

[312k1t]

I like this new feature and I am gonna use it on some of my sites. I checked the raw json response from product's endpoint and I see some new properties:

keywords - mostly it is empty or set to "celebrity", how can we use this property?
celebrity - array of celebrities names, it is very usefull, we can show which celebrity is wearing this product
totalRecordsAvailable - I see this property in the api for the first time and is it saying the current limit of products what we can get from api? So we can calculate number of pages?

I see that properties keywords and celebrity are available also with option enableFullData=false. I would be happy if they be omitted.

[edwin32]

Nice new features, currently playing with it. One thing I feel missing is facet data for celebrities on product end point. I think it will be a great helper if we can have it: celebrities widget can be bounded right away with search query, just like merchants or brands.

[Prosperent Andrew]

keywords - mostly it is empty or set to "celebrity", how can we use this property?

We have always had this field, just never used it. The plan is to add more keywords to help match a product. It will be similar to categories but more of a mixture of words of phrases with no structure. For now, it is either empty or has 'celebrity.' Use it to return all products that belong to celebrities (See the example in the documentation).

totalRecordsAvailable - I see this property in the api for the first time and is it saying the current limit of products what we can get from api? So we can calculate number of pages?

This was added about a month or so ago. This is the field you would want to use to determine the exact number of pages you can get from a single query.

I see that properties keywords and celebrity are available also with option enableFullData=false. I would be happy if they be omitted.

We can make that happen...

[Prosperent Andrew]

Nice new features, currently playing with it. One thing I feel missing is facet data for celebrities on product end point. I think it will be a great helper if we can have it: celebrities widget can be bounded right away with search query, just like merchants or brands.

We will have that added soon...

[Prosperent Andrew]

Currently, we have about 40 celebrities, all female, with 1000+ products. We are in the process of adding more, including male celebrities. This will be something we will be continuously adding too. I'm thinking about adding gender in the Celebrity endpoint as well as age, that way, for example, you can show female celebrities that are between the ages 20-30 to better suit your target audience.