changedInput schema / examples
Previous value: -[
- {
- "query": "climate change"
- },
- {
- "limit": 25,
- "query": "healthcare reform"
- }
-]New value: +[
+ {
+ "limit": 10,
+ "query": "Lower Energy Costs Act"
+ },
+ {
+ "limit": 5,
+ "query": "crypto"
+ },
+ {
+ "congress": 111,
+ "limit": 5,
+ "query": "Patient Protection and Affordable Care Act"
+ }
+]
addedInput schema / properties / congress
Added value: +{
+ "description": "Optional Congress number (e.g. 111) to search exhaustively. Without it the three most recent Congresses are searched in depth and every earlier one only shallowly, so name a Congress when the bill is older than about six years.",
+ "type": "number"
+}
changedInput schema / properties / query / description
Previous value: -"Keywords to search for in bill titles"New value: +"Bill name, keywords or subject to match against bill titles, e.g. \"Lower Energy Costs Act\" or \"crypto\""
addedOutput schema / properties / bills / items / properties / match
Added value: +{
+ "description": "How well the bill's titles match the query: exact title, title containing the phrase, all query words present, some words present, or no title-word overlap",
+ "enum": [
+ "exact",
+ "phrase",
+ "all_words",
+ "partial",
+ "none"
+ ],
+ "type": "string"
+}
addedOutput schema / properties / bills / items / properties / matched_title
Added value: +{
+ "description": "The bill title (display, short or official) that produced the match tier, or null",
+ "type": [
+ "string",
+ "null"
+ ]
+}
changedOutput schema / properties / bills / items / required
Previous value: -[
- "id"
-]New value: +[
+ "id",
+ "match",
+ "matched_title"
+]
addedOutput schema / properties / candidates_ranked
Added value: +{
+ "description": "Number of distinct upstream candidate bills that were scored and ranked",
+ "type": "number"
+}
addedOutput schema / properties / congresses_searched
Added value: +{
+ "description": "Which Congresses were searched and how deeply: {in_depth, one_page, plus, hint} by default, or {exhaustive, coverage} when a congress argument was given",
+ "type": "object"
+}
addedOutput schema / properties / ranking
Added value: +{
+ "description": "How the bills are ordered: local title-match re-rank (exact > phrase > all_words > partial, newer Congress first on ties); GovTrack order is not by relevance",
+ "type": "string"
+}
changedOutput schema / properties / total / description
Previous value: -"Total matching bills available"New value: +"GovTrack loose keyword-match count for the query (any query word may match any bill title); see total_note"
addedOutput schema / properties / total_note
Added value: +{
+ "description": "Explains that total is a loose keyword-match count, not the number of bills about the subject",
+ "type": "string"
+}
changedOutput schema / required
Previous value: -[
- "query",
- "total",
- "returned",
- "bills"
-]New value: +[
+ "query",
+ "total",
+ "returned",
+ "bills",
+ "total_note",
+ "ranking",
+ "candidates_ranked",
+ "congresses_searched"
+]