Furniture Finder

The /furniture_finder endpoint leverages advanced image recognition and AI algorithms to analyze images of interiors, identifying pieces of furniture and decor within them. Once identified, it automatically matches these items with real, purchasable products from a vast database of furniture retailers. This feature is designed to simplify the shopping experience, allowing users to recreate their desired interior looks with ease. It not only identifies the items but also provides users with direct links to stores where they can buy the exact or similar items.

ENDPOINT

POST /furniture_finder

An API URL would be like https://homedesigns.ai/api/v2/furniture_finder

This endpoint identify the furniture and decor in the images and possible recommendations purchasable alternatives.

An API request must be in the form-data format.

Request

Parameters & Data Type

Value

Description

image

file[ .jpg, .jpeg, .png] / base64 Image string

The image to be processed by the API. The image dimensions must be 512x512 pixels or greater for optimal results. (Required Parameter) Without selecting a country code, the result will be given in worldwide.

countryCode (optional)string

country code as per the suggested code

The country code should be in [AE, AF, AG, AI, etc.]. You can choose your country code from the suggested country code tab.

Parameters & Errors

image

Error Messages

Reason

Image field required

Image not provided

Invalid image format. Only PNG, JPEG and JPG images are allowed.

Image Format not valid.

countryCode

Error Messages

Reason

Country code should be proper in [AE, AF, AG, AI, etc.]

Country code is wrong

No Furniture Found for selected country.

Furnture not found.

//Output should be in list of array depends on no of designs as shown below:

"resultArray": {
    "chair": [
        {
            "position": 1,
            "title": "Holden 5-pc. Dining Set in Gray / Oak by Bellanest",
            "link": "https://www.raymourflanigan.com/dining-rooms/dining-sets/holden-5-pc-dining-set-799188618",
            "source": "Raymour & Flanigan",
            "source_icon": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQviLFE8S5Lakv4ft5si8rvmCbjjubzLkrM2rsrE2BJadVHrEXD2qAMAYYgP7g8YYs7viaO_bJ_YQEkDqg02a8K3retpFWhrLo_LGGmy6uM4oHukovUYmbUZK87LQ",
            "rating": 4.8,
            "reviews": 74,
            "price": {
            "value": "$559.95*",
            "extracted_value": 559.95,
            "currency": "$"
            },
            "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR0saUeTbtxIFPI28Re-pNucsslbtGq0ubsyuYz1LtpOb7UOqKH"
        },
    ...
    ...
    ]
}

PreviousColors & Textures NextFull HD

Last updated 1 month ago

Was this helpful?

ENDPOINT

POST /furniture_finder

An API URL would be like https://homedesigns.ai/api/v2/furniture_finder

This endpoint identify the furniture and decor in the images and possible recommendations purchasable alternatives.

An API request must be in the form-data format.

Request

Parameters & Data Type

Value

Description

image

file[ .jpg, .jpeg, .png] / base64 Image string

countryCode (optional)string

country code as per the suggested code

The country code should be in [AE, AF, AG, AI, etc.]. You can choose your country code from the suggested country code tab.

Parameters & Errors

image

Error Messages

Reason

Image field required

Image not provided

Invalid image format. Only PNG, JPEG and JPG images are allowed.

Image Format not valid.

countryCode

Error Messages

Reason

Country code should be proper in [AE, AF, AG, AI, etc.]

Country code is wrong

No Furniture Found for selected country.

Furnture not found.

//Output should be in list of array depends on no of designs as shown below:

"resultArray": {
    "chair": [
        {
            "position": 1,
            "title": "Holden 5-pc. Dining Set in Gray / Oak by Bellanest",
            "link": "https://www.raymourflanigan.com/dining-rooms/dining-sets/holden-5-pc-dining-set-799188618",
            "source": "Raymour & Flanigan",
            "source_icon": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQviLFE8S5Lakv4ft5si8rvmCbjjubzLkrM2rsrE2BJadVHrEXD2qAMAYYgP7g8YYs7viaO_bJ_YQEkDqg02a8K3retpFWhrLo_LGGmy6uM4oHukovUYmbUZK87LQ",
            "rating": 4.8,
            "reviews": 74,
            "price": {
            "value": "$559.95*",
            "extracted_value": 559.95,
            "currency": "$"
            },
            "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR0saUeTbtxIFPI28Re-pNucsslbtGq0ubsyuYz1LtpOb7UOqKH"
        },
    ...
    ...
    ]
}