Responses and sources

ResponsesCopy Anchor Link

GET /brands/{brandId}/responses lists individual AI answers, newest first. Each response tells you:

• which prompt was asked, on which engine and when
• whether your brand was mentioned, and its position and sentiment
• the other companies the answer named, with their position and sentiment
• the sources the answer cited, in order

{
  "id": "0199c3f2-6e1a-7b2c-9d4e-5f6a7b8c9d0e",
  "promptId": "11adb654-a2cc-4935-ab96-3290337eed4b",
  "prompt": "What is the best CRM for a small agency?",
  "engine": "perplexity",
  "createdAt": "2026-09-27T06:12:44.000Z",
  "brandMentioned": true,
  "brandPosition": 2,
  "brandSentiment": "positive",
  "competitors": [
    {
      "competitorId": "2883cac2-e9f2-4d26-9fba-cbf7a792c54b",
      "name": "Globex",
      "position": 1,
      "sentiment": "neutral"
    },
    {
      "competitorId": null,
      "name": "Initech",
      "position": 3,
      "sentiment": "neutral"
    }
  ],
  "citations": [
    {
      "url": "https://www.g2.com/categories/crm",
      "domain": "g2.com",
      "title": "Best CRM Software",
      "position": 1
    }
  ]
}

Two filters help you find answers worth acting on:

Combine them to see the answers where a competitor is recommended and you are not:

curl "https://api.gensiv.com/v1/brands/$BRAND_ID/responses?brandMentioned=false&competitorId=$COMPETITOR_ID" \
  -H "Authorization: Bearer $GENSIV_API_KEY"

competitorId is null for companies the answer named that you do not track as competitors. They are useful for finding competitors you have not added yet.

The full answer text is not included in the API. You can read answers in the Gensiv dashboard.

SourcesCopy Anchor Link

AI engines often cite web pages to support their answers. Gensiv records every cited URL and its domain.

• GET /brands/{brandId}/sources/domains ranks domains by how often they are cited. share is the percentage of responses in the range that cite the domain at least once.
• GET /brands/{brandId}/sources/urls ranks individual pages.

Pages that AI engines cite often are good places to be mentioned. If a domain is cited in answers where your competitors appear and you do not, it is a strong candidate for outreach, guest content or a listing.

Reddit opportunitiesCopy Anchor Link

GET /brands/{brandId}/reddit/opportunities lists Reddit threads related to your brand:

status reflects what your team did with the thread in Gensiv: new, saved, dismissed, drafted or posted.