Classification

Foyer Insight

Search…

Foyer Insight

🎯

Introduction

📦

Sandbox

Quick start

Results

💻

API

Classification

This page details the endpoint for sending images for classification through Foyer Insight. An SDK is provided at https://www.npmjs.com/package/@foyer-inc/insight-sdk

​
There is a 10MB limit on images sent to the classify endpoint.
post
https://api.foyer.ai
/images/classify
Classify a single image
Only one of file, files, url or urls may be specified.
Example request body
1
{
2
    "url": "https://upload.wikimedia.org/wikipedia/commons/6/6d/Down_House.jpg",
3
    "force": true
4
}
Copied!
Possible classifications
​
​
​
aerial_view
indoor
outdoor
bathroom
bedroom
community
gym
diagram
dining_room
front_of_structure
garage
kitchen
laundry
living_room
office
other
pool
closet
Possible object detections
Features
Furniture
Items
Outdoor
​
​
​
fireplace
stairway
floor
ceiling
window
wall
stairs
cabinet
sink
counter
closet
toilet
kitchen_island
bar
countertop
bannister
booth
chandelier
shelf
stove
railing
refrigerator
column
bathtub
blind
escalator
door
fountain
stage
buffet_counter
conveyor
canopy
washing_machine
swimming_pool
oven
step
tank
microwave
dishwasher
hood
sconce
shower
radiator
​
​
​
​
​
table
curtain
chair
bench
couch
chest
mirror
rug
armchair
seat
desk
stand
coffee_table
pool_table
grandstand
display_case
pillow
bookcase
ottoman
swivel_chair
stool
cradle
trashcan
bulletin
bed
​
​
​
​
​
poster
painting
lamp
computer
cushion
box
sign
screen
book
toy
arcade_machine
towel
television
apparel
light
pole
bottle
basket
ball
barrel
bag
food
pot
projection_screen
vase
sculpture
blanket
tray
fan
crt
plate
monitor
drinking_glass
clock
flag
​
​
​
​
sky
tree
road
building
grass
sidewalk
ground
mountain
plant
car
water
house
sea
field
fence
stone
sand
skyscraper
path
runway
river
bridge
flower
hill
palm
boat
hut
truck
tower
bus
awning
streetlight
airplane
dirt_track
land
van
tent
waterfall
ship
motorbike
bicycle
lake
traffic_light
pier
​
Attributes
Attributes are more specific features gathered from the objects detected in the images. For the segmentations that have them, the attributes will give more robust information about the image. Attributes will always have a name field and a value field. Currently, the possible attributes are:
tagpoint: the tagpoint attribute's value is an array in the shape of [x, y] where x and y are percentage-based. They form a point that is guaranteed to be on the segmentation for tagging/display purposes.
is_stainless: A boolean. This attribute appears on refrigerator, stove, oven, washing_machine, hood, and dishwasher segmentations.
floor_type: A string of one of the possible flooring classifications (defined below). An additional float field, confidence, exists on this attribute.
Possible flooring classifications
A floor segmentation will automatically have a flooring type within its attributes.
​
​
​
carpet
stone
marble
hardwood
tile
other
post
https://api.foyer.ai
/images/classifyReso
Classify images from a RESO object
See the RESO definition for a Media Resource. We require the MediaURL field to be defined for image classification.
Example request body
1
{
2
  "@odata.context": "http://odata.listhub.moveaws.com/odata/$metadata#Property",
3
  "value": [
4
    {
5
      "@odata.id": "http://odata.listhub.moveaws.com/odata/Property('3yd-A2SELL-281884')",
6
      "ListingKey": "3yd-A2SELL-281884",
7
      "ListingId": "281884",
8
      "PropertyType": "Land",
9
      "PropertySubType": "Other",
10
      "ListPrice": 21900,
11
      ...
12
      "Media": [
13
        {
14
          "MediaCategory": "Photo",
15
          "MediaURL": "http://photos.listhub.net/A2SELL/281884/1", // required
16
          "MediaKey": "2483763c0011d2a36483fb3f28ca8c00564abb4d",
17
          "MediaModificationTimestamp": "2019-10-03T09:14:00.000Z"
18
        },
19
        ...
20
      ]
21
    }
22
  ],
23
  "@odata.nextLink": "https://odata.listhub.moveaws.com/odata/Property?%24top=1&%24skiptoken=3yd-A2SELL-281884"
24
}
25
​
Copied!

Last modified 24d ago

Copy link

Contents

post

Classify a single image

Example request body

Possible classifications

Possible object detections

Attributes

Possible flooring classifications

post

Classify images from a RESO object

Example request body