Skip to main content
POST
https://parsagon.io
/
api
/
events
/
v1
/
search
Create advanced search
curl --request POST \
  --url https://parsagon.io/api/events/v1/search/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "categories": [
    {}
  ],
  "context": "<string>",
  "filter_prompt": "<string>",
  "date_range": {
    "start_date": "<string>",
    "end_date": "<string>",
    "duration_seconds": 123
  }
}
'
{
  "id": {},
  "categories": [
    {}
  ],
  "context": "<string>",
  "filter_prompt": "<string>",
  "date_range": {},
  "created_at": "<string>",
  "search_results": {},
  "edited_results": {},
  "error": {}
}
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 monitoring 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.
​
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.
​
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 monitoring 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.