SEsearchable
Sentiment

Get sentiment history

Changed on

Brand sentiment trend over time — per-day sentiment score and positive/neutral/negative counts, with an improving/declining/stable trend from scoreChange, the score's change against the equal-length window just before the requested one (null, and trend no_data, when either window has no mentions). Pass unbranded=true or branded=true to filter by prompt brand state. days defaults to 90, max 365.

get/api/mcp/projects/{projectId}/sentiment/history

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

platformstring

Comma-separated AI platform filter (e.g. chatgpt,claude,gemini). Accepted values and whether the param is required vary by endpoint — see the operation description.

topicIdstring uuid

Restrict to a single topic id.

unbranded'true'

Pass true to restrict every metric to non-branded prompts only.

branded'true'

Pass true to restrict every metric to branded prompts only.

countrystring

Comma-separated ISO 3166-1 country codes (e.g. US,GB) or country names.

locationIdstring

Comma-separated tracked-location ids.

fromstring
Example:2026-03-01

Start of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires to, and is mutually exclusive with days — sending both returns 400 invalid_argument. A range longer than the endpoint's maximum is rejected rather than clamped.

tostring
Example:2026-03-31

End of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires from.

Response

Sentiment history.

Changes

  • 28a5e2a65cd3Revision changes
    • breaking

      the response property / became nullable for the status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

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

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • info

      added the new optional query request parameter from

    • info

      added the new optional query request parameter to