Skip to main content
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

​
categories
array
required
Array of category IDs to include in the search results.
​
context
string
Additional context for the AI to tailor the search and reporting (for example, your organization or focus area). Maximum 1000 characters.
​
filter_prompt
string
required
A list of policy topics to search for, one per line. Longer, descriptive phrases work best. Maximum 5000 characters.
​
labels
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"}).
​
is_test
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.
​
test_data
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.
​
date_range
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.

​
Response

​
search_results
array
Array of search result objects.
​
error
string | null
Error message if an error occurred; otherwise null.
​
is_test
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

Use is_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"]
      }
    ]
  }
}