Skip to main content

​
Overview

The Parsagon Search API gives you programmatic access to political monitoring data and AI-generated monitoring reports.

​
Base URL

All endpoints are relative to: 
https://parsagon.io/api/events/v1/

​
Authentication

All requests must be authenticated using an API key. Include your API key in the Authorization HTTP header, prefixed with Token and a space: 
Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b
You can view and manage your API key by logging into Parsagon and visiting your settings page.

​
Content types

Request bodies must be sent as JSON: 
Content-Type: application/json
Responses are returned as JSON.

​
Shared request schema

Both Quick Search and Advanced Search use the same request body schema.
​
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 description of what to search for. This should be a list of policy topics, one per line — longer, descriptive phrases work best. Maximum 5000 characters.
Example filter_prompt
Government funding and subsidies for aerospace R&D innovation
Workforce development and skills programs for aerospace manufacturing, engineering, and skilled labour
Regulations governing aviation safety, environmental impact, and emissions standards
​
date_range
object
required
Constrains the time period for documents. Specify either a fixed range (start_date and end_date) or a relative duration (duration_seconds).

​
Date range limits

EndpointMaximum window
Quick Search72 hours (3 days) — duration_seconds ≤ 259200
Advanced Search90 days — duration_seconds ≤ 7776000
For all search types, the earliest supported start_date is 90 days before the time of the request. Historical data older than 90 days is available upon request. Example request body: 
{
  "categories": [1, 2],
  "context": "User is a Government Relations Manager for an aerospace company in the UK.",
  "filter_prompt": "Government funding and subsidies for aerospace R&D innovation\nWorkforce development and skills programs for aerospace manufacturing, engineering, and skilled labour\nRegulations governing aviation safety, environmental impact, and emissions standards",
  "date_range": {
    "duration_seconds": 259200
  }
}