AIRT Groups

Organize tracked prompts into groups for cleaner reporting and bulk operations. Groups live at the site level and are shared across every LLM engine configured for that site; prompts are assigned to groups per engine. Data in the AI Result Tracker is refreshed daily.

Base URL: api4.seranking.com

List prompt groups

GET https://api4.seranking.com/sites/{site_id}/airt/prompt-groups

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Returns prompt groups for the site, ordered by position. Optionally filter by LLM engine and include prompt counts per group.

Request parameters

Request example

curl -X GET "https://api4.seranking.com/sites/72193/airt/prompt-groups?token=YOUR_API_TOKEN&keys_count=1"

Response parameters

Response example

[

  { "id": 1, "name": "Default", "position": 0, "is_default": 1, "creation_date": "2025-06-01", "keys_count": 42 },

  { "id": 12, "name": "Brand queries", "position": 1, "is_default": 0, "creation_date": "2026-03-05", "keys_count": 15 },

  { "id": 18, "name": "Competitors", "position": 2, "is_default": 0, "creation_date": "2026-03-21", "keys_count": 28 }

]

Error responses

Create prompt group

POST https://api4.seranking.com/sites/{site_id}/airt/prompt-groups

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Creates a new prompt group for a site. The new group is appended to the end of the group order. Returns 400 if a group with the same name already exists.

Request parameters

Request example

curl -X POST "https://api4.seranking.com/sites/72193/airt/prompt-groups?token=YOUR_API_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"name": "Competitors"}'

Response parameters

Response example

{ "id": 12 }

Error responses

Rename prompt group

PATCH https://api4.seranking.com/sites/{site_id}/airt/prompt-groups/{group_id}

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Updates the name of a prompt group.

Request parameters

Request example

curl -X PATCH "https://api4.seranking.com/sites/72193/airt/prompt-groups/12?token=YOUR_API_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"name": "Branded queries"}'

Response parameters

Response example

{ "id": 12 }

Error responses

Delete prompt group

DELETE https://api4.seranking.com/sites/{site_id}/airt/prompt-groups/{group_id}

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Deletes a prompt group. All prompts currently in the group are moved to the default group. The default group itself cannot be deleted.

Request parameters

Request example

curl -X DELETE "https://api4.seranking.com/sites/72193/airt/prompt-groups/12?token=YOUR_API_TOKEN"

Response

Returns 204 No Content on success.

Error responses

Change group order

POST https://api4.seranking.com/sites/{site_id}/airt/prompt-groups/{group_id}/order

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Moves a group to a new position in the site’s group order. Provide exactly one of before_id or after_id to anchor the new position.

Request parameters

Request example

Move group 12 to right after group 18:

curl -X POST "https://api4.seranking.com/sites/72193/airt/prompt-groups/12/order?token=YOUR_API_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"after_id": 18}'

Response

Returns 204 No Content on success.

Error responses

Delete all prompts in group

DELETE https://api4.seranking.com/sites/{site_id}/airt/prompt-groups/{group_id}/keywords

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Removes every prompt currently assigned to the group. The group itself is not deleted.

Warning:

• This operation is destructive. Deleted prompts and their historical data cannot be recovered.
• To keep the prompts but empty the group, use Move all prompts from one group to another instead.

Request parameters

Request example

curl -X DELETE "https://api4.seranking.com/sites/72193/airt/prompt-groups/12/keywords?token=YOUR_API_TOKEN"

Response

Returns 204 No Content on success.

Error responses

Move prompts to group

POST https://api4.seranking.com/sites/{site_id}/airt/prompt-groups/{group_id}/moveKeywords

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Moves a specific set of prompts into the target group. Prompts can come from any group on the same site.

Request parameters

Request example

curl -X POST "https://api4.seranking.com/sites/72193/airt/prompt-groups/12/moveKeywords?token=YOUR_API_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"k2site_llm_ids": [101, 102, 103]}'

Response

Returns 204 No Content on success.

Error responses

Move all prompts from one group to another

POST https://api4.seranking.com/sites/{site_id}/airt/prompt-groups/moveGroupKeywords

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Moves every prompt from one group to another in a single call. Use this to merge a group into another group, then optionally delete the now-empty source group.

Request parameters

Request example

curl -X POST "https://api4.seranking.com/sites/72193/airt/prompt-groups/moveGroupKeywords?token=YOUR_API_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"from_group_id": 18, "to_group_id": 12}'

Response

Returns 204 No Content on success.

Error responses