Search publications

Full-text search over company and mining-asset publications — exchange releases, company documents, and news coverage. Supports filtering by company, mining asset, content type, topic, source, and publication date.

POST/v1/publications/search/

Authorization

apiKeyAuth

AuthorizationBearer <token>

Organization API key, format pulse_<prefix>_<secret>. Created by an organization admin in Settings -> API Keys.

In: header

Request Body

application/json

Request shape for POST /v1/publications/search, pinned to PublicationSearchViewSet.get_params (apps/public_api/api/publications.py).

query?string

Full-text search term. Optional — omit to filter by the other fields alone.

scope?string

Where to match query: both, title, or body. Defaults to both; title is the fastest, title-only match.

company_ids?array<integer>|

Restrict to publications from these company ids. Resolve company names to ids via GET /v1/options/companies/options/ or a companies search.

mining_asset_id?|

Restrict to publications linked to this mining asset. Resolve asset names to ids via GET /v1/options/mining-assets/options/ or a mining-assets search.

content_kind?|

Restrict by publication content kind — a single value or a list. Valid values: technical_report, financial_report, corporate_report, announcement.

content_variant?|

Restrict by publication content variant — a single value or a list. Valid values via GET /v1/options/content-variants/options/.

topics?array<string>|

Restrict to publications tagged with these topic ids. Resolve topic names to ids via GET /v1/options/topics/options/.

source_type?|

Restrict by publication source type — a single value or a list. Valid values: exchange, company_website, web_search, sedar.

exchange_ids?array<integer>|

Restrict to publications announced on these exchange ids. Resolve exchange names to ids via GET /v1/options/exchanges/options/.

published_after?|

Only publications published on or after this UTC calendar date (YYYY-MM-DD), inclusive.

published_before?|

Only publications published on or before this UTC calendar date (YYYY-MM-DD), inclusive.

order?string

Sort order: newest (default), oldest, or relevance. relevance requires query.

limit?integer

Results per page, 1-50. Defaults to 20; larger values are clamped.

offset?integer

Number of results to skip. Defaults to 0.

Response Body

Matching publications.

Matching publications in results, with the total match count, a truncation flag, and the resolved entity scope when one was set.

results*array<>

Matching rows, one object per row — the 200 response example shows the row shape.

count*integer

Total number of matching rows, including any beyond the returned page.

truncated*boolean

true when results holds only part of the matches — page onward with limit/offset.

scope?|

Entity context, {"entity_type": "company" | "mining_asset", "id": ...}, when the search was filtered to exactly one company or mining asset; otherwise null. Not an echo of the request's scope string.

curl -X POST "https://example.com/v1/publications/search/" \  -H "Authorization: Bearer $PULSE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "query": "drill results",    "scope": "title",    "published_after": "2026-01-01",    "order": "newest",    "limit": 5  }'

{  "results": [    {      "entity_type": "publication",      "id": 2398253,      "title": "Rocky Shore Drills 15.0 metres of 2.04 g/t Au Including 5.0 metres of 3.85 g/t Au, Announces Discovery of the Lucky 13 Gold Zone",      "ai_headline": "Rocky Shore Gold Ltd announced the discovery of the Lucky 13 Gold Zone at its Gold Anchor Project following high-grade drill results",      "ai_summary": "Initial assays from the inaugural drill programme include 15.02 metres at 2.04 g/t gold at the newly discovered Lucky 13 Gold Zone...",      "published_date": "2026-08-05",      "company": {        "id": 9506,        "name": "Rocky Shore Gold Ltd"      },      "url": "https://webfiles-primary.thecse.com/news_releases/en/5220/d9e98e07-c2ad-4641-a8bb-3684ef4745a6",      "source_domain": "webfiles-primary.thecse.com",      "content_kind": "announcement",      "content_variant": "drill_results",      "source_type": "exchange",      "snippet": "Rocky Shore Drills 15.0 metres of 2.04 g/t Au Including 5.0 metres of 3.85 g/t"    }  ],  "count": 14256,  "truncated": true,  "scope": null}