# DeepResearchReportInput

Input object

What a Deep Research report runs on and how. Set the source field that matches `inputType` (VIEW → `viewId`, CREATOR → `creatorId`, CAMPAIGN → `campaignId`, BRAND → `brandIds`); a field that belongs to another input type is refused.

## Fields

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `brandIds` | `[ID!]` | No | — | BRAND: competitor brand UUIDs (`competitorBrands`). How many brands a report takes is set per template, and a count outside its bounds is refused with the bounds in the message. A single-brand template takes exactly one brand: your own (the entry with `isOwnBrand: true`) or one competitor. A multi-brand template (e.g. Share of Voice) always includes your own brand, so pass competitors only, at least as many as the template asks for; your own brand is not one of them. |
| `campaignId` | `ID` | No | — | CAMPAIGN: the campaign UUID (`campaigns`). |
| `commentCount` | `Int` | No | — | Comments read per post when `includeComments` is true. |
| `creatorId` | `ID` | No | — | CREATOR: the creator UUID (`creators`). |
| `from` | [`DateWithZone`](/api/v2/docs/types/date-with-zone) | No | — | BRAND: first day of the window. Defaults to the first day of the previous month. |
| `includeComments` | `Boolean` | No | — | Read the comments under each post, where the template allows (`audienceComments`). |
| `includeReplies` | `Boolean` | No | — | Also read replies to those comments. |
| `inputType` | [`DeepResearchInputType!`](/api/v2/docs/types/deep-research-input-type) | Yes | — | What the report runs on. `deepResearchTemplates` lists which types each template accepts. |
| `name` | `String` | No | — | Report title. Defaults to one derived from the template and source. |
| `poolSize` | `Int` | No | — | BRAND, pooled Share of Voice templates only: candidate posts ranked before the per-brand limit. |
| `postLimitPerBrand` | `Int` | No | — | BRAND: posts read per brand. Defaults to the template's recommendation. |
| `prompt` | `String` | No | — | Extra instructions for the analysis. |
| `repliesPerParent` | `Int` | No | — | Replies read per comment when `includeReplies` is true. |
| `replyParentLimit` | `Int` | No | — | Comments per post whose replies are read when `includeReplies` is true. |
| `socialProfileIds` | `[ID!]` | No | — | CREATOR: narrow the report to these of the creator's social profile UUIDs. |
| `templateSlug` | `String!` | Yes | — | The template to run, as `slug` in `deepResearchTemplates`. |
| `to` | [`DateWithZone`](/api/v2/docs/types/date-with-zone) | No | — | BRAND: last day of the window. Defaults to the last day of the previous month. |
| `trackedCommentsOnly` | `Boolean` | No | — | Read only the comments this workspace tracks (Social Flirting workspaces). |
| `viewId` | `ID` | No | — | VIEW: the content view UUID (`contentViews`). |