---
title: "Get analysis and metrics for prompts with frequency data by website and topic ID"
method: POST
path: "/api/beta/topic/prompts"
tags: ["Topics API"]
---

# Get analysis and metrics for prompts with frequency data by website and topic ID

`POST /api/beta/topic/prompts`

Returns analysis and metrics for all prompts with frequency over time by website and topic ID

## Query parameters

- `websiteTopicId` string, required

## Request body

- GlobalFilters
  - `llmProvider` string, required
  - `fromDate` integer, required
  - `toDate` integer, required
  - `tagIds` string[], required

## Response `200`

Successfully retrieved

- PromptMetrics[]
  - `promptAnalysisId` string
  - `promptId` string
  - `ranking` number, double
  - `shareOfVoice` number, double
  - `prompt` string
  - `answerText` string
  - `promptsCount` integer
  - `invocations` integer
  - `sources` string[]
  - `positiveSentiments` object[]
  - `negativeSentiments` object[]
  - `importantTerms` string[]
  - `seoMetrics` SEOMetrics
    - `searchVolume` integer
    - `cpc` number, double
  - `latestRunData` string, date-time
  - `mentionFrequency` MetricOverTime
    - `metricName` string
    - `displayName` string
    - `median` number, double
    - `average` number, double
    - `series` DateValue[]
      - `date` string, date-time, required
      - `value` number, double, required
    - `dates` string[]
    - `fromDate` string, date-time
    - `toDate` string, date-time
    - `delta` number, double
    - `dataFormat` 'NUMBER' | 'PERCENTAGE' | 'CURRENCY' | 'TEXT' | 'SCORE'
    - `daysSpan` integer
    - `value` number, double
    - `language` 'ENGLISH' | 'SPANISH' | 'PORTUGUESE' | 'HEBREW' | 'GERMAN' | 'ITALIAN' | 'FRENCH' | 'MANDARIN' | 'HINDI' | 'ARABIC' | 'JAPANESE' | 'RUSSIAN'
    - `locale` 'GLOBAL' | 'ISRAEL' | 'EU' | 'UK' | 'US' | 'IL' | 'AL' | 'AZ' | 'KG' | 'BA' | 'UZ' | 'BI' | 'XK' | 'SM' | 'DE' | 'AT' | 'CH' | 'IE' | 'IM' | 'FR' | 'ES' | 'NL' | 'IT' | 'PT' | 'BE' | 'AD' | 'MT' | 'MC' | 'MA' | 'LU' | 'TN' | 'DZ' | 'GI' | 'LI' | 'SE' | 'DK' | 'FI' | 'NO' | 'AX' | 'IS' | 'GG' | 'JE' | 'GL' | 'VA' | 'FX' | 'FO' | 'AF' | 'AM' | 'AU' | 'BH' | 'BD' | 'BT' | 'BN' | 'KH' | 'CN' | 'CY' | 'GE' | 'HK' | 'IN' | 'ID' | 'IR' | 'IQ' | 'JP' | 'JO' | 'KZ' | 'KW' | 'LA' | 'LB' | 'MY' | 'MV' | 'MN' | 'MM' | 'NP' | 'OM' | 'PK' | 'PH' | 'QA' | 'SA' | 'SG' | 'KR' | 'LK' | 'SY' | 'TW' | 'TH' | 'TR' | 'AE' | 'VN' | 'YE' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'EC' | 'GY' | 'PY' | 'PE' | 'SR' | 'UY' | 'VE'

## Other responses

- `404` — Not found - The website topic was not found

## Changes

- **2025-07-30** `911f19f11004` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `404`

[Change history](https://skmtc.dev/joinanvil/apis/openapi-definition/changes/api/beta/topic/prompts/post.md)

---

[API](https://skmtc.dev/joinanvil/apis/openapi-definition.md) · [All operations](https://skmtc.dev/joinanvil/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinanvil/openapi-definition/revisions/911f19f11004/schema)