PEpeec
Brand Perception

List Facts

Changed on

List the facts a project uses to check claims found in AI answers. Manual facts were added by a person; website facts were extracted from the project's website. Inactive facts are listed but excluded from future fact-checking. Deleted facts are never returned. Use the returned id as a fact_id in Update Facts, Delete Facts, and the fact_ids filter of Get Brand Perception Fact-Checking Verdicts.

get/facts

Request

  • Base URL
    https://api.peec.ai/customer/v1
  • URL
    https://api.peec.ai/customer/v1/facts
  • 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
origin'website' | 'manual'

Only include facts added this way: manual or website.

is_activestring

Only include facts that are (true) or are not (false) used in future fact-checking.

limitinteger
offsetinteger

Response

The project's facts, newest first

total_countnumber required
fact_limitnumber nullable required

How many active facts the project's plan allows, or null for unlimited.

active_fact_countnumber required

How many active facts the project holds now. Creating or activating facts beyond fact_limit is rejected.

Example response

{
  "data": [
    {
      "id": "0198f000-0000-7000-8000-000000000001",
      "text": "Plans start at €99 per month.",
      "origin": "manual",
      "edited_at": "2026-09-18T10:00:00.000Z",
      "created_at": "2026-09-01T10:00:00.000Z"
    }
  ]
}

Changes