To query Cicero data, you will need to use the correct API endpoint along with the user ID and token obtained using your username and password. Look at the documentation for each object type to see what fields may be used.
Use an asterisk (*) at the beginning, end, or middle of a phrase, or at both the beginning and the end to find results where the value starts with, ends with, or contains the text provided.
|*lark||Clark, Klark, Lark|
|Johns*||Johnson, Johnston, Johns|
|Je*ings||Jenings, Jennings, Jellings|
To query a field with an OR condition, simply use that parameter as many times as needed for each condition to test.
Example: To find elected officials with the last name Jones, Lee, or Rodriguez, use:
Use ‘true’, ‘false’, and ‘null’ in the query string when querying boolean values.
Example: To find by-elections (also known as special elections), we can query the is_by_election field:
Example: To find elections that are not by-elections, or if it is unknown whether or not they are by-elections, we can combine the use of ‘false’ and ‘null’:
The default ascending sort order for booleans is null, false, true.
Example: To find elections ending in November 2012, use:
Because relative dates are based on Universal Coordinated Time (the time on our servers), results may be a day offset from your users’ location. For example, if it is 8pm in New York, using on_or_after will not return results matching the current date in New York (it would be midnight or 1am the next day in UTC, depending on whether or not daylight savings time is in effect).