AI-powered API

Tours & Activities Product Categorization

Generates a list of suitable categories for the Tours & Activities product with relevance weights.

Generates a list of suitable categories for the Tours & Activities product with relevance weights as float value (1.0-10.0) where 10 equals 100%, the highest relevance score. Provide the product name and its parameters to get the best category matches possible. Comes in handy with populating product catalogue data and bulk product processing.

Ideal for developers working on travel platforms, tour operators, or activities marketplaces. It automates the categorization of tours and activities, ensuring accuracy and enhancing searchability. Use cases include categorizing new tour products, improving the organization of tour listings, and enhancing user experience by providing relevant category suggestions.

Only the content parameter is required.

You can set your preferred writing style by providing a 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).

You can limit the output with the max_quantity parameter.

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

Tours & Activities Product Categorization

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/ta_product_categories

Attribute	Type	Mandatory	Description
content	String	Yes	Provide the content to generate travel product categories.
city	String	No	Specify the city of travel.
country	String	No	Specify the country related to travel.
language	String	No	Specify the language of the output, defaults to `English`.
max_quantity	Number	No	Specify the maximum length of the paraphrased content.
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": "Oasis of the Bay",
    "city": "Ha Long",
    "country": "Vietnam",
    "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

Endpoint: GET - /api/v1/tth/ta_product_categories/job/status/:uuid

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

Result example:

{
  "data": {
    "type": "api_job_result",
    "id": "55bc3311-d16e-4949-83a0-d367b7f79f89",
    "attributes": {
      "status": "success",
      "type": "tth_ta_product_categories",
      "result": [
        {
          "name": "Boat Tours",
          "weight": 9.5
        },
        {
          "name": "Nature & Wildlife Tours",
          "weight": 8.7
        },
        {
          "name": "Water Sports",
          "weight": 7.8
        },
        {
          "name": "Sightseeing Cruises",
          "weight": 9.2
        },
        {
          "name": "Day Trips",
          "weight": 8
        },
        {
          "name": "Eco Tours",
          "weight": 7.5
        },
        {
          "name": "Adventure Tours",
          "weight": 6.8
        },
        {
          "name": "Cultural Tours",
          "weight": 6
        },
        {
          "name": "Multi-day Tours",
          "weight": 5.5
        },
        {
          "name": "Private Sightseeing Tours",
          "weight": 5.2
        }
      ]
    }
  }
}

Related Keywords:
Travel
Categories
Relevance
Tours
Activities