# Listings

## Listings

Satisfi Labs imports Listings data from Simpleview daily through an overnight import process. The following sections detail specific Simpleview field names used in the Listings integration and how each is displayed in chat.

### URL

The Listings API endpoint varies by DMO. Please reach out to your Satisfi Labs representative for specific URL information. 

### List Displays

List displays are used when a user search returns more than one result. The list display prompts a user to select ***Learn More*** about a specific listing or ***Show More*** to view more results. 

The image and table below cover the name of the Simpleview API field referenced in the integration, plus a description of where/how the field is available. 

<figure><img src="https://lh4.googleusercontent.com/oJ7iy62S9ldtSfkSieDtZ1rtx4yRvH80h_aUAP02uGpTyl4pQX8rK008tPORiCMYSKBhGq9nQohz323UjIUsW95s61G4ZZQNNeTsdXGW9q5WWsdFu9yXc0rujBb7bMZze2F8wBbadFxRlav5CSURLPsyZrqanVkFVSaXeQ-SUwmAhFRFpEr0KN7pSjM9Rw" alt=""><figcaption><p>Example of a listings list display</p></figcaption></figure>

| Simpleview API Field                                | Description                                                                                                                                                                                                                                                               |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Company                                             | The listing’s name is displayed as the heading for each list item                                                                                                                                                                                                         |
| <p>CatName,<br>SubCatname,<br>AdditionalSubCats</p> | <p>These fields are displayed in the “Matches:” subtitle of the list. The field names are displayed exactly as structured in the Simpleview feed (i.e., case-sensitive). <br></p><p>The chat will display up to 5 categories/subcategories associated with a listing.</p> |

### Card displays

Card displays are used when a user navigates to a specific listing result. The image and table below cover the name of the Simpleview API field referenced in the integration, plus a description of where/how the field is available.&#x20;

<figure><img src="https://lh4.googleusercontent.com/4AoZ1kCaPcfUQR6UoqAHpTU1C1uD2d17OSpOxTKhn12VtWdnkI3zN8H69o3UyRWKGTr3Qz2sRxa84Wt9-1PGBamlWYXMaGir5pjnDQWbmXBNcQeBoPKppX-yhLiO0tKUcIkUBFTFk7HuWvLb-baROz_ADmfaTa3q0YdWj3UlVGuHz8TzSthG8n2u0vz0tw" alt=""><figcaption><p>Example of a listing card display</p></figcaption></figure>

| Simpleview API Field                                | Description                                                                                                                                                                                                                                                               |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ImgPath                                             | Image used within card view                                                                                                                                                                                                                                               |
| Company                                             | Displays the listing name (shown underneath the card image)                                                                                                                                                                                                               |
| Region                                              | Displays Simpleview region name (follows “Area of town:” prefix)                                                                                                                                                                                                          |
| Description                                         | Description rendered as text-only (no HTML or markdown supported)                                                                                                                                                                                                         |
| <p>CatName,<br>SubCatname,<br>AdditionalSubCats</p> | <p>These fields are displayed in the “Categories:” area of the card. The field names are displayed exactly as structured in the Simpleview feed (i.e., case-sensitive). </p><p></p><p>The chat will display all categories/subcategories associated with the listing.</p> |
| WebURL                                              | Generates **Website** button URL                                                                                                                                                                                                                                          |
| <p>Addr1,<br>City,<br>State,<br>Zip</p>             | Used to build the **Map** button, which redirects user to an address search in Google Maps                                                                                                                                                                                |