discovery

List conversations (v2)

Page through every conversation of a campaign's results window (dated in the 30 days ending its as-of day, scope.window: the conversations its values count), newest or oldest first, optionally narrowed to segments, one assistant, the campaign brand's outcome (won; mentioned while another brand or none won; absent), and its matchup with one rival (rival: the conversations its win and loss reasons against that brand are counted from), and searched, ignoring case, by the customer's name and the transcript's text (the customer's prompts and the assistant's answers). Each row names the customer, the assistant, when it started, how many turns it shows, the outcome, the winner and the brands it named, its first prompt, where a search hit, and how many sources it cited. Read one transcript in full with business_customer_conversations_get_v2 (the row's conversationId as id, and its customerId). A campaign without results answers its state and no rows.

get/api/v1/discovery/conversations-v2

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/conversations-v2
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Query parameters

limitinteger

Number of conversations to return (1–50)

cursorstring

Opaque cursor returned as nextCursor by the previous page

idstring uuid required

Discovery campaign id.

dateRangestring nullable

Result window: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default window.

segmentsstring[]

Narrows the read to these segments, ANDed: one axis:id per axis (any number of distinct customer: entries), in canonical axis order. Empty reads the whole dispatch.

searchstring

Text matched, ignoring case, against the customer's name and the transcript (prompts and answers).

engine'chatgpt' | 'gemini' | 'claude' | 'grok'

Only this assistant's conversations.

outcome'won' | 'mentioned' | 'absent'

Only conversations with this outcome for the campaign's brand.

conversationIdstring uuid

Only this conversation: its row when the window and segments hold it, else none, so a link to one conversation reads its row once.

sort'newest' | 'oldest'

By when each conversation started; default newest first.

rivalstring

Only the campaign brand's matchup with this brand: conversations that name both, where one of the two is the brand the conversation recommended, the conversations discovery.competitor-reasons.get counts its win and loss reasons against that brand from. Name it as those reasons do (data.option.id). With outcome, won keeps the campaign brand's wins and mentioned its losses to that brand.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

nextCursorstring nullable required
totalCountinteger nullable required

Conversations the filters and search keep; null unless scope.state is ready.

Changes

No recorded changes to this operation across all 1 revision of this API.