Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getpg.ai/llms.txt

Use this file to discover all available pages before exploring further.

Search across multiple entity types in a single request. The API searches companies, contacts, and content in parallel and returns categorized results.
​
q
string
required
The search query. Must be at least 1 character.
​
types
string
Comma-separated list of entity types to search. Valid values: companies, contacts, content. Defaults to all types if not specified.
​
limit
integer
default:"10"
Maximum number of results per type. Range: 1–100.
curl -X GET "https://api.getpg.ai/public-api/v1/search?q=Tesco&types=companies,contacts&limit=5" \
  -H "x-api-key: your_api_key"

{
  "query": "Tesco",
  "total": 3,
  "results": {
    "companies": {
      "items": [
        {
          "id": "304599c3-212f-4122-b84a-d655a1455d31",
          "company_name": "Tesco",
          "website_domain": "tesco.com"
        }
      ],
      "count": 1
    },
    "contacts": {
      "items": [
        {
          "id": "deb3474b-5836-492c-aca4-4e0ccc8afbae",
          "full_name": "Iain Donachie",
          "current_job_title": "Head of Gift Cards UK & Ireland, Tesco"
        }
      ],
      "count": 1
    }
  }
}

​
Search Behavior

  • When types is omitted, all three types (companies, contacts, content) are searched in parallel.
  • Each type returns up to limit results independently.
  • If a specific type search fails, its result will include an error field, but other types will still return successfully.
  • The total field reflects the combined count across all returned types.

​
Error Responses

{
  "error": "Query parameter \"q\" is required and must be at least 1 character"
}

{
  "error": "Invalid types parameter. Valid values: companies, contacts, content"
}