curl -X POST "https://parsagon.io/api/events/v1/quick-search/" \
-H "Authorization: Token YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"categories": [34],
"context": "User is a medical association",
"filter_prompt": "Healthcare policy and regulatory developments impacting health insurers and healthcare providers\nLegislation related to insurance mandates, consumer protections, and healthcare affordability",
"date_range": {
"start_date": "2026-02-02T08:00",
"end_date": "2026-02-04T08:00"
}
}'
{
"search_results": [
{
"url": "https://legislature.maine.gov/LawMakerWeb/summary.asp?ID=280101474",
"title": "An Act to Lower Health Insurance Costs, Reduce Barriers to Health Care and Ensure Fair Prices for Health Care",
"text": "Be it enacted by the People of the State of Maine as follows:...",
"summary": "This act aims to lower health insurance costs, reduce barriers to health care, and ensure fair prices for health care services in Maine.",
"date": "2026-02-03",
"type": "LAW",
"extra_data": {
"last_action": "Committee on Health Coverage, Insurance and Financial Services suggested and ordered printed. The Bill was REFERRED to the Committee on HEALTH AND HUMAN SERVICES.",
"last_action_date": "2/3/2026"
},
"search_topics": [0],
"jurisdictions": ["US Maine"]
}
],
"error": null,
"is_test": false
}
Endpoints
Quick Search
Execute a search and receive results immediately, without needing to poll a persistent Search object for completion.
curl -X POST "https://parsagon.io/api/events/v1/quick-search/" \
-H "Authorization: Token YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"categories": [34],
"context": "User is a medical association",
"filter_prompt": "Healthcare policy and regulatory developments impacting health insurers and healthcare providers\nLegislation related to insurance mandates, consumer protections, and healthcare affordability",
"date_range": {
"start_date": "2026-02-02T08:00",
"end_date": "2026-02-04T08:00"
}
}'
{
"search_results": [
{
"url": "https://legislature.maine.gov/LawMakerWeb/summary.asp?ID=280101474",
"title": "An Act to Lower Health Insurance Costs, Reduce Barriers to Health Care and Ensure Fair Prices for Health Care",
"text": "Be it enacted by the People of the State of Maine as follows:...",
"summary": "This act aims to lower health insurance costs, reduce barriers to health care, and ensure fair prices for health care services in Maine.",
"date": "2026-02-03",
"type": "LAW",
"extra_data": {
"last_action": "Committee on Health Coverage, Insurance and Financial Services suggested and ordered printed. The Bill was REFERRED to the Committee on HEALTH AND HUMAN SERVICES.",
"last_action_date": "2/3/2026"
},
"search_topics": [0],
"jurisdictions": ["US Maine"]
}
],
"error": null,
"is_test": false
}
The Quick Search endpoint runs a search synchronously and returns results directly in the response. A Search object is still created and counts toward your quota, but unlike Advanced Search you don’t need to poll for results — they’re returned immediately.
Request body
array
required
Array of category IDs to include in the search results.
string
Additional context for the AI to tailor the search and reporting (for example, your organization or focus area). Maximum 1000 characters.
string
required
A list of policy topics to search for, one per line. Longer, descriptive phrases work best. Maximum 5000 characters.
object
A dictionary of string key-value pairs for your own record keeping. Use this to attach metadata to the search, such as the project or team it belongs to (for example,
{"project": "tax-reform", "team": "policy"}).boolean
Set to
true to validate the request and return example data without running a source search. Required fields such as categories, filter_prompt, and date_range are still validated normally.object
Custom dummy data to return when
is_test is true. Quick Search only supports custom search_results; it does not support custom edited outputs.Show Test data fields
Show Test data fields
array
Array of search result objects to return instead of Parsagon’s built-in example results.
object
required
Time period to search within. Must cover no more than 72 hours (3 days) — use either
start_date/end_date or duration_seconds ≤ 259200.Show Fixed range
Show Fixed range
Show Relative duration
Show Relative duration
number
Positive number of seconds before “now” to search within (maximum 259200).
Response
array
Array of search result objects.
Show Search result fields
Show Search result fields
string
URL of the source document.
string
Title of the document.
string
Date when Parsagon collected the document (ISO 8601, UTC). This may differ slightly from the original publication date.
string
Full text (or main body) of the document.
string
AI-generated 1–2 sentence summary of the document.
string
Type of document. Either
"ARTICLE" (press releases, announcements, generic articles, and similar content) or "LAW" (bills and legislation).object
For
"LAW" documents, an object containing additional legislative metadata. May include status, last_action, and last_action_date — not all fields are present on every document. For non-"LAW" documents, this is usually empty.array
List of integers, each being the zero-based index of a line in
filter_prompt that is relevant to this search result.array
List of jurisdictions that apply to this result.
string | null
Error message if an error occurred; otherwise
null.boolean
Whether the Search was created in test mode.
curl -X POST "https://parsagon.io/api/events/v1/quick-search/" \
-H "Authorization: Token YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"categories": [34],
"context": "User is a medical association",
"filter_prompt": "Healthcare policy and regulatory developments impacting health insurers and healthcare providers\nLegislation related to insurance mandates, consumer protections, and healthcare affordability",
"date_range": {
"start_date": "2026-02-02T08:00",
"end_date": "2026-02-04T08:00"
}
}'
{
"search_results": [
{
"url": "https://legislature.maine.gov/LawMakerWeb/summary.asp?ID=280101474",
"title": "An Act to Lower Health Insurance Costs, Reduce Barriers to Health Care and Ensure Fair Prices for Health Care",
"text": "Be it enacted by the People of the State of Maine as follows:...",
"summary": "This act aims to lower health insurance costs, reduce barriers to health care, and ensure fair prices for health care services in Maine.",
"date": "2026-02-03",
"type": "LAW",
"extra_data": {
"last_action": "Committee on Health Coverage, Insurance and Financial Services suggested and ordered printed. The Bill was REFERRED to the Committee on HEALTH AND HUMAN SERVICES.",
"last_action_date": "2/3/2026"
},
"search_topics": [0],
"jurisdictions": ["US Maine"]
}
],
"error": null,
"is_test": false
}
Test mode
Useis_test: true to test your integration without running a source search. The endpoint still validates the request body the same way it does for a normal Quick Search request.
Example test request body
{
"categories": [34],
"context": "User is a medical association",
"filter_prompt": "Healthcare policy and regulatory developments",
"date_range": {
"duration_seconds": 86400
},
"is_test": true,
"test_data": {
"search_results": [
{
"url": "https://example.com/policy-update",
"title": "Example policy update",
"text": "Example source text for testing.",
"summary": "Example summary returned in test mode.",
"date": "2026-02-03",
"type": "ARTICLE",
"extra_data": {},
"search_topics": [0],
"jurisdictions": ["US Maine"]
}
]
}
}