Skip to main content
curl -X POST "https://parsagon.io/api/events/v1/search/" \
  -H "Authorization: Token YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": [74],
    "context": "User needs to keep track of financial services regulations in the UK",
    "filter_prompt": "Policies related to financial market stability and supervision of financial institutions\nConsumer protection regulations related to financial products and services",
    "date_range": {
      "start_date": "2026-01-30T00:00",
      "end_date": "2026-02-01T00:00"
    }
  }'
{
  "search_results": [
    {
      "url": "http://www.legislation.gov.uk/uksi/2026/74/made/data.htm",
      "title": "The Financial Services and Markets Act 2000 (Regulated Activities) (Providing Targeted Support) (Amendment) Order 2026",
      "text": "# **2026 No. 74** **FINANCIAL SERVICES AND MARKETS** The Financial Services and Markets Act 2000 (Regulated Activities) (Providing Targeted Support) (Amendment) Order 2026\n\n\n_Made_        -        -        -        - _28th January 2026_\n\n\n_Laid before Parliament_ _30th January 2026_\n\n\n_Coming into force in accordance with article 1_\n\n\nThe Treasury make this Order in exercise of the powers conferred by section 22(1) and (5) of, and paragraph 25 of Schedule 2 to, the Financial Services and Markets Act 2000...",
      "summary": "This Order amends the Financial Services and Markets Act 2000 to provide targeted support within regulated activities, enabling the FCA to make rules, give guidance, and ensure consistent treatment across the financial regulatory framework.",
      "date": "2026-01-31",
      "type": "LAW",
      "extra_data": {},
      "search_topics": [0, 1]
    }
  ],
  "error": null
}
The Advanced Search endpoint creates a persistent Search object. The server processes the search asynchronously — use the returned id to poll for completion. Unlike Quick Search, Advanced Search supports date ranges up to 90 days and produces an AI-generated report alongside raw results.

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"}).
date_range
object
required
Time period to search within. May cover up to 90 days — use either start_date/end_date or duration_seconds ≤ 7776000.

Response

On success, returns the created Search object. Processing is asynchronous — search_results and edited_results will be null until the search completes.
id
number | string
Unique identifier for the Search. Use this to retrieve results once processing is complete.
categories
array
Array of category IDs used in the search.
context
string
Context provided in the request.
filter_prompt
string
Filter prompt provided in the request.
labels
object
Labels provided in the request.
date_range
object
The date range used, containing either start_date and end_date, or duration_seconds.
created_at
string
Timestamp when the Search was created (ISO 8601, UTC).
search_results
array | null
Raw search results once processing is complete. null if not yet finished. Each item has the same fields as Quick Search results.
edited_results
object | null
AI-generated report once processing is complete. null if not yet finished. When available, includes the report in both HTML and Markdown formats.
error
string | null
Error message if an error occurred; otherwise null.
curl -X POST "https://parsagon.io/api/events/v1/search/" \
  -H "Authorization: Token YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": [74],
    "context": "User needs to keep track of financial services regulations in the UK",
    "filter_prompt": "Policies related to financial market stability and supervision of financial institutions\nConsumer protection regulations related to financial products and services",
    "date_range": {
      "start_date": "2026-01-30T00:00",
      "end_date": "2026-02-01T00:00"
    }
  }'
{
  "search_results": [
    {
      "url": "http://www.legislation.gov.uk/uksi/2026/74/made/data.htm",
      "title": "The Financial Services and Markets Act 2000 (Regulated Activities) (Providing Targeted Support) (Amendment) Order 2026",
      "text": "# **2026 No. 74** **FINANCIAL SERVICES AND MARKETS** The Financial Services and Markets Act 2000 (Regulated Activities) (Providing Targeted Support) (Amendment) Order 2026\n\n\n_Made_        -        -        -        - _28th January 2026_\n\n\n_Laid before Parliament_ _30th January 2026_\n\n\n_Coming into force in accordance with article 1_\n\n\nThe Treasury make this Order in exercise of the powers conferred by section 22(1) and (5) of, and paragraph 25 of Schedule 2 to, the Financial Services and Markets Act 2000...",
      "summary": "This Order amends the Financial Services and Markets Act 2000 to provide targeted support within regulated activities, enabling the FCA to make rules, give guidance, and ensure consistent treatment across the financial regulatory framework.",
      "date": "2026-01-31",
      "type": "LAW",
      "extra_data": {},
      "search_topics": [0, 1]
    }
  ],
  "error": null
}