{"components":{"schemas":{"Error":{"properties":{"docs":{"type":"string"},"error":{"type":"string"}},"required":["error"],"type":"object"},"Quote":{"properties":{"config":{"$ref":"#/components/schemas/QuoteRequest","description":"The order as priced, with defaults filled in."},"currency":{"const":"USD","type":"string"},"discounts":{"items":{"properties":{"amount":{"description":"US dollars, as a decimal string.","pattern":"^\\d+\\.\\d{2}$","type":"string"},"label":{"type":"string"}},"required":["label","amount"],"type":"object"},"type":"array"},"line_items":{"items":{"properties":{"amount":{"description":"US dollars, as a decimal string.","pattern":"^\\d+\\.\\d{2}$","type":"string"},"label":{"type":"string"}},"required":["label","amount"],"type":"object"},"type":"array"},"quote_id":{"description":"Same for the same order, whether priced here or in the ad builder.","pattern":"^PVG-[0-9A-F]{8}$","type":"string"},"subtotal":{"description":"US dollars, as a decimal string.","pattern":"^\\d+\\.\\d{2}$","type":"string"},"total":{"description":"US dollars, as a decimal string.","pattern":"^\\d+\\.\\d{2}$","type":"string"}},"required":["quote_id","currency","config","line_items","subtotal","discounts","total"],"type":"object"},"QuoteRequest":{"additionalProperties":false,"anyOf":[{"required":["print"]},{"required":["digital"]}],"description":"Include `print`, `digital`, or both.","properties":{"advertiser":{"default":"business","description":"Who is buying. `business` = Business; `nonprofit` = Nonprofit (20% off media); `political` = Political (no discounts).","enum":["business","nonprofit","political"],"type":"string"},"digital":{"additionalProperties":false,"properties":{"counties":{"default":["hampshire","hampden","franklin"],"description":"Counties to target. Fewer than all three adds 20% to the CPM.","items":{"enum":["hampshire","hampden","franklin"],"type":"string"},"type":"array","uniqueItems":true},"format":{"description":"Digital ad unit. `leaderboard` = Leaderboard 728x90; `medium_rectangle` = Medium rectangle 300x250; `half_page` = Half-page 300x600; `newsletter` = Daily newsletter sponsorship.","enum":["leaderboard","medium_rectangle","half_page","newsletter"],"type":"string"},"weekly_impressions":{"description":"Impressions per week, in steps of 5000.","maximum":500000,"minimum":10000,"multipleOf":5000,"type":"integer"},"weeks":{"default":1,"description":"Number of weeks to run.","maximum":52,"minimum":1,"type":"integer"}},"required":["format","weekly_impressions"],"type":"object"},"extras":{"default":[],"description":"Optional production extras. `design` = Ad design service; `rush` = Rush production; `tear_sheets` = Tear sheets ($5 per print insertion). `tear_sheets` requires a print ad.","items":{"enum":["design","rush","tear_sheets"],"type":"string"},"type":"array","uniqueItems":true},"print":{"additionalProperties":false,"properties":{"color":{"default":"bw","description":"Ink. `bw` = Black & white; `spot` = Spot color; `full` = Full color.","enum":["bw","spot","full"],"type":"string"},"days":{"description":"Days of the week the ad runs. Sunday insertions cost 25% more.","items":{"enum":["mon","tue","wed","thu","fri","sat","sun"],"type":"string"},"minItems":1,"type":"array","uniqueItems":true},"position":{"default":"run_of_section","description":"Placement within the section. `run_of_section` = Run of section; `right_hand` = Right-hand page; `guaranteed_page` = Guaranteed page; `back_cover` = Section back cover (full page only). `back_cover` requires `full_page`.","enum":["run_of_section","right_hand","guaranteed_page","back_cover"],"type":"string"},"section":{"description":"Newspaper section. `front` = Front (A) section; `local` = Local; `sports` = Sports; `business` = Business; `arts` = Arts & Living; `classifieds` = Classifieds.","enum":["front","local","sports","business","arts","classifieds"],"type":"string"},"size":{"description":"Ad size. `full_page` = Full page; `half_page` = Half page; `quarter_page` = Quarter page; `eighth_page` = Eighth page; `business_card` = Business card.","enum":["full_page","half_page","quarter_page","eighth_page","business_card"],"type":"string"},"weeks":{"default":1,"description":"Number of weeks to run.","maximum":52,"minimum":1,"type":"integer"}},"required":["section","size","days"],"type":"object"}},"type":"object"}}},"externalDocs":{"description":"Sample GET request","url":"/api/v1/ad-quote?print_section=local&print_size=quarter_page&print_color=full&print_days=thu,sun&print_weeks=4"},"info":{"description":"Price a print, digital or bundled ad buy from the Gazette rate card. Returns the same quote, with the same quote number, as the ad builder at /advertise/ad-builder. Read-only: quoting does not book an ad. No authentication.\n\nInclude print fields for a print ad, digital fields for a digital ad, or both for a 10% bundle discount. Discounts: frequency (6+ print insertions 5%, 13+ 10%, 26+ 15%), bundle 10%, nonprofit 20% off media. Political ads get no discounts.","title":"Pioneer Valley Gazette ad quote API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/ad-quote":{"get":{"description":"Send at least the required print fields (print_section, print_size, print_days) or digital fields (digital_format, digital_weekly_impressions). With no parameters at all, returns a short field list instead of a quote.","operationId":"getAdQuote","parameters":[{"description":"Who is buying. `business` = Business; `nonprofit` = Nonprofit (20% off media); `political` = Political (no discounts).","in":"query","name":"advertiser","required":false,"schema":{"default":"business","description":"Who is buying. `business` = Business; `nonprofit` = Nonprofit (20% off media); `political` = Political (no discounts).","enum":["business","nonprofit","political"],"type":"string"}},{"description":"Newspaper section. `front` = Front (A) section; `local` = Local; `sports` = Sports; `business` = Business; `arts` = Arts & Living; `classifieds` = Classifieds.","in":"query","name":"print_section","required":false,"schema":{"description":"Newspaper section. `front` = Front (A) section; `local` = Local; `sports` = Sports; `business` = Business; `arts` = Arts & Living; `classifieds` = Classifieds.","enum":["front","local","sports","business","arts","classifieds"],"type":"string"}},{"description":"Ad size. `full_page` = Full page; `half_page` = Half page; `quarter_page` = Quarter page; `eighth_page` = Eighth page; `business_card` = Business card.","in":"query","name":"print_size","required":false,"schema":{"description":"Ad size. `full_page` = Full page; `half_page` = Half page; `quarter_page` = Quarter page; `eighth_page` = Eighth page; `business_card` = Business card.","enum":["full_page","half_page","quarter_page","eighth_page","business_card"],"type":"string"}},{"description":"Ink. `bw` = Black & white; `spot` = Spot color; `full` = Full color.","in":"query","name":"print_color","required":false,"schema":{"default":"bw","description":"Ink. `bw` = Black & white; `spot` = Spot color; `full` = Full color.","enum":["bw","spot","full"],"type":"string"}},{"description":"Placement within the section. `run_of_section` = Run of section; `right_hand` = Right-hand page; `guaranteed_page` = Guaranteed page; `back_cover` = Section back cover (full page only). `back_cover` requires `full_page`.","in":"query","name":"print_position","required":false,"schema":{"default":"run_of_section","description":"Placement within the section. `run_of_section` = Run of section; `right_hand` = Right-hand page; `guaranteed_page` = Guaranteed page; `back_cover` = Section back cover (full page only). `back_cover` requires `full_page`.","enum":["run_of_section","right_hand","guaranteed_page","back_cover"],"type":"string"}},{"description":"Days of the week the ad runs. Sunday insertions cost 25% more.","explode":false,"in":"query","name":"print_days","required":false,"schema":{"description":"Days of the week the ad runs. Sunday insertions cost 25% more.","items":{"enum":["mon","tue","wed","thu","fri","sat","sun"],"type":"string"},"minItems":1,"type":"array","uniqueItems":true},"style":"form"},{"description":"Number of weeks to run.","in":"query","name":"print_weeks","required":false,"schema":{"default":1,"description":"Number of weeks to run.","maximum":52,"minimum":1,"type":"integer"}},{"description":"Digital ad unit. `leaderboard` = Leaderboard 728x90; `medium_rectangle` = Medium rectangle 300x250; `half_page` = Half-page 300x600; `newsletter` = Daily newsletter sponsorship.","in":"query","name":"digital_format","required":false,"schema":{"description":"Digital ad unit. `leaderboard` = Leaderboard 728x90; `medium_rectangle` = Medium rectangle 300x250; `half_page` = Half-page 300x600; `newsletter` = Daily newsletter sponsorship.","enum":["leaderboard","medium_rectangle","half_page","newsletter"],"type":"string"}},{"description":"Impressions per week, in steps of 5000.","in":"query","name":"digital_weekly_impressions","required":false,"schema":{"description":"Impressions per week, in steps of 5000.","maximum":500000,"minimum":10000,"multipleOf":5000,"type":"integer"}},{"description":"Number of weeks to run.","in":"query","name":"digital_weeks","required":false,"schema":{"default":1,"description":"Number of weeks to run.","maximum":52,"minimum":1,"type":"integer"}},{"description":"Counties to target. Fewer than all three adds 20% to the CPM.","explode":false,"in":"query","name":"digital_counties","required":false,"schema":{"default":["hampshire","hampden","franklin"],"description":"Counties to target. Fewer than all three adds 20% to the CPM.","items":{"enum":["hampshire","hampden","franklin"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Optional production extras. `design` = Ad design service; `rush` = Rush production; `tear_sheets` = Tear sheets ($5 per print insertion). `tear_sheets` requires a print ad.","explode":false,"in":"query","name":"extras","required":false,"schema":{"default":[],"description":"Optional production extras. `design` = Ad design service; `rush` = Rush production; `tear_sheets` = Tear sheets ($5 per print insertion). `tear_sheets` requires a print ad.","items":{"enum":["design","rush","tear_sheets"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}},"description":"The quote."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing fields."}},"summary":"Get an ad quote from query parameters"},"post":{"operationId":"postAdQuote","requestBody":{"content":{"application/json":{"example":{"advertiser":"business","digital":{"counties":["hampshire","franklin"],"format":"medium_rectangle","weekly_impressions":25000,"weeks":4},"extras":["design"],"print":{"color":"full","days":["thu","sun"],"section":"local","size":"quarter_page","weeks":4}},"schema":{"$ref":"#/components/schemas/QuoteRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}},"description":"The quote."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing fields."}},"summary":"Get an ad quote from a JSON body"}}},"servers":[{"url":"/"}]}