> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lendflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tripadvisor Business Search

## Tripadvisor Business Search

Tripadvisor Business Search looks for a company in Tripadvisor listing data. The **Tripadvisor** Workflow Builder block exposes the `tripadvisor` service for business entities.

## Requirements

| Application field | Requirement | Notes |
| - | - | - |
| Business legal name | Required | Used as the company search term. |
| Business address city | Optional | Recommended to improve matching. |
| Business address state | Optional | Recommended to improve matching; use a state code. |

## Run Tripadvisor Business Search

Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application) with `provider` set to `tripadvisor`, then poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=tripadvisor`.

```json theme={"system"}
{
  "provider": "tripadvisor"
}
```

The asynchronous result appears at `commercial_data.tripadvisor`, the lifecycle message appears at `statuses.tripadvisor`, and the stored request appears at `request_data.tripadvisor`.

<Note>
  Tripadvisor Business Search is not included in the current Data Orchestration service catalog.
</Note>

## What the service returns

| Response area | Meaning |
| - | - |
| Response array | Candidate Tripadvisor listings. |
| `address_obj` | Listing address and location identifiers. |
| `details` | Category, rating, review count, price, contact, hours, and amenity information. |

## Representative response

```json theme={"system"}
[
  {
    "name": "Example Hotel",
    "score": 30,
    "location_id": "305677",
    "address_obj": {
      "address_string": "123 Main St, Memphis, TN 38134",
      "city": "Memphis",
      "state": "Tennessee",
      "postalcode": "38134",
      "street2": null
    },
    "details": {
      "category": {
        "name": "hotel"
      },
      "rating": "4.0",
      "num_reviews": "229",
      "price_level": "$$",
      "phone": "+15555550100",
      "website": "https://example.com",
      "hours": {
        "weekday_text": [
          "Monday: 09:00 - 17:00"
        ]
      },
      "amenities": [
        "Free Wifi"
      ]
    }
  }
]
```

The response is an array of possible listings, not a single verified match. Individual candidates can contain `details.error` instead of listing details.

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `[]` | Array | Candidate Tripadvisor listings. | Zero or more listing objects. | On a successful lookup. |
| `[].name` | String or null | Tripadvisor listing name. | Provider text. | When available. |
| `[].score` | Number or null | Upstream match or ranking score. | Formula, range, and unit are not defined in the repositories. | When available. |
| `[].location_id` | String or null | Tripadvisor location identifier. | Provider identifier. | When available. |
| `[].address_obj` | Object or null | Listing address. | Provider object. | When available. |
| `[].address_obj.address_string` | String or null | Formatted listing address. | Provider text. | When available. |
| `[].address_obj.city` | String or null | Listing city. | Provider text. | When available. |
| `[].address_obj.state` | String or null | Listing state or region. | Provider text. | When available. |
| `[].address_obj.postalcode` | String or null | Listing postal code. | String; preserve leading zeroes. | When available. |
| `[].details.category.name` | String or null | Tripadvisor category. | Provider text. | When details are available. |
| `[].details.rating` | String or null | Provider rating. | Numeric-formatted string in the fixture; exact bounds are not verified. | When available. |
| `[].details.num_reviews` | String or null | Review count. | Numeric-formatted string in the fixture. | When available. |
| `[].details.price_level` | String or null | Provider price indicator. | Text such as `$` or `$$`. | When available. |
| `[].details.phone` | String or null | Listing telephone. | Provider-formatted text. | When available. |
| `[].details.website` | String or null | Listing website. | URL text. | When available. |
| `[].details.hours.weekday_text` | Array of strings | Provider-formatted hours. | One or more day/hour strings. | When available. |
| `[].details.amenities` | Array of strings | Listing amenities. | Provider-controlled labels. | When available. |
| `[].details.error` | String | Candidate-level retrieval error. | Can include an HTTP status such as `404`. | When candidate details could not be retrieved. |
| `error` | String | Failure or no-result message. | Service-generated text. | When the lookup fails. |

## Errors and statuses

`statuses.tripadvisor` describes the Lendflow request lifecycle. `Success` means a response was stored; it does not guarantee that every listing field was found. A response containing `error` marks the request as failed.

## FAQ

<AccordionGroup>
  <Accordion title="Why does the response schema vary?">
    Lendflow stores the upstream Tripadvisor result without a fixed field-level normalization contract.
  </Accordion>

  <Accordion title="Can this service run in Data Orchestration?">
    It is not included in the current Data Orchestration service catalog.
  </Accordion>
</AccordionGroup>