Skip to main content
GET
/
api
/
v1
/
brands
/
{brandId}
/
actions
curl "https://www.qwairy.co/api/v1/brands/{brandId}/actions?status=SUGGESTED&limit=10" \
  -H "Authorization: Bearer qw-api-xxx"

{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "type": "SOURCE_OUTREACH",
      "category": "AUTHORITY",
      "sourceType": "SOURCE_OPPORTUNITY",
      "scope": "OFF_SITE",
      "title": "Get cited by: TechRadar",
      "description": "AI answers cite this source 16 times, but it doesn't mention your brand. Outreach could secure valuable citations.",
      "sourceUrl": "https://techradar.com",
      "targetProvider": null,
      "forceTier": "HIGH",
      "priorityScore": 53,
      "demandBadge": 3,
      "isQuickWin": false,
      "effort": "MEDIUM",
      "status": "SUGGESTED",
      "signals": {
        "citations": 16,
        "sourceCategory": "MEDIA",
        "competitivePressure": 2
      },
      "impactJustification": "Source cited 16x by AI answers without mentioning the brand.",
      "effortJustification": "Outreach: research the contact, pitch, and follow up.",
      "baselineMetric": null,
      "targetMetric": null,
      "questionId": null,
      "checklist": [
        "Review what content the source already cites",
        "Prepare a superior resource or expert angle",
        "Pitch the editorial contact",
        "Track the citation when secured"
      ],
      "createdAt": "2026-06-12T05:00:00.000Z",
      "updatedAt": "2026-06-12T05:00:00.000Z"
    }
  ],
  "pagination": { "total": 42, "limit": 10, "offset": 0, "hasMore": true }
}
Returns the Action Center’s deterministic recommendation queue for a brand: prioritized actions with a 3-tier label, a 0-100 priority score, a 1-5 demand badge, the quantified “why”, the raw signals, and a step-by-step checklist.
Private beta. The Action Center must be enabled for your team; otherwise this endpoint returns 403. Contact your account manager to request access.
​
Authorization
string
required
Bearer token. Example: Bearer qw-api-xxx

​
Path Parameters

​
brandId
string
required
The unique identifier of the brand

​
Query Parameters

​
status
string
Filter by status: SUGGESTED (awaiting triage), PENDING, IN_PROGRESS, COMPLETED, DISMISSED, RESOLVED (signal disappeared, auto-closed). Defaults to the live queue: SUGGESTED + PENDING + IN_PROGRESS.
​
type
string
Filter by action type: CONTENT_GAP, CONTENT_OPTIMIZE, TECHNICAL_FIX, SCHEMA_ADD, AUTHORITY_BUILD, SOURCE_OUTREACH, COMPETITOR_ANALYSIS, PERCEPTION_FIX, SEARCH_TARGET, SOCIAL_ENGAGE, PRODUCT_OPTIMIZE, LOCAL_OPTIMIZE
​
category
string
Filter by category: TECHNICAL, CONTENT, AEO, AUTHORITY, VISIBILITY
​
limit
number
default:"50"
Maximum number of actions to return (max: 100)
​
offset
number
default:"0"
Pagination offset

​
Response

​
data
array
Actions ordered by priority (highest first), then creation date.
​
pagination
object
total, limit, offset, hasMore
curl "https://www.qwairy.co/api/v1/brands/{brandId}/actions?status=SUGGESTED&limit=10" \
  -H "Authorization: Bearer qw-api-xxx"

{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "type": "SOURCE_OUTREACH",
      "category": "AUTHORITY",
      "sourceType": "SOURCE_OPPORTUNITY",
      "scope": "OFF_SITE",
      "title": "Get cited by: TechRadar",
      "description": "AI answers cite this source 16 times, but it doesn't mention your brand. Outreach could secure valuable citations.",
      "sourceUrl": "https://techradar.com",
      "targetProvider": null,
      "forceTier": "HIGH",
      "priorityScore": 53,
      "demandBadge": 3,
      "isQuickWin": false,
      "effort": "MEDIUM",
      "status": "SUGGESTED",
      "signals": {
        "citations": 16,
        "sourceCategory": "MEDIA",
        "competitivePressure": 2
      },
      "impactJustification": "Source cited 16x by AI answers without mentioning the brand.",
      "effortJustification": "Outreach: research the contact, pitch, and follow up.",
      "baselineMetric": null,
      "targetMetric": null,
      "questionId": null,
      "checklist": [
        "Review what content the source already cites",
        "Prepare a superior resource or expert angle",
        "Pitch the editorial contact",
        "Track the citation when secured"
      ],
      "createdAt": "2026-06-12T05:00:00.000Z",
      "updatedAt": "2026-06-12T05:00:00.000Z"
    }
  ],
  "pagination": { "total": 42, "limit": 10, "offset": 0, "hasMore": true }
}