ICIJ APIoffshoreleaks.icij.org ↗
Search entities, officers, and financial connections across Panama Papers, Pandora Papers, and more via the ICIJ Offshore Leaks API.
What is the ICIJ API?
This API provides structured access to the ICIJ Offshore Leaks Database through 5 endpoints, covering entities, officers, intermediaries, addresses, and their relationship graphs across investigations including the Panama Papers and Pandora Papers. The get_node_details endpoint returns a full connection graph — nodes with categories, properties, and statistics, plus typed edges linking related records. The search endpoint accepts keywords and an optional category filter to narrow results to specific record types.
curl -X GET 'https://api.parse.bot/scraper/a47ab11d-1882-4b7f-9266-a0ef9239a071/search?limit=5&query=offshore&category=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace offshoreleaks-icij-org-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: ICIJ Offshore Leaks Database — search, list, and inspect nodes."""
from parse_apis.icij_offshore_leaks_database_api import (
OffshoreLeaks, Category, NodeNotFound
)
client = OffshoreLeaks()
# Search for entities related to "offshore" filtered to Entity category
for result in client.searchresults.search(query="offshore", category=Category.ENTITY, limit=3):
print(result.name, result.score)
# List entities from the database
entity = client.entities.list(size=5, limit=1).first()
if entity:
print(entity.id, entity.properties.name, entity.properties.status)
# Get full node details with connection graph
try:
node = client.nodes.get(id=str(entity.id))
print(node.id, node.categories)
except NodeNotFound as exc:
print(f"Node not found: {exc}")
# List officers
for officer in client.officers.list(size=5, limit=3):
print(officer.id, officer.properties.name, officer.properties.data_source)
# Get database metadata
info = client.databaseinfos.get()
print(info.title, info.license)
print("exercised: searchresults.search / entities.list / nodes.get / officers.list / databaseinfos.get")
Full-text search across entities, officers, intermediaries, and addresses in the ICIJ Offshore Leaks Database via the Reconciliation API. Results are scored by relevance. An optional category filter narrows by node type. Returns up to `limit` results per call; no server-side pagination beyond that cap.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (1-100) |
| queryrequired | string | Search keyword (e.g., company name or individual name) |
| category | integer | Category filter: 0=Entity, 1=Officer, 2=Intermediary, 3=Address, 4=Other |
{
"type": "object",
"fields": {
"results": "array of search result objects each containing id, name, description, score, and types"
},
"sample": {
"data": {
"results": [
{
"id": "81026907",
"name": "Offshore Incorporations Centre",
"score": 26.67,
"types": [
{
"id": "https://offshoreleaks.icij.org/schema/oldb/address",
"name": "Address"
}
],
"description": "Address node extracted from the Paradise Papers - Appleby data."
}
]
},
"status": "success"
}
}About the ICIJ API
What the API Covers
The ICIJ Offshore Leaks Database aggregates records from major investigative leak datasets — Panama Papers, Pandora Papers, and others listed in the data_sources array returned by get_database_info. The database distinguishes four record types: entities (shell companies, foundations, trusts), officers (individuals or companies with roles in those entities), intermediaries (agents or law firms that set up offshore structures), and addresses. Each record carries a numeric ID used across all endpoints.
Search and Node Details
The search endpoint accepts a query string and an optional category integer (0=Entity, 1=Officer, 2=Intermediary, 3=Address, 4=Other) along with a limit parameter. Results include an id, name, description, relevance score, and types. Pass the returned id to get_node_details to retrieve the full connection graph for that record: the response includes a data array of node objects, each with a linkurious_id, categorized properties, node statistics, and an edges array describing typed relationships to other nodes in the graph.
Bulk Listing Endpoints
list_entities and list_officers support offset-based pagination with a size parameter (max 100 per page) and an offset ceiling of 9900. Entity records expose name, country_codes, data_source, jurisdiction, status, and incorporation_date among their properties. Officer records carry name, country_codes, icij_id, data_source, and valid_until. Both endpoints return a meta object with count, from, and size, plus a links object with first, last, next, and prev URLs for navigation.
Database Metadata
The get_database_info endpoint returns no inputs and provides the database title, a description string, a license identifier, and the full data_sources array listing each investigation name and year. This is useful for validating dataset coverage before bulk querying or building source attribution into an application.
The ICIJ API is a managed, monitored endpoint for offshoreleaks.icij.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when offshoreleaks.icij.org changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official offshoreleaks.icij.org API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Map the relationship graph of a named offshore entity using
get_node_detailsedges and node properties. - Bulk-export officer records with
list_officersto build a dataset of individuals named across multiple leak investigations. - Screen company names against the database using
searchwith category=0 to check for matches in offshore entity records. - Enumerate entities by jurisdiction using
list_entitiesand filtering on thejurisdictionproperty field. - Correlate
data_sourcevalues across entity and officer records to isolate records from a specific investigation like Pandora Papers. - Retrieve
icij_idfields from officer records to cross-reference individuals across ICIJ's other published datasets. - Retrieve database metadata via
get_database_infoto programmatically surface license and investigation scope in a research tool.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the ICIJ Offshore Leaks site have an official developer API?+
What does `get_node_details` return beyond basic record fields?+
data array where each node object includes a data sub-object with categories, properties (name, country, jurisdiction, source, etc.), and statistics. Crucially, it also includes an edges array describing typed relationships to other nodes — this is what lets you traverse the connection graph between entities, officers, intermediaries, and addresses.What are the pagination limits on the list endpoints?+
list_entities and list_officers both cap size at 100 records per page and offset at 9900, meaning a maximum of 10,000 records is reachable per endpoint through standard pagination. The meta.count field shows the total number of records in the database for that type, which will typically exceed 10,000. You can fork this API on Parse and revise it to add deeper offset or cursor-based access if your use case requires it.Does the API expose intermediary records through a dedicated list endpoint?+
get_node_details, but there is no list_intermediaries bulk endpoint equivalent to list_entities or list_officers. You can fork this API on Parse and revise it to add the missing endpoint.How fresh is the data, and does the API reflect newly published investigations?+
get_database_info endpoint returns a data_sources array that lists the investigations and their years currently included. ICIJ updates the database when new investigations are released, but there is no real-time feed — coverage is tied to ICIJ's own publication schedule.