Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"since": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Default: 30 days ago, and only when no other filter is passed — a request carrying type, vendor, vendors, categories or category searches the whole change log unless since says otherwise. The filter compares against each record's date. Where date_meaning is \"effective\", that is the day the change took effect; where it is \"discovered\", it is the day we recorded the change, and when it took effect is unknown. Every response states the window it applied under date_window."
},
"vendor": {
"type": "string",
"description": "Filter to one vendor. Matched by case-insensitive substring, not by exact name: vendor=Pilot returns GitHub Copilot's records and category=ai returns Email's. Nothing is narrowed on your behalf, so read name_match, which every response carries: it names what this filter matched and whether each match was exact."
},
"vendors": {
"type": "string",
"description": "Comma-separated vendor names to filter (e.g. 'Vercel,Supabase'). When provided with categories, returns personalized results with advisory section. Matched by case-insensitive substring, not by exact name: vendor=Pilot returns GitHub Copilot's records and category=ai returns Email's. Nothing is narrowed on your behalf, so read name_match, which every response carries: it names what this filter matched and whether each match was exact."
},
"categories": {
"type": "string",
"description": "Comma-separated category names to filter (e.g. 'Database,Cloud Hosting'). Matched by case-insensitive substring, not by exact name: vendor=Pilot returns GitHub Copilot's records and category=ai returns Email's. Nothing is narrowed on your behalf, so read name_match, which every response carries: it names what this filter matched and whether each match was exact."
},
"change_type": {
"enum": [
"free_tier_removed",
"limits_reduced",
"restriction",
"limits_increased",
"new_free_tier",
"new_tier",
"pricing_restructured",
"open_source_killed",
"pricing_model_change",
"startup_program_expanded",
"pricing_postponed",
"product_deprecated",
"rebranded",
"record_corrected"
],
"type": "string",
"description": "Filter by type of change"
},
"lookahead_days": {
"type": "number",
"description": "Days to look ahead for expirations (default: 30)"
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"description": "Response detail level. 'concise': vendor, change_type, date, summary only. 'detailed': full response (default)."
},
"include_expiring": {
"type": "boolean",
"description": "Include upcoming expirations (default: true)"
},
"include_retracted": {
"type": "boolean",
"description": "Records we have withdrawn as our own error (standing 'retracted') are left out unless you ask for them. Set true to receive them alongside the rest; they arrive carrying standing 'retracted' and impact 'none'. Either way, retracted_excluded reports how many your query matched and did not receive."
},
"include_index_housekeeping": {
"type": "boolean",
"description": "Records of our own index housekeeping (reports 'our_index') are left out unless you ask for them. They say we stopped listing an offer of ours, not that the vendor changed anything, so counting them as vendor activity overstates it. Set true to receive them alongside the rest. Either way, index_housekeeping_excluded reports how many your query matched and did not receive."
}
},
"additionalProperties": false
}