Brand Perception

Get Brand Perception Fact-Checking Verdicts

Changed on

Claims AI models make about the project's brand, each judged against one of the project's facts as supported or contradicted. Data is aggregated across all fact-checked chats and has no date range. Newest claims first.

get/brand-perception/fact-checking-verdicts

Request

  • Base URL
    https://api.peec.ai/customer/v1
  • URL
    https://api.peec.ai/customer/v1/brand-perception/fact-checking-verdicts
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key
    • or HTTP bearer

Query parameters

project_idstring

Required if using a company api key

Example:or_f45b94ba-5e35-4982-93ed-285e72ee14eb
fact_idsstring[]

Only include verdicts against these facts. Omit to include every active fact.

claim_idsstring[]

Only include these claims, returning every fact each one was judged against. Omit to include every claim.

verdictsstring[]

Only include these verdicts. Omit to include both supported and contradicted claims.

model_channel_idsstring[]

Only include claims from answers on these AI engine channels. Omit to aggregate across all tracked channels.

limitinteger
offsetinteger

Response

Response for status 200

total_countnumber required

Example response

{
  "data": [
    {
      "claim_id": "clm_01j8x2k9v4",
      "claim": "Peec AI was founded in 2019.",
      "fact_id": "fct_01j8x2k9v4",
      "fact": "Peec AI was founded in 2024.",
      "verdict": "contradicted",
      "chats": 12,
      "prompts": 4,
      "example_chat_id": "ch_01j8x2k9v4",
      "last_seen": "2026-09-18"
    }
  ]
}

Changes

    • warning

      added the new exa-0 enum value to the /// response property for the response status

    • info

      added the enum value exa-0 to the property items/ of the query request parameter model_channel_ids

    • info

      endpoint added