▣ MARKETING · SMART GENERATION

Generate Tours & Activities Product Categories API

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

▣ ENDPOINT 01 / 02

POST

Generate Tours & Activities Product Categories Submit Job

https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories

QUICKSTART

GUIDE

Quickstart

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

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 a job_id string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

{
  "job_id": "d4b1bfda-371e-4e8c-b63f-340a7cccdeeb"
}

TRY ITLIVE · 50 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Submits an async job to generate tours and activities product categories from the provided content and optional travel context. The response returns a job identifier.

Request Body

Parameter	Type	Mandatory	Description
city	String	No	Specify the city of travel.
content	String	Yes	Provide the content to generate travel product categories.
context	String	No	Provide additional context to improve paraphrasing accuracy.
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.

Response

Returns a JSON object with a job_id string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

Parameter	Type	Mandatory	Description
job_id	String	Yes	Job identifier for the submitted async job.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Extract the job identifier from job_id.

▣ ENDPOINT 02 / 02

GET

Generate Tours & Activities Product Categories Check Job Status

https://api.eu.apyhub.com/sharpapi/generate-tours-activities-product-categories/job/status/:job_id

QUICKSTART

GUIDE

Quickstart

Check the status of a job by its job_id.

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.

{
  "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
        }
      ]
    }
  }
}

TRY ITLIVE · 1 ATOM

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Checks the status of a previously submitted job for generating tours and activities product categories using the provided job_id. The response returns the job result wrapper with its current status and, when available, the generated result list.

Path Parameter(s)

Attribute	Type	Mandatory	Description
job_id	String	Yes	Job identifier, a string.

Response

Returns a JSON object with a data object field. The data object contains id and type string fields, plus an attributes object that includes status and type strings, and may include a result array of objects with name and weight fields.

Attribute	Type	Mandatory	Description
data	Object	Yes	Job result wrapper object.
data.id	String	Yes	Job identifier, a string.
data.type	String	Yes	Resource type, a string.
data.attributes	Object	Yes	Job attributes object.
data.attributes.type	String	Yes	Result type identifier, a string.
data.attributes.status	ENUM	Yes	Job status. Allowed values: `success`, `failed`, `running`, `queued`.
data.attributes.result	Object Array	No	Generated categories returned when available. Each item contains `name` and `weight`.
data.attributes.result[].name	String	Yes	Category name, a string.
data.attributes.result[].weight	Number	Yes	Category weight, a number.

Notes

Poll this endpoint with the job_id returned by the submit call. The status field cycles through transitional values (queued, running) before reaching a terminal state (success, failed). The result fields are only populated once status is success; treat them as absent otherwise.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLGenerate Hospitality Product Categories APISharpAPI CALLGenerate Product Categories APISharpAPI CALLJob Description Generator APISharpAPI CALLJob Description Generator APISumalya APIs

From the blog

Reads that touch this API.

Enhance Travel Platforms with SharpAPI’s AI-Powered Travel APIs on ApyHubAug 5, 2026 Generate Barcode API vs Generate QR Code API: Full Comparison & Use CasesJul 9, 2026 Top 5 Rank Tracking APIs to Build Your Own SEO Monitoring StackAug 24, 2026 How to Promote Your API After You Publish ItAug 14, 2026