Skip to main content
Search semantically across everything PG:AI holds for your accounts — public filings and news, uploaded materials, web pages, job postings, technologies, contacts, conversations, insights, and more. Results are ranked by relevance.
​
scope
string
required
Defines which accounts to search across.
  • organisation — searches every account tracked in your workspace
  • companies — restricts the search to the accounts you specify in company_ids
​
q
string
required
The search query. Must be at least 1 character.
​
company_ids
string
Comma-separated list of company UUIDs. Required when scope=companies. Ignored when scope=organisation.
​
page
integer
default:"1"
Page number for pagination.
​
per_source
integer
default:"25"
Maximum number of results returned per vector source. Range: 1–100.
​
date_from
string
ISO 8601 lower bound on result date (e.g. 2025-01-01).
​
date_to
string
ISO 8601 upper bound on result date (e.g. 2025-12-31).
Permission: companies:read 
curl -X GET "https://api.getpg.ai/public-api/v1/search?scope=organisation&q=AI+strategy&per_source=10" \
  -H "x-api-key: your_api_key"

{
  "items": [
    {
      "id": "abc123",
      "company_id": "304599c3-212f-4122-b84a-d655a1455d31",
      "company_name": "Tesco",
      "source_type": "news",
      "title": "Tesco announces AI-driven supply chain strategy",
      "excerpt": "Tesco's leadership outlined a multi-year plan to deploy AI across logistics...",
      "date": "2025-11-14T00:00:00.000Z",
      "score": 0.91
    }
  ],
  "total": 48,
  "page": 1,
  "per_page": 25,
  "resolved_company_count": 12
}
resolved_company_count is only present when scope=organisation. It shows how many distinct companies were searched.

​
Search Behavior

  • Results are ranked by semantic relevance, not recency. Use date_from / date_to to narrow to a time window.
  • per_source applies per vector source independently — the total number of results can exceed this value when multiple sources return results.
  • If a downstream source fails, the API still returns results from the remaining sources.