Reports & Analytics

Get customer intelligence.

Changed on

Returns AI-analyzed insights about your users, including common intents, emotional sentiment, frequently discussed topics, and emerging trends. Use this to understand what users are asking about and how they're feeling.

get/api/v1/projects/{projectId}/reports/intelligence

Request

Path parameters

projectIdinteger required
Example:1

The ID of the project to get customer intelligence for

Query parameters

pageinteger

Page number to return.

limitinteger

Number of items to return per page. Maximum is 100.

start_datestring date-time

Start of the date range for the intelligence report. ISO 8601 datetime format (e.g., 2024-01-15T00:00:00Z). Data from this point onward is included in the response.

end_datestring date-time

End of the date range for the intelligence report. ISO 8601 datetime format (e.g., 2024-03-31T23:59:59Z). Data up to this point is included in the response.

content_source[]string[]

Filter results by Content Source (use repeated parameters, e.g. content_source[]=value)

[
  "in-context"
]
accuracystring
Example:0-100

Filter results by Verified Claims Score as range (format: min-max, e.g., 0-100)

stakeholder_status[]string[]

Filter results by Stakeholder Status (use repeated parameters, e.g. stakeholder_status[]=value)

[
  "APPROVED"
]
user_emotion[]string[]

Filter results by User Emotion (use repeated parameters, e.g. user_emotion[]=value)

[
  "positive"
]
user_intent[]string[]

Filter results by User Intent (use repeated parameters, e.g. user_intent[]=value)

[
  "informational"
]
human_request[]string[]

Filter results by Requested Human (use repeated parameters, e.g. human_request[]=value)

[
  "true"
]
language[]string[]

Filter results by Query Language (use repeated parameters, e.g. language[]=value)

[
  "example"
]
user_id[]integer[]

Filter results by Query Sent By (use repeated parameters, e.g. user_id[]=value)

[
  -2
]
external_id[]string[]

Filter results by CRM ID (use repeated parameters, e.g. external_id[]=value)

[
  "example"
]
country[]string[]

Filter results by User Location (use repeated parameters, e.g. country[]=value)

[
  "example"
]
risk_fidelity[]string[]

Filter results by Risk: Fidelity (use repeated parameters, e.g. risk_fidelity[]=value)

[
  "unavailable"
]
risk_jailbreak[]string[]

Filter results by Risk: Jailbreak (use repeated parameters, e.g. risk_jailbreak[]=value)

[
  "unavailable"
]
risk_prompt_leakage[]string[]

Filter results by Risk: Prompt Leakage (use repeated parameters, e.g. risk_prompt_leakage[]=value)

[
  "unavailable"
]
risk_profanity[]string[]

Filter results by Risk: Profanity (use repeated parameters, e.g. risk_profanity[]=value)

[
  "unavailable"
]
request_source[]string[]

Filter results by Deployment (use repeated parameters, e.g. request_source[]=value)

[
  "web"
]
leads[]integer[]

Filter results by Lead Captured (use repeated parameters, e.g. leads[]=value)

[
  1
]
tools[]string[]

Filter results by Agentic Actions (use repeated parameters, e.g. tools[]=value)

[
  "example"
]

Response

Project analytics customer intelligence data

status'error' | 'success'

The status of the response

total_queriesinteger

Total number of queries match filter criteria

Example response

{
  "status": "success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "prompt_id": 101,
        "conversation_id": 42,
        "project_id": 7,
        "user_query": "What file formats does CustomGPT support?",
        "ai_response": "CustomGPT supports PDF, DOCX, TXT, and more.",
        "created_at": "2026-02-01T09:20:00.000000Z",
        "content_source": "in-context",
        "user_emotion": "neutral",
        "user_intent": "informational",
        "language": "en",
        "human_request": "false",
        "user_id": -2,
        "user_location": "US",
        "chatbot_deployment": "web",
        "risk_fidelity": "Good",
        "risk_jailbreak": "no_event",
        "risk_prompt_leakage": "no_event",
        "risk_profanity": "no_event",
        "accuracy": "-",
        "stakeholder_status": "UNKNOWN",
        "browser": "Chrome 121"
      }
    ],
    "first_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "next_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "path": "https://app.customgpt.ai/api/v1/users?page=1",
    "per_page": 10,
    "prev_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "to": 1,
    "total": 1
  }
}

Changes

    • breaking

      the response property /// became nullable for the status

    • warning

      added the new 422.00 enum value to the / response property for the response status

    • warning

      added the new 422.00 enum value to the / response property for the response status

    • warning

      added the new 422.00 enum value to the / response property for the response status

    • info

      api tag Reports & Analytics added

    • info

      api tag Customer Intelligence removed

    • info

      added the new optional query request parameter accuracy

    • info

      added the new optional query request parameter content_source[]

    • info

      added the new optional query request parameter country[]

    • info

      added the new optional query request parameter external_id[]

    • info

      added the new optional query request parameter human_request[]

    • info

      added the new optional query request parameter language[]

    • info

      added the new optional query request parameter leads[]

    • info

      added the new optional query request parameter request_source[]

    • info

      added the new optional query request parameter risk_fidelity[]

    • info

      added the new optional query request parameter risk_jailbreak[]

    • info

      added the new optional query request parameter risk_profanity[]

    • info

      added the new optional query request parameter risk_prompt_leakage[]

    • info

      added the new optional query request parameter stakeholder_status[]

    • info

      added the new optional query request parameter tools[]

    • info

      added the new optional query request parameter user_emotion[]

    • info

      added the new optional query request parameter user_id[]

    • info

      added the new optional query request parameter user_intent[]

    • info

      added the non-success response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property to the response with the status

    • info

      endpoint added