Skip to main content

​
Overview

The Parsagon Search API gives you programmatic access to a daily-updated dataset of legislation, regulations, and other government publications across 70+ countries. We currently have active coverage for the following countries: Argentina, Australia, Austria, Belgium, Brazil, Bulgaria, Canada, Chile, China, Colombia, Costa Rica, Croatia, Cyprus, Czech Republic, Denmark, Dominican Republic, Ecuador, Egypt, Estonia, European Union, Finland, France, Germany, Greece, Hong Kong, Hungary, India, Indonesia, Ireland, Israel, Italy, Japan, Kazakhstan, Kenya, Kuwait, Latvia, Lithuania, Malaysia, Malta, Mexico, Netherlands, New Zealand, Nigeria, Norway, Peru, Philippines, Poland, Portugal, Qatar, Romania, Saudi Arabia, Singapore, Slovakia, Slovenia, South Africa, South Korea, Spain, Sweden, Switzerland, Taiwan, Thailand, Turkey, Turkmenistan, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vietnam If you need coverage for a jurisdiction we don’t currently list, we can typically add it quickly. We can ingest and deliver essentially any publicly available government material (where available in a jurisdiction), including:
  • Legislation
  • Regulations
  • Consultations
  • Guidance
  • Enforcement actions
  • Press releases and announcements
  • Speeches
  • Mainstream business/political news

​
Methods

The API provides three ways to retrieve data: Quick Search runs an ad-hoc search and returns results immediately. Use this for one-off queries over a window of up to 72 hours. No persistent object is created. Advanced Search creates a persistent Search object and processes it asynchronously. It supports date ranges up to 90 days and can produce an AI-generated report alongside raw results. Poll the returned id to retrieve results once processing is complete. Get Category Sources returns the full chronological list of all sources collected for a given data category, without any AI filtering or summarization. Use this to retrieve raw, unfiltered data for a specific category, covering up to the last 90 days.

​
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
  }
}