AI-powered API

Hospitality Product Categorization

Generates a list of suitable categories for hospitality products with relevance weights.

Generates a a list of suitable categories for the Hospitality type product with relevance weights as float value (1.0-10.0) where 10 equals 100%, the highest relevance score.

By providing the product name and its parameters, this API delivers the best category matches possible. It is highly useful for populating product catalogues and processing bulk products efficiently.

Ideal for developers working on travel platforms, hotel booking systems, or hospitality marketplaces. It streamlines the categorization of hospitality products, ensuring accuracy and enhancing searchability. Use cases include categorizing new hotel listings, improving the organization of hospitality offerings, and providing users with relevant category suggestions for a better experience.

The weights are provided as float values (1.0-10.0) where 10 equals 100%, the highest relevance score.

Only the content parameter is required.

You can limit the output with the max_quantity parameter.

You can set your preferred writing style by providing an optional voice_tone parameter. It can be adjectives like funny or joyous, or even the name of a famous writer.

Within an additional optional parameter context, you can provide a list of other categories that will be taken into consideration during the mapping process (for example your current categories).

AI jobs involve two key steps:

Submitting the AI job: Initiating the process by sending the job request.
Monitoring and receiving results: Continuously checking the job status and obtaining the final output upon successful completion.

Related SDKs/Libraries

SharpAPI is now SOC 2 Type II compliant. You can check details at our Trust Center Portal.

Your data is your data. Learn how we protect it and comply with global privacy standards in our Data Handling and Compliance policy .

Step 1. Submit the AI Job request

Endpoint: POST - /api/v1/tth/hospitality_product_categories

Attribute	Type	Mandatory	Description
content	String	Yes	Provide the content to generate travel product categories.
city	String	No	Specify the city to travel.
country	String	No	Specify the country to travel.
language	String	No	Specify the language of the output, defaults to `English`.
max_quantity	Number	No	Maximum number of product categories to generate.
voice_tone	String	No	Specify the voice tone. The default will be `neutral`.
context	String	No	The list of other categories that will be taken into consideration during the mapping process (for example your current categories).

Request example:

{
    "content": "Hotel Crystal 大人専用",
    "city": "Tokyo",
    "country":"Japan",
    "language": "English",
    "max_quantity":10,
    "voice_tone": "neutral",
    "context":null
}

RESPONSE EXAMPLE:

{
  "status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
  "job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}

Step 2. Monitor & Fetch AI Job Results

An endpoint is used to check on the progress of the requested API job.

RESULT EXAMPLE:

{
  "data": {
    "type": "api_job_result",
    "id": "afb7cc23-23a5-479c-92a9-be983792dabc",
    "attributes": {
      "status": "success",
      "type": "tth_hospitality_product_categories",
      "result": [
        {
          "name": "Adult Only Hotels",
          "weight": 10
        },
        {
          "name": "Luxury Hotels",
          "weight": 8.5
        },
        {
          "name": "Boutique Hotels",
          "weight": 7.5
        },
        {
          "name": "Romantic Getaways",
          "weight": 7
        },
        {
          "name": "City Hotels",
          "weight": 6.5
        },
        {
          "name": "Couples Retreats",
          "weight": 6
        }
      ]
    }
  }
}