List fanouts

The follow-up queries engines generate from your prompts.


GET /brands/{brand_id}/fanouts

Authorization

Header	Type	Required
`Authorization`	`Bearer asky_sk_…`	required

Path parameters

Parameter	Type	Required	Description
`brand_id`	`uuid`	required	From List brands

Query parameters

Parameter	Type	Required	Description
`limit`	`integer`	optional	Rows per page, 1 to 100. Defaults to 20.
`cursor`	`string`	optional	Opaque cursor from the previous response. Treat it as a token, never construct one.
`start_date`	`YYYY-MM-DD`	optional	Inclusive lower bound, YYYY-MM-DD in UTC. Narrows the population before metrics are computed.
`end_date`	`YYYY-MM-DD`	optional	Inclusive upper bound, YYYY-MM-DD in UTC. Narrows the population before metrics are computed.
`prompt_id`	`uuid`	optional	Only fanouts from this prompt.
`expansion_type`	`string`	optional	Filter by how the query was expanded.

Request


curl https://api.askylabs.com/v1/brands/BRAND_ID/fanouts \
  -H "Authorization: Bearer $ASKY_API_KEY"

Response


{
  "data": [
    {
      "query_text": "rule-based publishing workflows vs AI-driven publishing systems",
      "expansion_type": "fan_out",
      "occurrences": 60,
      "prompt_count": 1,
      "source_providers": [
        "openai"
      ],
      "source_intent": "general",
      "intent_modifiers": [
        "vs"
      ],
      "funnel_stages": [
        "middle"
      ],
      "query_language": "en",
      "geo_scope": null,
      "added_terms": [],
      "best_match_similarity": 0.646278742183306,
      "coverage_status": "covered",
      "mentions_own_brand": false,
      "mentioned_competitors": []
    },
    {
      "query_text": "martech automation architecture AI CMS integration tools",
      "expansion_type": "fan_out",
      "occurrences": 44,
      "prompt_count": 1,
      "source_providers": [
        "openai"
      ],
      "source_intent": "general",
      "intent_modifiers": [],
      "funnel_stages": [
        "middle"
      ],
      "query_language": "en",
      "geo_scope": null,
      "added_terms": [
        "integration"
      ],
      "best_match_similarity": 0.595322198287117,
      "coverage_status": "covered",
      "mentions_own_brand": false,
      "mentioned_competitors": []
    }
  ],
  "pagination": {
    "limit": 2,
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJvIjoyLCJsIjoyfQ"
  },
  "meta": {
    "period": {
      "start_date": null,
      "end_date": null,
      "all_time": true
    },
    "returned": 100,
    "total_distinct": 4071,
    "truncated": true
  },
  "request_id": "req_3b5f8d040a3b4516ad4d"
}