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::

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

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
        }
      ]
    }
  }
}``
SharpAPI Introduction Video

SharpAPI Introduction Video

Feb 2, 2024

SharpAPI is a powerful AI-powered API, which provides a range of workflow automation endpoints to help improve efficiency across various industries. It has features for E-commerce, Content & Marketing Automation, SEO, HR Tech, and Travel & Hospitality industries.

Leveraging AI for Enhanced Online Engagement

Leveraging AI for Enhanced Online Engagement

Jul 18, 2024

Let’s explore how AI can be leveraged to build scalable solutions for online engagement across various industries seeking to enhance efficiency and productivity through AI-driven workflow automation.

When Laravel/PHP E-commerce App Meets AI

When Laravel/PHP E-commerce App Meets AI

Jan 1, 2024

Hey fellow Laravel enthusiasts! In the ever-evolving landscape of e-commerce, integrating AI into your Laravel applications is not just a luxury, it’s a necessity. With SharpAPI’s Laravel package, it’s now easier than ever. In this blog, I’ll guide you through 10 transformative use cases for enhancing your Laravel-based e-commerce applications using SharpAPI.