API Evangelist conversational phrasing for Mailchimp Marketing Reports API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Marketing Reports API
  version: 1.0.0
extends: openapi/mailchimp-reports-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 22
- target: $.paths['/reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List reports for sent campaigns
      effect: read
      questions:
      - Where can I see performance reports for all my sent campaigns?
      - Can I pull campaign reports only for campaigns sent in the last month?
      - Which of my sent campaigns have reports available?
      instructions:
      - text: List my campaign reports.
      - text: List reports for campaigns sent since {since_send_time}.
        slots:
          since_send_time: query.since_send_time
      - text: Show reports for {type} campaigns only.
        slots:
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the performance report for one campaign
      effect: read
      questions:
      - What were the open and click rates for a specific campaign I sent?
      - How did one particular campaign perform overall?
      instructions:
      - text: Get the report for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Summarize the overall results of sent campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/abuse-reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List spam complaints for a campaign
      effect: read
      questions:
      - Did anyone mark my campaign as spam?
      - How many abuse complaints did a campaign receive?
      instructions:
      - text: List the abuse complaints for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show who reported campaign {campaign_id} as spam.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/abuse-reports/{report_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one abuse complaint on a campaign
      effect: read
      questions:
      - Can I see the details of a single spam complaint on a campaign?
      - When was a specific abuse report filed and by which member?
      instructions:
      - text: Get abuse report {report_id} for campaign {campaign_id}.
        slots:
          report_id: path.report_id
          campaign_id: path.campaign_id
      - text: Show the details of spam complaint {report_id} on campaign {campaign_id}.
        slots:
          report_id: path.report_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/advice'].get
  update:
    x-apievangelist-phrasing:
      intent: Get improvement advice from a campaign's stats
      effect: read
      questions:
      - What advice does Mailchimp give based on how my campaign performed?
      - Are there suggestions for improving a campaign given its opens, clicks and bounces?
      instructions:
      - text: Get the performance advice for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show stats-based recommendations for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/click-details'].get
  update:
    x-apievangelist-phrasing:
      intent: List link click stats for a campaign
      effect: read
      questions:
      - Which links in my campaign got the most clicks?
      - Can I exclude bot clicks when looking at link performance?
      instructions:
      - text: List click counts for every link in campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show link clicks for campaign {campaign_id} with bot filtering set to {filter_bots}.
        slots:
          campaign_id: path.campaign_id
          filter_bots: query.filter_bots
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/click-details/{link_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get click stats for one link in a campaign
      effect: read
      questions:
      - How many people clicked one particular link in my email?
      - What's the click total for a single tracked URL in a campaign?
      instructions:
      - text: Get click details for link {link_id} in campaign {campaign_id}.
        slots:
          link_id: path.link_id
          campaign_id: path.campaign_id
      - text: Show human-only clicks on link {link_id} of campaign {campaign_id}.
        slots:
          link_id: path.link_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/click-details/{link_id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List subscribers who clicked a campaign link
      effect: read
      questions:
      - Who exactly clicked a specific link in my campaign?
      - Can I get the list of members who clicked one link so I can follow up?
      instructions:
      - text: List the subscribers who clicked link {link_id} in campaign {campaign_id}.
        slots:
          link_id: path.link_id
          campaign_id: path.campaign_id
      - text: Show the first {count} members who clicked link {link_id} in campaign {campaign_id}.
        slots:
          count: query.count
          link_id: path.link_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/click-details/{link_id}/members/{subscriber_hash}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one subscriber's clicks on a campaign link
      effect: read
      questions:
      - Did a particular subscriber click a specific link in my campaign?
      - How many times did one member click a given link?
      instructions:
      - text: Get the clicks by subscriber {subscriber_hash} on link {link_id} in campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          link_id: path.link_id
          campaign_id: path.campaign_id
      - text: Check whether member {subscriber_hash} clicked link {link_id} of campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          link_id: path.link_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/open-details'].get
  update:
    x-apievangelist-phrasing:
      intent: List members who opened a campaign
      effect: read
      questions:
      - Who opened my campaign, and when?
      - Can I leave out Apple privacy proxy opens so I only see real human opens?
      - Which subscribers opened a campaign after a certain time?
      instructions:
      - text: List who opened campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: List opens of campaign {campaign_id} that happened since {since}.
        slots:
          campaign_id: path.campaign_id
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/open-details/{subscriber_hash}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one subscriber's opens of a campaign
      effect: read
      questions:
      - Did a specific subscriber open my campaign?
      - How many times did one member open a given email?
      instructions:
      - text: Get the open details for subscriber {subscriber_hash} in campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      - text: Check if member {subscriber_hash} opened campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/domain-performance'].get
  update:
    x-apievangelist-phrasing:
      intent: Compare campaign results by email domain
      effect: read
      questions:
      - How did my campaign perform at Gmail versus other email domains?
      - Which recipient email domains had the best results for a campaign?
      instructions:
      - text: Show domain performance stats for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Break down campaign {campaign_id} results by recipient email domain.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/eepurl'].get
  update:
    x-apievangelist-phrasing:
      intent: Get social sharing activity for a campaign
      effect: read
      questions:
      - How much social activity did my campaign's EepURL generate?
      - Were there clicks or referrers from people sharing my campaign link?
      instructions:
      - text: Get the EepURL social activity for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show sharing and referrer stats for campaign {campaign_id}'s short link.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/email-activity'].get
  update:
    x-apievangelist-phrasing:
      intent: List every recipient's activity in a campaign
      effect: read
      questions:
      - Can I get a per-subscriber log of opens, clicks and bounces for a campaign?
      - What email activity happened in a campaign since yesterday?
      instructions:
      - text: List all recipient activity for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: List member activity in campaign {campaign_id} since {since}, excluding bots.
        slots:
          campaign_id: path.campaign_id
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/email-activity/{subscriber_hash}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one member's full activity in a campaign
      effect: read
      questions:
      - What did one specific subscriber do with my campaign — open, click or bounce?
      - Can I see the full activity timeline for a single recipient of a campaign?
      instructions:
      - text: Get the email activity of subscriber {subscriber_hash} in campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      - text: Show every open, click and bounce for member {subscriber_hash} on campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: See where a campaign was opened geographically
      effect: read
      questions:
      - Which countries opened my campaign the most?
      - Where in the world are people reading my email?
      instructions:
      - text: List the top open locations for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show the geographic breakdown of opens for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/sent-to'].get
  update:
    x-apievangelist-phrasing:
      intent: List everyone a campaign was sent to
      effect: read
      questions:
      - Who received my campaign?
      - Can I page through the full recipient list of a sent campaign?
      instructions:
      - text: List the recipients of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show {count} recipients of campaign {campaign_id} starting at offset {offset}.
        slots:
          count: query.count
          campaign_id: path.campaign_id
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/sent-to/{subscriber_hash}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get delivery info for one campaign recipient
      effect: read
      questions:
      - Was my campaign actually delivered to a particular subscriber?
      - What's the send status for one recipient of a campaign?
      instructions:
      - text: Get recipient info for {subscriber_hash} in campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      - text: Check delivery status of campaign {campaign_id} for recipient {subscriber_hash}.
        slots:
          campaign_id: path.campaign_id
          subscriber_hash: path.subscriber_hash
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/sub-reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List child campaign reports for a parent campaign
      effect: read
      questions:
      - How do I see reports for the child campaigns of an RSS or multivariate parent?
      - Can I get the sub-reports under a parent campaign?
      instructions:
      - text: List the child campaign reports for parent campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show sub-reports belonging to campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/unsubscribed'].get
  update:
    x-apievangelist-phrasing:
      intent: List members who unsubscribed from a campaign
      effect: read
      questions:
      - Who unsubscribed after receiving my campaign?
      - How many people opted out because of a specific email?
      instructions:
      - text: List the members who unsubscribed from campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show opt-outs caused by campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/unsubscribed/{subscriber_hash}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one member's unsubscribe from a campaign
      effect: read
      questions:
      - Did a specific subscriber unsubscribe from my campaign, and why?
      - When did one member opt out through a particular campaign?
      instructions:
      - text: Get unsubscribe details for member {subscriber_hash} from campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      - text: Show the reason member {subscriber_hash} left via campaign {campaign_id}.
        slots:
          subscriber_hash: path.subscriber_hash
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reports/{campaign_id}/ecommerce-product-activity'].get
  update:
    x-apievangelist-phrasing:
      intent: See product sales driven by a campaign
      effect: read
      questions:
      - Which products did people buy after clicking my campaign?
      - How much ecommerce revenue per product came from a campaign?
      instructions:
      - text: List product activity for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show product purchases from campaign {campaign_id} sorted by {sort_field}.
        slots:
          campaign_id: path.campaign_id
          sort_field: query.sort_field
      method: generated
      generated: '2026-09-26'