# 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 Reporting API version: 1.0.0 extends: openapi/mailchimp-reporting-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: 12 - target: $.paths['/reporting/facebook-ads'].get update: x-apievangelist-phrasing: intent: List Facebook ad reports effect: read questions: - How are all my Facebook ads performing in Mailchimp? - Can I sort my Facebook ad reports by a particular field? instructions: - text: List reports for all my Facebook ads. - text: Show Facebook ad reports sorted by {sort_field} {sort_dir}. slots: sort_field: query.sort_field sort_dir: query.sort_dir method: generated generated: '2026-09-26' - target: $.paths['/reporting/facebook-ads/{outreach_id}'].get update: x-apievangelist-phrasing: intent: Get one Facebook ad's report effect: read questions: - What were the results of a specific Facebook ad? - Can I pull the report for one Facebook ad by its outreach ID? instructions: - text: Show the report for Facebook ad {outreach_id}. slots: outreach_id: path.outreach_id - text: Get performance numbers for Facebook ad {outreach_id}. slots: outreach_id: path.outreach_id method: generated generated: '2026-09-26' - target: $.paths['/reporting/facebook-ads/{outreach_id}/ecommerce-product-activity'].get update: x-apievangelist-phrasing: intent: Break down product sales from a Facebook ad effect: read questions: - Which products did people buy after clicking a Facebook ad? - Can I see ecommerce product activity attributed to one ad? instructions: - text: Show the product activity breakdown for Facebook ad {outreach_id}. slots: outreach_id: path.outreach_id - text: List products sold from Facebook ad {outreach_id} sorted by {sort_field}. slots: outreach_id: path.outreach_id sort_field: query.sort_field method: generated generated: '2026-09-26' - target: $.paths['/reporting/landing-pages/{outreach_id}'].get update: x-apievangelist-phrasing: intent: Get one landing page's report effect: read questions: - How many visits and signups did a specific landing page get? - Can I pull the report for a single landing page? instructions: - text: Show the report for landing page {outreach_id}. slots: outreach_id: path.outreach_id - text: Get conversion results for landing page {outreach_id}. slots: outreach_id: path.outreach_id method: generated generated: '2026-09-26' - target: $.paths['/reporting/landing-pages'].get update: x-apievangelist-phrasing: intent: List landing page reports effect: read questions: - How are all my landing pages performing? - Which landing pages have reports I can review? instructions: - text: List reports for all my landing pages. - text: Show {count} landing page reports. slots: count: query.count method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys'].get update: x-apievangelist-phrasing: intent: List survey reports effect: read questions: - Which of my surveys have results I can look at? - Can I get a summary report for every survey I've run? instructions: - text: List reports for all my surveys. - text: Show {count} survey reports starting at {offset}. slots: count: query.count offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys/{survey_id}'].get update: x-apievangelist-phrasing: intent: Get one survey's report effect: read questions: - How many responses has a specific survey received? - Can I see the overall results report for one survey? instructions: - text: Show the report for survey {survey_id}. slots: survey_id: path.survey_id - text: Get the total response count for survey {survey_id}. slots: survey_id: path.survey_id method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys/{survey_id}/questions'].get update: x-apievangelist-phrasing: intent: List per-question reports for a survey effect: read questions: - How did people answer each question in my survey? - Can I get results broken down question by question? instructions: - text: List question reports for survey {survey_id}. slots: survey_id: path.survey_id - text: Show results for every question in survey {survey_id}. slots: survey_id: path.survey_id method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys/{survey_id}/questions/{question_id}'].get update: x-apievangelist-phrasing: intent: Get one survey question's report effect: read questions: - What's the result summary for a single question in a survey? - Can I see how responses split across one question's choices? instructions: - text: Show the report for question {question_id} in survey {survey_id}. slots: question_id: path.question_id survey_id: path.survey_id - text: Get the answer breakdown for survey {survey_id} question {question_id}. slots: survey_id: path.survey_id question_id: path.question_id method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys/{survey_id}/questions/{question_id}/answers'].get update: x-apievangelist-phrasing: intent: List individual answers to a survey question effect: read questions: - What did each respondent actually write for one survey question? - Can I filter a question's answers to only new or known contacts? instructions: - text: List every answer to question {question_id} in survey {survey_id}. slots: question_id: path.question_id survey_id: path.survey_id - text: Show answers to survey {survey_id} question {question_id} from {respondent_familiarity_is} respondents. slots: survey_id: path.survey_id question_id: path.question_id respondent_familiarity_is: query.respondent_familiarity_is method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys/{survey_id}/responses'].get update: x-apievangelist-phrasing: intent: List responses to a survey effect: read questions: - Who responded to my survey, response by response? - Can I find only the survey responses that chose a particular answer? instructions: - text: List all responses to survey {survey_id}. slots: survey_id: path.survey_id - text: Show survey {survey_id} responses where respondents chose answer {chose_answer}. slots: survey_id: path.survey_id chose_answer: query.chose_answer - text: List survey {survey_id} responses that answered question {answered_question}. slots: survey_id: path.survey_id answered_question: query.answered_question method: generated generated: '2026-09-26' - target: $.paths['/reporting/surveys/{survey_id}/responses/{response_id}'].get update: x-apievangelist-phrasing: intent: Get a single survey response effect: read questions: - What were all the answers in one person's survey submission? - Can I open a specific survey response by its ID? instructions: - text: Show response {response_id} to survey {survey_id}. slots: response_id: path.response_id survey_id: path.survey_id - text: Get the full submission {response_id} from survey {survey_id}. slots: response_id: path.response_id survey_id: path.survey_id method: generated generated: '2026-09-26'