---
title: "Generate Tours & Activities Product Categories API"
slug: generate-tours-activities-product-categories
url: https://apyhub.com/sharpapi/service/generate-tours-activities-product-categories
provider: SharpAPI
categories: [Marketing, Smart Generation, Travel]
auth: api_key
version: 1.0.0
service_type: job
endpoints: 2
atoms: 1-50
mcp: true
alias: sharpapi-travel-activities-product-categories
---

# Generate Tours & Activities Product Categories API

Classify travel content into ranked tours and activities categories. Returns job status plus category names and weights for search and taxonomy.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories` | What it does Submits an async job to generate tours and activities product categories from the prov… | 50 |
| GET | `https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories/job/status/:job_id` | What it does Checks the status of a previously submitted job for generating tours and activities pr… | 1 |

## Endpoint reference

### Generate Tours & Activities Product Categories Submit Job

`POST https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories` · 50 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `city` | body | string | no | Specify the city of travel. Example: `Sample value`. |
| `content` | body | string | yes | Provide the content to generate travel product categories. Example: `Sample value`. |
| `context` | body | string | no | Provide additional context to improve paraphrasing accuracy Example: `Sample value`. |
| `country` | body | string | no | Specify the country related to travel. Example: `Sample value`. |
| `language` | body | string | no | Specify the language of the output, defaults to English Example: `Sample value`. |
| `max_quantity` | body | number | no | Specify the maximum length of the paraphrased content |

#### Quickstart

Submit a travel content generation job with the required `content` field.

```bash
curl -X POST "https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Best family-friendly attractions in Paris"
  }'
```

#### What you'll get back

Returns a JSON object with two string fields: `job_id` and `status_url`. `job_id` is the submitted job identifier, and `status_url` is the URL you can use to check the job status.

```json
{
  "status_url": "https://apyhub.com/services/provider/sharpapi/api/v1/tth/ta_product_categories/job/status/d4b1bfda-371e-4e8c-b63f-340a7cccdeeb",
  "job_id": "d4b1bfda-371e-4e8c-b63f-340a7cccdeeb"
}
```

### Generate Tours & Activities Product Categories Check Job Status

`GET https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories/job/status/:job_id` · 1 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `job_id` | path | string | yes | Example: `5de4887a-0dfd-49b6-8edb-9280e468c210`. |

#### Quickstart

Check the status of a job by its `job_id`.

```bash
curl -X GET "https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object. `data` contains `id` and `type` for the job result, plus an `attributes` object with `status`, `type`, and `result`. `status` is one of `success`, `failed`, `running`, or `queued`.

```json
{
  "data": {
    "id": "55bc3311-d16e-4949-83a0-d367b7f79f89",
    "type": "api_job_result",
    "attributes": {
      "status": "success",
      "type": "tth_ta_product_categories",
      "result": [
        {
          "name": "Boat Tours",
          "weight": 9.5
        }
      ]
    }
  }
}
```

## About

## What it does
Tour Category Generator turns travel content into ranked tours-and-activities product categories. Send a content string, and optionally add city, country, language, context, and max_quantity to shape the output. The job returns a job_id and status_url first, then a status record when you check the job.

Use it when you need to map destination copy, activity descriptions, or curated travel inventory into a normalized category list. The submitted content drives the classification; city and country can help anchor the travel context, while language lets you request the output in the language you need.

When the job finishes, the status response includes a result array of category objects with name and weight, along with a status value of success, failed, running, or queued. That makes it easy to sort category suggestions by relevance and feed them into travel search, merchandising, or content organization workflows.

Tour Category Generator is a good fit for travel platforms that need structured categories from unstructured copy without building their own taxonomy pipeline.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/sharpapi/service/generate-tours-activities-product-categories