{
  "openapi": "3.0.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  "servers": [
    {
      "url": "https://api.pubrio.com"
    }
  ],
  "info": {
    "description": "The Pubrio API delivers market expansion intelligence — real-time signals that flag when a company enters a new market — alongside the company and people data beneath them. Search, look up, and enrich accounts and contacts, and subscribe to typed, dated movement signals across 200+ markets.",
    "version": "1.0.0",
    "title": "Pubrio OpenAPI",
    "termsOfService": "https://pubrio.com/en/terms-of-service",
    "contact": {
      "email": "king.lai@pubrio.com",
      "name": "King Lai",
      "url": "https://pubrio.com/en/get-in-touch"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
    }
  },
  "tags": [
    {
      "name": "Profile",
      "description": "Workspace profile information and usage statistics"
    },
    {
      "name": "Enrichment",
      "description": "Enrich people and company records with detailed B2B data"
    },
    {
      "name": "Lookalike",
      "description": "Find companies similar to a given company"
    },
    {
      "name": "Search",
      "description": "Search for people, companies, jobs, news, and advertisements with filters"
    },
    {
      "name": "Lookup",
      "description": "Look up detailed information for specific people, companies, jobs, news, advertisements, and technologies"
    },
    {
      "name": "LinkedIn",
      "description": "Look up people and company data via LinkedIn profile URLs"
    },
    {
      "name": "Redeem",
      "description": "Redeem credits to unlock people contact details (single and batch)"
    },
    {
      "name": "Channels",
      "description": "Manage outreach channel templates (create, update, delete, list)"
    },
    {
      "name": "Monitor",
      "description": "Create and manage data monitors with webhooks, statistics, and processing"
    },
    {
      "name": "Filters",
      "description": "Retrieve available filter values for search parameters (technologies, locations, verticals, etc.)"
    },
    {
      "name": "API Keys",
      "description": "List and inspect API request logs and usage analytics for API keys"
    },
    {
      "name": "Insights",
      "description": "Aggregated signal insights for companies (jobs, news, advertisements)."
    },
    {
      "name": "Export",
      "description": "Bulk data exports (credit-gated)."
    },
    {
      "name": "Expansion",
      "description": "Company market-expansion intelligence: signals, stages, markets, and exports."
    }
  ],
  "paths": {
    "/companies/lookup/enrich": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company enrichment details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context — echoed `filters` and `parameters`, plus a `profile` block with `credit`, `topup_credit` and `total_credit_cost` when credit accounting is requested."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    },
                    "jobs": {
                      "type": "array",
                      "description": "Recent job postings for the company, returned inline so you do not need a separate Job Search call.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "news": {
                      "type": "array",
                      "description": "Recent news mentions for the company, returned inline so you do not need a separate News Search call.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "advertisements": {
                      "type": "array",
                      "description": "Recent advertisements for the company, returned inline so you do not need a separate Advertisement Search call.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "similar_companies": {
                      "type": "array",
                      "description": "Companies similar to this one. Empty when no close match is found.",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "is_enrichment_available": false,
                    "parameters": null
                  },
                  "data": {
                    "logo_url": "https://buckets.pubrio.com/company-logo/MTA4NjI1MTNzdHJpcGUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                    "emails": [
                      "..."
                    ],
                    "phones": [
                      "..."
                    ],
                    "contacts": [
                      "..."
                    ],
                    "estimated_revenue": 14400000000,
                    "publicly_traded_symbol": null,
                    "publicly_traded_exchange": null,
                    "linkedin_name": "stripe",
                    "domains": [
                      "stripe.com"
                    ],
                    "locations": [
                      "US"
                    ],
                    "categories": [
                      "1",
                      "26",
                      "28",
                      "33",
                      "37",
                      "38",
                      "39",
                      "43",
                      "56",
                      "60",
                      "64",
                      "69",
                      "71",
                      "81",
                      "116",
                      "129",
                      "147",
                      "254",
                      "979",
                      "3014",
                      "707847256"
                    ],
                    "verticals": [
                      "24076059",
                      "24096599",
                      "69085143",
                      "69107205"
                    ],
                    "vertical_categories": [
                      "9",
                      "16",
                      "18"
                    ],
                    "vertical_sub_categories": [
                      "74",
                      "103",
                      "120"
                    ],
                    "company_ranking": 221,
                    "title": "Help increase the GDP of the internet.",
                    "company_type": "Privately Held",
                    "description": "Stripe is a financial infrastructure platform for businesses. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.",
                    "company_address": "South San Francisco, California",
                    "linkedin_uid": "2135371",
                    "company_name": "Stripe",
                    "founded_year": 2010,
                    "industry": "Technology, Information And Internet",
                    "specialties": [
                      "Technology, Information And Internet",
                      "Financial Services",
                      "E-commerce",
                      "Information Technology & Services"
                    ],
                    "domain": "stripe.com",
                    "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee",
                    "domain_id": 10862513,
                    "parent_id": null,
                    "linkedin_company_id": 1407685,
                    "domain_ids": [
                      10862513,
                      3254042745,
                      2617941789,
                      953909397,
                      368243151
                    ],
                    "country_code": "US",
                    "company_size": 11300,
                    "company_keywords": [
                      "payments",
                      "developer tools",
                      "cloud infrastructure",
                      "credit cards",
                      "consumer internet",
                      "enterprise software",
                      "software",
                      "internet",
                      "information technology",
                      "technology, information & internet",
                      "global payments",
                      "online payments",
                      "payment links",
                      "checkout solutions",
                      "subscription billing",
                      "invoicing",
                      "fraud prevention",
                      "identity verification",
                      "financial automation",
                      "business financing",
                      "virtual cards",
                      "embedded finance",
                      "transaction monitoring",
                      "data analytics",
                      "payment methods"
                    ],
                    "is_company_url_active": true,
                    "company_url": "https://stripe.com/",
                    "youtube_url": null,
                    "github_url": null,
                    "x_url": null,
                    "crunchbase_url": null,
                    "linkedin_url": "https://www.linkedin.com/company/stripe",
                    "instagram_url": null,
                    "facebook_url": "https://facebook.com/stripehq",
                    "twitter_url": "http://twitter.com/stripe",
                    "country": "United States",
                    "location": "United States",
                    "sequences": null,
                    "saved_lists": null,
                    "company_addresses": [
                      "354 Oyster Point Blvd South San Francisco, California 94080, US",
                      "1 Grand Canal Street Lower Dublin, County Dublin, IE",
                      "920 5th Ave Seattle, Washington 98104, US",
                      "211 Old Street London, England EC1V 9NR, GB",
                      "10, Boulevard Haussmann Paris, Ile-de-France 75009, FR",
                      "89 Neil Rd Central Business District, Singapore 088894, SG",
                      "1-5-8 Jingumae Tokyo, Shibuya-ku 150-0001, JP",
                      "515 N State St Chicago, Illinois 60610, US",
                      "11 Park Pl New York, NY 10301, US",
                      "Singel 542 Amsterdam, North Holland 1017, NL",
                      "Avenida Paseo De La Reforma 296 Ciudad De Mexico, Colonia Juarez 06600, MX",
                      "222 Exhibition St Melbourne, Victoria 3000, AU",
                      "Avenida Paulista 1374 Paulínia, São Paulo 13140-000, BR",
                      "Church Street Haridevpur, Shanthala Nagar, Ashok Nagar Bengaluru, Karnataka 560001, IN"
                    ],
                    "company_size_printed": "11,300+"
                  },
                  "jobs": [
                    {
                      "job_id": "e4077f8d-2b3d-4a9b-935e-123faae6f9a2",
                      "job_search_id": "e4077f8d-2b3d-4a9b-935e-123faae6f9a2",
                      "last_modified": "2025-06-05T08:04:00.294Z",
                      "companies": {
                        "logo_url": "https://buckets.pubrio.com/company-logo/MTA4NjI1MTNzdHJpcGUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                        "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee",
                        "company_name": "Stripe",
                        "linkedin_name": "stripe",
                        "country_code": "US",
                        "domain": "stripe.com"
                      },
                      "location": "Toronto, Ontario, Canada",
                      "job_url": "https://ca.linkedin.com/jobs/view/program-lead-stripe-startups-at-stripe-4244851093?position=9&pageNum=0&refId=dSWk2H9vKbZkQFgUb0YAqA%3D%3D&trackingId=tU1BYodLertdWt%2F7NIn4Tw%3D%3D",
                      "posting_date": "2025-06-04",
                      "country_code": "CA",
                      "location_id": 395,
                      "title": "Program Lead, Stripe Startups",
                      "country": "Canada"
                    },
                    "..."
                  ],
                  "news": [
                    {
                      "news_id": "032606ce-46b6-4bf5-9aa9-8ecc96f126bc",
                      "news_search_id": "15872966-7b73-4361-be8f-2415bf4c72d9",
                      "domains": [
                        "openai.com",
                        "microsoft.com",
                        "anthropic.com",
                        "perplexity.ai",
                        "stripe.com",
                        "github.com",
                        "salesforce.com",
                        "canva.com",
                        "adobe.com",
                        "atlassian.com",
                        "zoom.us"
                      ],
                      "companies": [
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MzA2MTI3NThhdGxhc3NpYW4uY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "1437c841-a4b8-48c1-9be3-3dafb68dfd41",
                          "country_code": "AU",
                          "company_name": "Atlassian",
                          "linkedin_name": "atlassian",
                          "domain": "atlassian.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/NTU1MDU5MDdhbnRocm9waWMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "15dd54c6-12b4-494a-84f4-9fff676ac7e0",
                          "country_code": "US",
                          "company_name": "Anthropic",
                          "linkedin_name": "anthropicresearch",
                          "domain": "anthropic.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MjMzNDM2OTQxYWRvYmUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "1fda6cfb-dacd-40a9-bb77-21ebc81c79e2",
                          "country_code": "US",
                          "company_name": "Adobe",
                          "linkedin_name": "adobe",
                          "domain": "adobe.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTUyODdzYWxlc2ZvcmNlLmNvbWxpbmtlZGluX3BfbG9nbzE1.jpg",
                          "domain_search_id": "29437edb-9d9a-45a3-8f43-481cbfaab1bf",
                          "country_code": "US",
                          "company_name": "Salesforce",
                          "linkedin_name": "salesforce",
                          "domain": "salesforce.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MTA4NjI1MTNzdHJpcGUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee",
                          "country_code": "US",
                          "company_name": "Stripe",
                          "linkedin_name": "stripe",
                          "domain": "stripe.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MzA2MTIzNTVvcGVuYWkuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "67c4696b-b7b0-46b5-b2af-9f434543661e",
                          "country_code": "US",
                          "company_name": "Openai",
                          "linkedin_name": "openai",
                          "domain": "openai.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MzY4MjQyNzQ4aWxqOXNzbmoxZ2l0aHViLmNvbWxpbmtlZGluXzE0MDY4NDg=.jpg",
                          "domain_search_id": "838c52f2-ab18-4258-b37c-e00bc568f747",
                          "country_code": "US",
                          "company_name": "Github",
                          "linkedin_name": "github",
                          "domain": "github.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MTU0MDk4MjAxMHpvb20udXNsaW5rZWRpbl9wX2xvZ28xNQ==.jpg",
                          "domain_search_id": "a90c7f40-ed1a-4675-b348-f36cbcf94481",
                          "country_code": "US",
                          "company_name": "Zoom",
                          "linkedin_name": "zoom",
                          "domain": "zoom.us"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MzA2MTIyODdjYW52YS5jb21saW5rZWRpbl9wX2xvZ28xNQ==.jpg",
                          "domain_search_id": "b5405a6c-81a7-4f86-bd09-ebf728b667bf",
                          "country_code": "AU",
                          "company_name": "Canva",
                          "linkedin_name": "canva",
                          "domain": "canva.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MTQyMjQxMjk4bWljcm9zb2Z0LmNvbWxpbmtlZGluX3BfbG9nbzE1.jpg",
                          "domain_search_id": "dd225537-283f-46bf-ba1c-cb0c6a1311bb",
                          "country_code": "US",
                          "company_name": "Microsoft",
                          "linkedin_name": "microsoft",
                          "domain": "microsoft.com"
                        },
                        {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MTU0MDk4MjEyNnBlcnBsZXhpdHkuYWlsaW5rZWRpbl9wX2xvZ28xNQ==.jpg",
                          "domain_search_id": "fe169c45-f426-4ec4-985e-c88b2d78d044",
                          "country_code": "US",
                          "company_name": "Perplexity",
                          "linkedin_name": "perplexity-ai",
                          "domain": "perplexity.ai"
                        }
                      ],
                      "news_galleries": [
                        {
                          "slug": "technology",
                          "news_gallery_id": "9536114f-231a-489c-8a8a-1cbf82a327a4",
                          "name": "Technology"
                        }
                      ],
                      "locations": [
                        "China"
                      ],
                      "last_modified": "2025-06-04T07:43:14.260Z",
                      "image_url": "https://analyticsindiamag.com/wp-content/uploads/2025/06/ai-monetisation-llm.jpg",
                      "url": "https://analyticsindiamag.com/ai-features/llm-companies-vs-saas-giants-whos-winning-in-ai-monetisation/",
                      "published_at": "2025-06-04T07:03:49.000000Z",
                      "language": "en",
                      "source": "analyticsindiamag.com",
                      "category": "launches",
                      "title": "LLM companies vs SaaS giants: AI monetization race",
                      "summary": "LLM companies show rapid growth but struggle with profitability, while SaaS giants integrate AI cautiously into existing services, leveraging their large user base.",
                      "news_category_name": "Launches"
                    },
                    "..."
                  ],
                  "similar_companies": [
                    {
                      "logo_url": "https://buckets.pubrio.com/company-logo/MzY4MjQzODc3cmlwcGxlLmNvbWxpbmtlZGluX3BfbG9nbzE1.jpg",
                      "emails": [
                        "..."
                      ],
                      "phones": [
                        "..."
                      ],
                      "contacts": [
                        "..."
                      ],
                      "similarity_score": 0.6540610253955462,
                      "estimated_revenue": 500000000,
                      "publicly_traded_symbol": null,
                      "publicly_traded_exchange": null,
                      "linkedin_name": "rippleofficial",
                      "domains": [
                        "ripple.com"
                      ],
                      "locations": [
                        "US"
                      ],
                      "categories": null,
                      "verticals": [
                        "69086483",
                        "24076059",
                        "69085537",
                        "69107205"
                      ],
                      "vertical_categories": [
                        "16",
                        "18"
                      ],
                      "vertical_sub_categories": [
                        "103",
                        "120"
                      ],
                      "company_ranking": 8133,
                      "title": "We're building the Internet of Value.",
                      "company_type": "Privately Held",
                      "description": "Using proven crypto and blockchain technology honed over a decade, Ripple’s enterprise-grade solutions are faster, more transparent, and more cost-effective than traditional financial services. Our customers use these solutions to source crypto, facilitate instant payments, empower their treasury, engage new audiences, lower capital requirements, and drive new revenue. Founded in 2012, Ripple's vision is to enable a world where value moves as seamlessly as information flows today—an Internet of Value. Ripple is the only enterprise blockchain company today with products in commercial use. Ripple’s global payments network includes over 300 customers across 40+ countries and six continents.",
                      "company_address": "San Francisco, CA",
                      "linkedin_uid": "3249443",
                      "company_name": "Ripple",
                      "founded_year": 2012,
                      "industry": "Technology, Information And Internet",
                      "specialties": [
                        "Technology",
                        "Technology, Information And Internet",
                        "Financial Services",
                        "Blockchain"
                      ],
                      "domain": "ripple.com",
                      "domain_search_id": "eac9e802-d574-4f5f-b7d9-4daadbdcd630",
                      "domain_id": 368243877,
                      "parent_id": null,
                      "linkedin_company_id": 1408892,
                      "domain_ids": [
                        368243877,
                        3252571626,
                        1758856012,
                        2617948464
                      ],
                      "country_code": "US",
                      "company_size": 1400,
                      "company_keywords": [
                        "crossborder payments",
                        "financial technology",
                        "cryptography",
                        "distributed ledgers",
                        "fintech",
                        "finance",
                        "blockchain",
                        "payments",
                        "cryptocurrency",
                        "fin tech",
                        "blockchains",
                        "blockchain / cryptocurrency",
                        "technology, information & internet",
                        "digital asset custody",
                        "blockchain technology",
                        "real-time settlement",
                        "liquidity management",
                        "stablecoin issuance",
                        "enterprise blockchain",
                        "xrp ledger",
                        "secure custody solutions",
                        "digital asset management",
                        "financial institutions",
                        "tokenization"
                      ],
                      "is_company_url_active": true,
                      "company_url": "https://www.ripple.com/",
                      "youtube_url": null,
                      "github_url": null,
                      "x_url": "https://x.com/ripple",
                      "crunchbase_url": null,
                      "linkedin_url": "https://www.linkedin.com/company/rippleofficial",
                      "instagram_url": null,
                      "facebook_url": null,
                      "twitter_url": "https://twitter.com/ripple",
                      "country": "United States",
                      "location": "United States",
                      "sequences": null,
                      "saved_lists": null,
                      "company_addresses": [
                        "San Francisco, CA 94104, US"
                      ],
                      "company_size_printed": "1,400+"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "companies_enrich",
        "summary": "Enrich a company record",
        "description": "Realtime company enrichment. Returns the company record plus its recent hiring, media, advertising and similar-company signals in one call.\n\n**The first call for a company can be slow.** When the record has to be enriched from scratch, expect tens of seconds — a measured cold call took 45 seconds. Once enriched, the same company returns in well under a second. Set your HTTP client timeout to at least 90 seconds: many clients default to 30 and will abort a cold call that would have succeeded. If you only ever need the stored record, call [Company Lookup](/en/api-reference/endpoint/companies/lookup) instead, which is always fast.",
        "tags": [
          "Enrichment"
        ]
      }
    },
    "/people/search": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing people search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context: echoed `filters` and `parameters`, an optional `profile` credit block, and `ignored_fields` (body keys the endpoint dropped)."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "management_levels": [
                        "c_suite"
                      ]
                    },
                    "profile": null
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 199616132,
                      "total_pages": 100,
                      "total_display_pages": 100,
                      "is_timeout": false
                    },
                    "peoples": [
                      {
                        "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946",
                        "name": "Doug McMillon",
                        "first_name": "Doug",
                        "last_name": "McMillon",
                        "title": "President & CEO",
                        "seniority": "c_suite",
                        "functions": null,
                        "headline": "President & CEO at Walmart Inc.",
                        "tagline": null,
                        "introduction": null,
                        "description": null,
                        "departments": [
                          "c_suite"
                        ],
                        "subdepartments": [
                          "executive"
                        ],
                        "keywords": null,
                        "employment_history": [
                          {
                            "title": "President & CEO",
                            "current": true,
                            "end_date": null,
                            "start_date": "2014-02-01",
                            "company_name": "Walmart"
                          },
                          {
                            "title": "President & CEO, Walmart International",
                            "current": false,
                            "end_date": "2014-01-01",
                            "start_date": "2009-02-01",
                            "company_name": "Walmart"
                          },
                          {
                            "title": "President & CEO",
                            "current": false,
                            "end_date": "2009-01-01",
                            "start_date": "2005-08-01",
                            "company_name": "Sam's Club"
                          }
                        ],
                        "country": "United States",
                        "country_code": "US",
                        "location": "United States",
                        "state": "Arkansas",
                        "city": "Bentonville",
                        "wantedly_name": null,
                        "rocketpunch_name": null,
                        "contacts": null,
                        "contact_types": [],
                        "emails": null,
                        "phones": null,
                        "facebook_url": null,
                        "github_url": null,
                        "twitter_url": null,
                        "linkedin_url": "http://www.linkedin.com/in/dougmcmillon",
                        "wantedly_url": null,
                        "rocketpunch_url": null,
                        "saved_lists": null,
                        "sequences": null,
                        "social_metadata": {},
                        "company": {
                          "company_name": "Walmart",
                          "company_url": "http://walmart.com",
                          "is_company_url_active": true,
                          "domain": "walmart.com",
                          "domain_id": 26067151,
                          "domain_ids": [
                            757023267,
                            368242703,
                            26067151
                          ],
                          "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6",
                          "founded_year": 1962,
                          "country": "United States",
                          "country_code": "US",
                          "location": "United States",
                          "phones": null,
                          "emails": [],
                          "contacts": [],
                          "wantedly_name": null,
                          "rocketpunch_name": null,
                          "tiktok_name": null,
                          "company_size_printed": "466,000",
                          "company_size": 466000,
                          "industry": "Retail",
                          "specialties": [
                            "Retail",
                            "E-commerce"
                          ],
                          "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg",
                          "linkedin_url": "http://www.linkedin.com/company/walmart",
                          "facebook_url": "http://facebook.com/walmart",
                          "twitter_url": "https://twitter.com/walmart",
                          "crunchbase_url": null,
                          "instagram_url": "http://instagram.com/walmart",
                          "youtube_url": "http://youtube.com/user/walmart",
                          "x_url": null,
                          "github_url": null,
                          "tiktok_url": null,
                          "wantedly_url": null,
                          "rocketpunch_url": null,
                          "social_metadata": {}
                        }
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "search_term": {
                    "$ref": "#/components/schemas/search_term"
                  },
                  "people_name": {
                    "$ref": "#/components/schemas/people_name"
                  },
                  "people_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "exclude_people_titles": {
                    "$ref": "#/components/schemas/exclude_people_titles"
                  },
                  "peoples": {
                    "$ref": "#/components/schemas/peoples"
                  },
                  "management_levels": {
                    "$ref": "#/components/schemas/management_levels"
                  },
                  "departments": {
                    "$ref": "#/components/schemas/departments"
                  },
                  "exclude_departments": {
                    "$ref": "#/components/schemas/exclude_departments"
                  },
                  "department_functions": {
                    "$ref": "#/components/schemas/functions"
                  },
                  "exclude_department_functions": {
                    "$ref": "#/components/schemas/exclude_department_functions"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "people_locations": {
                    "$ref": "#/components/schemas/people_locations"
                  },
                  "exclude_people_locations": {
                    "$ref": "#/components/schemas/exclude_people_locations"
                  },
                  "company_locations": {
                    "$ref": "#/components/schemas/company_locations"
                  },
                  "company_exclude_locations": {
                    "$ref": "#/components/schemas/company_exclude_locations"
                  },
                  "company_linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/people_linkedin_urls"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "company_filters": {
                    "$ref": "#/components/schemas/company_filters"
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/people_filter_conditions"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/is_enable_similarity_search"
                  },
                  "similarity_score": {
                    "$ref": "#/components/schemas/similarity_score"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "query": {
                    "type": "string",
                    "example": "decision makers in marketing",
                    "description": "Natural-language search. When provided, Pubrio interprets it into the person and company filters below (job role, seniority, department, location, industry, company size, and more). Any explicit filters you also pass take precedence over the interpreted ones. Leave empty to search purely by the structured filters."
                  },
                  "is_include_similar_people_titles": {
                    "type": "boolean",
                    "description": "Enabled by default. `people_titles` also matches close variants of each title (for example, `software engineer` matches `senior software engineer`). `metadata.filters.people_titles` returns the full list that was searched.",
                    "default": true
                  },
                  "people_title_similarity_score": {
                    "type": "number",
                    "format": "float",
                    "example": 0.9,
                    "description": "Used together with `is_include_similar_people_titles`. Controls how closely a title must match; the higher the number, the stricter the match."
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "categories": {
                    "$ref": "#/components/schemas/categories"
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "keywords": {
                    "$ref": "#/components/schemas/keywords"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "company_places": {
                    "$ref": "#/components/schemas/places"
                  },
                  "company_exclude_places": {
                    "$ref": "#/components/schemas/exclude_places"
                  }
                }
              }
            }
          }
        },
        "operationId": "people_search",
        "summary": "Search for people",
        "description": "Search the Pubrio database for people matching specified criteria such as job title, location, company, and seniority.",
        "tags": [
          "Search"
        ]
      }
    },
    "/people/search/similar": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing people search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context — echoed `filters` and `parameters`, plus a `profile` block with `credit`, `topup_credit` and `total_credit_cost` when credit accounting is requested."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "people_titles": [
                        "chief executive officer"
                      ]
                    },
                    "profile": null
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 25,
                      "total_pages": 1,
                      "total_display_pages": 1,
                      "is_timeout": false
                    },
                    "peoples": [
                      {
                        "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946",
                        "name": "Doug McMillon",
                        "first_name": "Doug",
                        "last_name": "McMillon",
                        "title": "President & CEO",
                        "similarity_score": 0.97,
                        "seniority": "c_suite",
                        "functions": null,
                        "headline": "President & CEO at Walmart Inc.",
                        "tagline": null,
                        "introduction": null,
                        "description": null,
                        "departments": [
                          "c_suite"
                        ],
                        "subdepartments": [
                          "executive"
                        ],
                        "keywords": null,
                        "employment_history": [
                          {
                            "title": "President & CEO",
                            "current": true,
                            "end_date": null,
                            "start_date": "2014-02-01",
                            "company_name": "Walmart"
                          },
                          {
                            "title": "President & CEO, Walmart International",
                            "current": false,
                            "end_date": "2014-01-01",
                            "start_date": "2009-02-01",
                            "company_name": "Walmart"
                          },
                          {
                            "title": "President & CEO",
                            "current": false,
                            "end_date": "2009-01-01",
                            "start_date": "2005-08-01",
                            "company_name": "Sam's Club"
                          }
                        ],
                        "country": "United States",
                        "country_code": "US",
                        "location": "United States",
                        "state": "Arkansas",
                        "city": "Bentonville",
                        "wantedly_name": null,
                        "rocketpunch_name": null,
                        "contacts": null,
                        "contact_types": [],
                        "emails": null,
                        "phones": null,
                        "facebook_url": null,
                        "github_url": null,
                        "twitter_url": null,
                        "linkedin_url": "http://www.linkedin.com/in/dougmcmillon",
                        "wantedly_url": null,
                        "rocketpunch_url": null,
                        "saved_lists": null,
                        "sequences": null,
                        "social_metadata": {},
                        "company": {
                          "company_name": "Walmart",
                          "company_url": "http://walmart.com",
                          "is_company_url_active": true,
                          "domain": "walmart.com",
                          "domain_id": 26067151,
                          "domain_ids": [
                            757023267,
                            368242703,
                            26067151
                          ],
                          "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6",
                          "founded_year": 1962,
                          "country": "United States",
                          "country_code": "US",
                          "location": "United States",
                          "phones": null,
                          "emails": [],
                          "contacts": [],
                          "wantedly_name": null,
                          "rocketpunch_name": null,
                          "tiktok_name": null,
                          "company_size_printed": "466,000",
                          "company_size": 466000,
                          "industry": "Retail",
                          "specialties": [
                            "Retail",
                            "E-commerce"
                          ],
                          "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg",
                          "linkedin_url": "http://www.linkedin.com/company/walmart",
                          "facebook_url": "http://facebook.com/walmart",
                          "twitter_url": "https://twitter.com/walmart",
                          "crunchbase_url": null,
                          "instagram_url": "http://instagram.com/walmart",
                          "youtube_url": "http://youtube.com/user/walmart",
                          "x_url": null,
                          "github_url": null,
                          "tiktok_url": null,
                          "wantedly_url": null,
                          "rocketpunch_url": null,
                          "social_metadata": {}
                        }
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "people_search_id": {
                    "type": "string",
                    "description": "Pubrio person id to use as the reference."
                  },
                  "linkedin_url": {
                    "type": "string",
                    "description": "A single LinkedIn profile URL to use as the reference."
                  },
                  "search_term": {
                    "$ref": "#/components/schemas/search_term"
                  },
                  "people_name": {
                    "$ref": "#/components/schemas/people_name"
                  },
                  "people_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "peoples": {
                    "$ref": "#/components/schemas/peoples"
                  },
                  "management_levels": {
                    "$ref": "#/components/schemas/management_levels"
                  },
                  "departments": {
                    "$ref": "#/components/schemas/departments"
                  },
                  "department_functions": {
                    "$ref": "#/components/schemas/functions"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "people_locations": {
                    "$ref": "#/components/schemas/people_locations"
                  },
                  "company_locations": {
                    "$ref": "#/components/schemas/company_locations"
                  },
                  "company_linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/people_linkedin_urls"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/people_filter_conditions"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/is_enable_similarity_search"
                  },
                  "similarity_score": {
                    "$ref": "#/components/schemas/similarity_score"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "company_filters": {
                    "$ref": "#/components/schemas/company_filters"
                  }
                },
                "anyOf": [
                  {
                    "title": "peoples",
                    "required": [
                      "peoples"
                    ]
                  },
                  {
                    "title": "people_search_id",
                    "required": [
                      "people_search_id"
                    ]
                  },
                  {
                    "title": "people_titles",
                    "required": [
                      "people_titles"
                    ]
                  },
                  {
                    "title": "linkedin_url",
                    "required": [
                      "linkedin_url"
                    ]
                  },
                  {
                    "title": "linkedin_urls",
                    "required": [
                      "linkedin_urls"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "people_search_similar",
        "summary": "Search for similar people",
        "description": "Find people similar to a reference person or title. Supply one reference (`people_search_id`, `linkedin_url`, `linkedin_urls`, `peoples` or `people_titles`). Each person carries a `similarity_score` between 0 and 1. The reference only sets what similar means; every other filter narrows the results.",
        "tags": [
          "Lookalike"
        ]
      }
    },
    "/companies/search": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context: `recent_search_log_identifier`, echoed `parameters` and `filters`, an optional `profile` credit block, and `ignored_fields` (body keys the endpoint dropped)."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 45234700,
                      "total_pages": 1809388
                    },
                    "companies": [
                      {
                        "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg",
                        "company_name": "Twitter",
                        "emails": [
                          "..."
                        ],
                        "phones": [
                          "..."
                        ],
                        "contacts": [
                          "..."
                        ],
                        "founded_year": 2006,
                        "specialties": [
                          "Software Development"
                        ],
                        "industry": "Software Development",
                        "domain": "twitter.com",
                        "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a",
                        "domain_id": 224475931,
                        "linkedin_company_id": 44005587,
                        "linkedin_name": "twitter",
                        "is_company_url_active": true,
                        "domain_ids": [
                          224475931,
                          1758889566,
                          368242865
                        ],
                        "company_keywords": [
                          "realtime information",
                          "social commerce",
                          "online shopping",
                          "classifieds",
                          "craigslist killers",
                          "e-commerce",
                          "killers",
                          "consumer internet",
                          "internet",
                          "information technology",
                          "edp services",
                          "technology",
                          "software development",
                          "microblogging",
                          "social networking",
                          "public conversation",
                          "user engagement",
                          "content sharing",
                          "advertising solutions",
                          "monetization",
                          "community building",
                          "digital wallet",
                          "ai integration",
                          "user safety"
                        ],
                        "company_size": 1500,
                        "youtube_url": null,
                        "crunchbase_url": null,
                        "linkedin_url": "http://www.linkedin.com/company/twitter",
                        "instagram_url": null,
                        "facebook_url": "http://facebook.com/twitterinc",
                        "twitter_url": "https://twitter.com/x",
                        "github_url": null,
                        "x_url": null,
                        "location": "United States",
                        "company_ranking": null,
                        "company_url": "http://twitter.com",
                        "saved_lists": null,
                        "company_size_printed": "1,500"
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "company_name": {
                    "$ref": "#/components/schemas/company_name"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "company_groups": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Restrict to members of these company groups (ids), such as a monitor's `source_group_id` or `excluded_group_id`; paginated like any search."
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "company_filters": {
                    "$ref": "#/components/schemas/company_filters"
                  },
                  "locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "exclude_locations": {
                    "$ref": "#/components/schemas/exclude_locations"
                  },
                  "places": {
                    "$ref": "#/components/schemas/places"
                  },
                  "exclude_places": {
                    "$ref": "#/components/schemas/exclude_places"
                  },
                  "job_locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "job_exclude_locations": {
                    "$ref": "#/components/schemas/job_exclude_locations"
                  },
                  "job_posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "job_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "categories": {
                    "$ref": "#/components/schemas/categories"
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "exclude_technologies": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "Shopify"
                    ],
                    "description": "Technologies the company must not use, as `tag_id`s or, with `is_enable_similarity_search`, names such as `[\"Shopify\"]`. A company with no known technologies is kept."
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "keywords": {
                    "$ref": "#/components/schemas/keywords"
                  },
                  "social_media": {
                    "$ref": "#/components/schemas/company_social_media"
                  },
                  "news_categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "advertisement_search_terms": {
                    "$ref": "#/components/schemas/advertisement_search_terms"
                  },
                  "advertisement_target_locations": {
                    "$ref": "#/components/schemas/advertisement_target_locations"
                  },
                  "advertisement_exclude_target_locations": {
                    "$ref": "#/components/schemas/advertisement_exclude_target_locations"
                  },
                  "advertisement_start_dates": {
                    "$ref": "#/components/schemas/advertisement_start_dates"
                  },
                  "advertisement_end_dates": {
                    "$ref": "#/components/schemas/advertisement_end_dates"
                  },
                  "advertisement_active_dates": {
                    "$ref": "#/components/schemas/advertisement_active_dates"
                  },
                  "advertisement_status": {
                    "$ref": "#/components/schemas/advertisement_status"
                  },
                  "advertisement_headlines": {
                    "$ref": "#/components/schemas/advertisement_headlines"
                  },
                  "advertisement_platforms": {
                    "$ref": "#/components/schemas/advertisement_platforms"
                  },
                  "advertisement_publisher_platforms": {
                    "$ref": "#/components/schemas/advertisement_publisher_platforms"
                  },
                  "advertisement_exclude_publisher_platforms": {
                    "$ref": "#/components/schemas/advertisement_exclude_publisher_platforms"
                  },
                  "advertisement_formats": {
                    "$ref": "#/components/schemas/advertisement_formats"
                  },
                  "advertisement_active_ads": {
                    "$ref": "#/components/schemas/advertisement_active_ads"
                  },
                  "advertisement_running_ads": {
                    "$ref": "#/components/schemas/advertisement_running_ads"
                  },
                  "advertisement_total_ads": {
                    "$ref": "#/components/schemas/advertisement_total_ads"
                  },
                  "advertisement_platform_count": {
                    "$ref": "#/components/schemas/advertisement_platform_count"
                  },
                  "advertisement_format_count": {
                    "$ref": "#/components/schemas/advertisement_format_count"
                  },
                  "advertisement_impressions_estimate": {
                    "$ref": "#/components/schemas/advertisement_impressions_estimate"
                  },
                  "advertisement_country_activity": {
                    "$ref": "#/components/schemas/advertisement_country_activity"
                  },
                  "sort_by": {
                    "$ref": "#/components/schemas/company_sort_by"
                  },
                  "is_ascending_order": {
                    "type": "boolean",
                    "example": true,
                    "description": "Direction for `sort_by`. Defaults to ascending, which for `advertisement_country_rank` means the biggest advertisers first."
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/company_filter_conditions"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/is_enable_similarity_search"
                  },
                  "similarity_score": {
                    "$ref": "#/components/schemas/similarity_score"
                  },
                  "query": {
                    "type": "string",
                    "example": "Food & Beverage companies in Singapore that recently expanded",
                    "description": "Natural-language search. When provided, Pubrio interprets it into the company filters below: industry (and industries to leave out), specialty, technology (and tools to leave out), social profiles, HQ country, region or city, head-count, revenue, founded year, roles being hired and where, news events such as \"recently expanded\", advertising (platform, format, target country, ad counts, impressions, dates, rank in one country) and cloud hosting (provider, server countries and cities, host and server counts, overall or in one country). Values joined by \"or\" match any of them; tools or profiles joined by \"and\" (\"uses both Salesforce and HubSpot\") must all match. Any explicit filters you also pass take precedence over the interpreted ones. A part of the sentence no filter can express (for example ownership) comes back in `metadata.unmatched_criteria` rather than being dropped; a sentence with nothing searchable returns no results with `metadata.nl_no_intent: true`."
                  },
                  "exclude_fields": {
                    "$ref": "#/components/schemas/exclude_fields"
                  },
                  "is_parameter_metadata_available": {
                    "$ref": "#/components/schemas/is_parameter_metadata_available"
                  },
                  "is_profile_metadata_available": {
                    "$ref": "#/components/schemas/is_profile_metadata_available"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "cloud_footprint_providers": {
                    "$ref": "#/components/schemas/cloud_footprint_providers"
                  },
                  "cloud_footprint_exclude_providers": {
                    "$ref": "#/components/schemas/exclude_providers"
                  },
                  "cloud_footprint_target_locations": {
                    "$ref": "#/components/schemas/cloud_footprint_target_locations"
                  },
                  "cloud_footprint_exclude_target_locations": {
                    "$ref": "#/components/schemas/cloud_footprint_exclude_target_locations"
                  },
                  "cloud_footprint_cloud_regions": {
                    "$ref": "#/components/schemas/cloud_regions"
                  },
                  "cloud_footprint_exclude_cloud_regions": {
                    "$ref": "#/components/schemas/exclude_cloud_regions"
                  },
                  "cloud_footprint_cities": {
                    "$ref": "#/components/schemas/cities"
                  },
                  "cloud_footprint_exclude_cities": {
                    "$ref": "#/components/schemas/exclude_cities"
                  },
                  "cloud_footprint_first_seen_dates": {
                    "$ref": "#/components/schemas/first_seen_dates"
                  },
                  "cloud_footprint_last_seen_dates": {
                    "$ref": "#/components/schemas/last_seen_dates"
                  },
                  "cloud_footprint_is_cross_border_only": {
                    "$ref": "#/components/schemas/is_cross_border_only"
                  },
                  "cloud_footprint_host_count": {
                    "$ref": "#/components/schemas/cloud_footprint_host_count"
                  },
                  "cloud_footprint_server_count": {
                    "$ref": "#/components/schemas/cloud_footprint_server_count"
                  },
                  "cloud_footprint_shared_server_count": {
                    "$ref": "#/components/schemas/cloud_footprint_shared_server_count"
                  },
                  "cloud_footprint_provider_count": {
                    "$ref": "#/components/schemas/cloud_footprint_provider_count"
                  },
                  "cloud_footprint_country_count": {
                    "$ref": "#/components/schemas/cloud_footprint_country_count"
                  },
                  "cloud_footprint_cross_border_country_count": {
                    "$ref": "#/components/schemas/cloud_footprint_cross_border_country_count"
                  },
                  "cloud_footprint_region_count": {
                    "$ref": "#/components/schemas/cloud_footprint_region_count"
                  },
                  "cloud_footprint_city_count": {
                    "$ref": "#/components/schemas/cloud_footprint_city_count"
                  },
                  "cloud_footprint_primary_provider": {
                    "$ref": "#/components/schemas/cloud_footprint_primary_provider"
                  },
                  "cloud_footprint_country_activity": {
                    "$ref": "#/components/schemas/cloud_footprint_country_activity"
                  }
                }
              }
            }
          }
        },
        "operationId": "companies_search",
        "summary": "Search for companies",
        "description": "Search the Pubrio database for companies matching specified criteria such as industry, size, location, and technologies.",
        "tags": [
          "Search"
        ]
      }
    },
    "/companies/search/similar": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context. Carries the echoed `filters` and `parameters`, and a `profile` block with `credit`, `topup_credit` and `total_credit_cost` — the only per-call credit accounting the API returns."
                    },
                    "data": {
                      "type": "array",
                      "description": "The similar companies, each with a `similarity_score`. This endpoint returns a bare array — unlike the other search endpoints, there is no `pagination` wrapper inside `data`. Page with `page` and `per_page`.",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg",
                      "company_name": "Twitter",
                      "emails": [
                        "..."
                      ],
                      "phones": [
                        "..."
                      ],
                      "contacts": [
                        "..."
                      ],
                      "founded_year": 2006,
                      "specialties": [
                        "Software Development"
                      ],
                      "industry": "Software Development",
                      "domain": "twitter.com",
                      "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a",
                      "domain_id": 224475931,
                      "linkedin_company_id": 44005587,
                      "linkedin_name": "twitter",
                      "is_company_url_active": true,
                      "domain_ids": [
                        224475931,
                        1758889566,
                        368242865
                      ],
                      "company_keywords": [
                        "realtime information",
                        "social commerce",
                        "online shopping",
                        "classifieds",
                        "craigslist killers",
                        "e-commerce",
                        "killers",
                        "consumer internet",
                        "internet",
                        "information technology",
                        "edp services",
                        "technology",
                        "software development",
                        "microblogging",
                        "social networking",
                        "public conversation",
                        "user engagement",
                        "content sharing",
                        "advertising solutions",
                        "monetization",
                        "community building",
                        "digital wallet",
                        "ai integration",
                        "user safety"
                      ],
                      "company_size": 1500,
                      "youtube_url": null,
                      "crunchbase_url": null,
                      "linkedin_url": "http://www.linkedin.com/company/twitter",
                      "instagram_url": null,
                      "facebook_url": "http://facebook.com/twitterinc",
                      "twitter_url": "https://twitter.com/x",
                      "github_url": null,
                      "x_url": null,
                      "location": "United States",
                      "company_ranking": null,
                      "company_url": "http://twitter.com",
                      "saved_lists": null,
                      "company_size_printed": "1,500",
                      "similarity_score": 0.87
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain_search_id": {
                    "type": "string",
                    "description": "Pubrio company identifier."
                  },
                  "domain": {
                    "type": "string",
                    "description": "The company's primary domain, for example `stripe.com`.",
                    "example": "stripe.com"
                  },
                  "linkedin_url": {
                    "type": "string",
                    "description": "LinkedIn company URL."
                  },
                  "tiktok_url": {
                    "type": "string",
                    "description": "TikTok profile URL for the company."
                  },
                  "wantedly_url": {
                    "type": "string",
                    "description": "Wantedly profile URL for the company."
                  },
                  "tw104_url": {
                    "type": "string",
                    "description": "104 (Taiwan) profile URL for the company."
                  },
                  "rocketpunch_url": {
                    "type": "string",
                    "description": "RocketPunch profile URL for the company."
                  },
                  "remember_url": {
                    "type": "string",
                    "description": "Remember profile URL for the company."
                  },
                  "youtrust_url": {
                    "type": "string",
                    "description": "YOUTRUST profile URL for the company."
                  },
                  "company_name": {
                    "$ref": "#/components/schemas/company_name"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "exclude_locations": {
                    "$ref": "#/components/schemas/exclude_locations"
                  },
                  "places": {
                    "$ref": "#/components/schemas/places"
                  },
                  "exclude_places": {
                    "$ref": "#/components/schemas/exclude_places"
                  },
                  "job_locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "job_exclude_locations": {
                    "$ref": "#/components/schemas/job_exclude_locations"
                  },
                  "job_posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "job_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "categories": {
                    "$ref": "#/components/schemas/categories"
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "keywords": {
                    "$ref": "#/components/schemas/keywords"
                  },
                  "news_categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "advertisement_search_terms": {
                    "$ref": "#/components/schemas/advertisement_search_terms"
                  },
                  "advertisement_target_locations": {
                    "$ref": "#/components/schemas/advertisement_target_locations"
                  },
                  "advertisement_exclude_target_locations": {
                    "$ref": "#/components/schemas/advertisement_exclude_target_locations"
                  },
                  "advertisement_start_dates": {
                    "$ref": "#/components/schemas/advertisement_start_dates"
                  },
                  "advertisement_end_dates": {
                    "$ref": "#/components/schemas/advertisement_end_dates"
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/company_filter_conditions"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/is_enable_similarity_search"
                  },
                  "similarity_score": {
                    "$ref": "#/components/schemas/similarity_score"
                  },
                  "exclude_fields": {
                    "$ref": "#/components/schemas/exclude_fields"
                  },
                  "is_parameter_metadata_available": {
                    "$ref": "#/components/schemas/is_parameter_metadata_available"
                  },
                  "is_profile_metadata_available": {
                    "$ref": "#/components/schemas/is_profile_metadata_available"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "company_filters": {
                    "$ref": "#/components/schemas/company_filters"
                  }
                },
                "anyOf": [
                  {
                    "title": "domain_search_id",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "linkedin_url",
                    "required": [
                      "linkedin_url"
                    ]
                  },
                  {
                    "title": "tiktok_url",
                    "required": [
                      "tiktok_url"
                    ]
                  },
                  {
                    "title": "wantedly_url",
                    "required": [
                      "wantedly_url"
                    ]
                  },
                  {
                    "title": "tw104_url",
                    "required": [
                      "tw104_url"
                    ]
                  },
                  {
                    "title": "rocketpunch_url",
                    "required": [
                      "rocketpunch_url"
                    ]
                  },
                  {
                    "title": "remember_url",
                    "required": [
                      "remember_url"
                    ]
                  },
                  {
                    "title": "youtrust_url",
                    "required": [
                      "youtrust_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "companies_search_similar",
        "summary": "Search for similar companies",
        "description": "Find companies similar to a reference company. Supply exactly one singular identifier (`domain_search_id`, `domain`, `linkedin_url` or another `*_url`). Each row carries a `similarity_score` between 0 and 1.",
        "tags": [
          "Lookalike"
        ]
      }
    },
    "/companies/lookalikes/search": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context. Carries the echoed `filters` and `parameters`, and a `profile` block with `credit`, `topup_credit` and `total_credit_cost` — the only per-call credit accounting the API returns."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 45234700,
                      "total_pages": 1809388
                    },
                    "lookalikes": [
                      {
                        "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg",
                        "company_name": "Twitter",
                        "emails": [
                          "..."
                        ],
                        "phones": [
                          "..."
                        ],
                        "contacts": [
                          "..."
                        ],
                        "founded_year": 2006,
                        "specialties": [
                          "Software Development"
                        ],
                        "industry": "Software Development",
                        "domain": "twitter.com",
                        "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a",
                        "domain_id": 224475931,
                        "linkedin_company_id": 44005587,
                        "linkedin_name": "twitter",
                        "is_company_url_active": true,
                        "domain_ids": [
                          224475931,
                          1758889566,
                          368242865
                        ],
                        "company_keywords": [
                          "realtime information",
                          "social commerce",
                          "online shopping",
                          "classifieds",
                          "craigslist killers",
                          "e-commerce",
                          "killers",
                          "consumer internet",
                          "internet",
                          "information technology",
                          "edp services",
                          "technology",
                          "software development",
                          "microblogging",
                          "social networking",
                          "public conversation",
                          "user engagement",
                          "content sharing",
                          "advertising solutions",
                          "monetization",
                          "community building",
                          "digital wallet",
                          "ai integration",
                          "user safety"
                        ],
                        "company_size": 1500,
                        "youtube_url": null,
                        "crunchbase_url": null,
                        "linkedin_url": "http://www.linkedin.com/company/twitter",
                        "instagram_url": null,
                        "facebook_url": "http://facebook.com/twitterinc",
                        "twitter_url": "https://twitter.com/x",
                        "github_url": null,
                        "x_url": null,
                        "location": "United States",
                        "company_ranking": null,
                        "company_url": "http://twitter.com",
                        "saved_lists": null,
                        "company_size_printed": "1,500"
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "exclude_locations": {
                    "$ref": "#/components/schemas/exclude_locations"
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "categories": {
                    "$ref": "#/components/schemas/categories"
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "job_locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "job_posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "job_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "news_categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/is_enable_similarity_search"
                  },
                  "similarity_score": {
                    "$ref": "#/components/schemas/similarity_score"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "companies_search_lookalikes",
        "summary": "Search for lookalike companies",
        "description": "**Deprecated.** Use `POST /companies/search/similar` instead. The request body is the same; results are returned in `data.lookalikes` with a `data.pagination` object.\n\nFind companies similar to a specified target company based on firmographic and technographic attributes.",
        "tags": [
          "Lookalike"
        ],
        "deprecated": true
      }
    },
    "/companies/jobs/search": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company job search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "$ref": "#/components/schemas/search_metadata"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "pagination": {
                          "$ref": "#/components/schemas/search_pagination"
                        },
                        "jobs": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/job_search_result"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "profile": null,
                    "filters": {
                      "domains": [
                        "google.com"
                      ],
                      "per_page": 25,
                      "language": "en"
                    },
                    "ignored_fields": []
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 2228628,
                      "total_pages": 89146,
                      "is_timeout": false,
                      "total_display_pages": 250
                    },
                    "jobs": [
                      {
                        "job_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
                        "job_search_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
                        "last_modified": "2025-05-31T20:41:27.894Z",
                        "companies": {
                          "logo_url": "https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "539e2c34-de6b-4613-8f5b-e3aa18b4ef47",
                          "company_name": "Google",
                          "linkedin_name": "google",
                          "country_code": "US",
                          "domain": "google.com"
                        },
                        "location": "Seoul, Seoul, South Korea",
                        "job_url": "https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D",
                        "posting_date": "2025-05-31",
                        "country_code": "KR",
                        "location_id": 491,
                        "title": "Software Engineer, gReach Program for People with Disabilities (장애인 채용)",
                        "country": "South Korea",
                        "created_at": "2025-05-10T14:30:58.348Z",
                        "source_type": "linkedin",
                        "functions": null,
                        "seniority_rank": 0,
                        "base_salary": null,
                        "experience_requirement": null,
                        "education_requirement": null,
                        "employment_type": null
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "exclude_locations": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "TW"
                    ],
                    "description": "ISO 3166-1 alpha-2 (cca2) location codes to exclude from job results. Check out the `location` endpoints under the Filters tab for valid codes."
                  },
                  "location_ids": {
                    "$ref": "#/components/schemas/job_location_ids"
                  },
                  "company_locations": {
                    "$ref": "#/components/schemas/company_locations"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "search_term": {
                    "$ref": "#/components/schemas/search_term"
                  },
                  "search_terms": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "Software Developer"
                    ],
                    "description": "Array of keyword strings to filter job postings. Each term is matched against job content. Use `search_term` for a single string or `search_terms` for multiple keywords."
                  },
                  "titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "functions": {
                    "$ref": "#/components/schemas/job_functions"
                  },
                  "departments": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "master_sales"
                    ],
                    "description": "Department slugs or names, e.g. `master_sales` or `Sales` (any case), from [Departments](/en/api-reference/endpoint/departments/departments). Matches jobs whose title carries any of them; a value the catalog does not name matches nothing."
                  },
                  "exclude_departments": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "c_suite"
                    ],
                    "description": "Department slugs or names to leave out. A job with no department is kept."
                  },
                  "seniority_ranks": {
                    "$ref": "#/components/schemas/job_seniority_ranks"
                  },
                  "posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "launch_dates": {
                    "$ref": "#/components/schemas/job_launch_dates"
                  },
                  "created_at": {
                    "$ref": "#/components/schemas/search_created_at"
                  },
                  "is_realtime_enrichment": {
                    "$ref": "#/components/schemas/is_realtime_enrichment"
                  },
                  "is_ascending_order": {
                    "$ref": "#/components/schemas/is_ascending_order"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  }
                }
              }
            }
          }
        },
        "operationId": "companies_search_jobs",
        "summary": "Search for job postings",
        "description": "Search job postings. See the [Job Search guide](/en/developer-guides/search/job-search).",
        "tags": [
          "Search"
        ]
      }
    },
    "/companies/news/search": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company news search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "$ref": "#/components/schemas/search_metadata"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "pagination": {
                          "$ref": "#/components/schemas/search_pagination"
                        },
                        "news": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/news_search_result"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "profile": null,
                    "filters": {
                      "domains": [
                        "stripe.com"
                      ],
                      "per_page": 25,
                      "language": "en"
                    },
                    "ignored_fields": []
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 351800,
                      "total_pages": 14072,
                      "is_timeout": false,
                      "total_display_pages": 250
                    },
                    "news": [
                      {
                        "news_id": "0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd",
                        "news_search_id": "4110b929-17cd-42aa-a159-906ead0c9b56",
                        "country_codes": [
                          "CN",
                          "SG"
                        ],
                        "company_country_codes": [
                          "CN",
                          "FR"
                        ],
                        "domains": [
                          "insead.edu",
                          "digitalchina.com"
                        ],
                        "companies": [
                          {
                            "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg",
                            "domain_search_id": "dfbe6797-5311-46f9-9518-bf1a7c3d09bc",
                            "country_code": "FR",
                            "company_name": "Insead",
                            "linkedin_name": "insead",
                            "domain": "insead.edu"
                          },
                          {
                            "logo_url": "https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                            "domain_search_id": "e13a9e24-a07d-4630-9b47-fceb778df74e",
                            "country_code": "CN",
                            "company_name": "Digital China",
                            "linkedin_name": "digital-china",
                            "domain": "digitalchina.com"
                          }
                        ],
                        "news_galleries": [
                          {
                            "slug": "banking-financial-service",
                            "news_gallery_id": "7c8ec9cc-66c5-4153-82da-9c8f356c6c99",
                            "name": "Banking/Financial Service"
                          }
                        ],
                        "locations": [
                          "Singapore",
                          "China"
                        ],
                        "last_modified": "2025-06-01T08:15:23.945Z",
                        "image_url": null,
                        "url": "http://enold.prnasia.com/p/asia-story-125304015-0.shtml",
                        "published_at": "2025-06-01T08:00:00.000Z",
                        "language": "id",
                        "source": "prnasia.com",
                        "category": "launches",
                        "title": "Digital China's AI-driven transformation showcased at INSEAD",
                        "summary": "Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey.",
                        "news_category_name": "Launches"
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "locations": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/locations"
                      }
                    ],
                    "description": "Countries the story itself is about, read from the article text (ISO 3166-1 alpha-2). Empty when the article names no place. For where a mentioned company is headquartered, use `company_locations`."
                  },
                  "company_locations": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/company_locations"
                      }
                    ],
                    "description": "Headquarters country of the companies the article mentions (ISO 3166-1 alpha-2) — not where the story happened; for that, use `locations`."
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "news_search_id": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/news_search_id"
                      }
                    ],
                    "description": "Return only this one record. Handy for re-fetching a row you stored earlier without paging."
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "company_names": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "Volvo Cars",
                      "Renault"
                    ],
                    "description": "Company names to search by, as an alternative to `domains`. Each name is matched to the company website its news is filed under (for example `Stellantis` → `stellantis.com`), and the result is combined with any `domains`, `companies` or `linkedin_urls` you send. A name that matches no company returns no articles. Send the business you mean: `Volvo Cars` and `Volvo` (Volvo Group) are different companies."
                  },
                  "company_roles": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "primary",
                        "mentioned"
                      ]
                    },
                    "example": [
                      "primary"
                    ],
                    "description": "What the searched companies must be in the article. `primary`: the article is about the company (it carries out or undergoes the main event, or is a main party to it). `mentioned`: the company is only named in passing (a customer, competitor or example). Leave it out to get both. Applies to the companies given by `domains`, `companies`, `linkedin_urls` or `company_names`."
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "search_term": {
                    "$ref": "#/components/schemas/search_term"
                  },
                  "search_terms": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "Trump"
                    ],
                    "description": "Array of keyword strings to filter news articles. Each term is matched against article content. Use `search_term` for a single string or `search_terms` for multiple keywords."
                  },
                  "exclude_search_terms": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "layoffs"
                    ],
                    "description": "Leave out articles that mention any of these words, matched the same way as `search_terms`. `exclude_keywords` is accepted as another name."
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "bbc.co.uk"
                    ],
                    "description": "Only articles from these publishers. Use the publisher's domain, e.g. `bbc.co.uk` — the same value as the `source` field on every article. A full URL or a `www.` address also works."
                  },
                  "exclude_sources": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "prnasia.com"
                    ],
                    "description": "Leave out articles from these publishers. Same format as `sources`. Articles with no recorded publisher are kept."
                  },
                  "categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_gallery_ids": {
                    "$ref": "#/components/schemas/news_gallery_ids"
                  },
                  "published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "published_at": {
                    "$ref": "#/components/schemas/news_published_at_from"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "is_ascending_order": {
                    "$ref": "#/components/schemas/is_ascending_order"
                  },
                  "news_galleries": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "electronic-commerce"
                    ],
                    "description": "List of `gallery slugs` for filtering news by gallery. To find a slug, call the `news galleries` endpoint under the Filters tab."
                  },
                  "news_languages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "zh"
                    ],
                    "description": "Keeps only articles originally written in these languages (ISO 639-1 codes or `locale_code` values from the `news languages` endpoint under the Filters tab). A regional code also matches its base language and a base language matches every regional one (`zh` matches `zh-CN` and `zh-HK`). This filters articles out; to choose the language you read them in, use `language`."
                  },
                  "is_expansion_signal_available": {
                    "$ref": "#/components/schemas/is_expansion_signal_available"
                  },
                  "expansion_signal_types": {
                    "$ref": "#/components/schemas/expansion_signal_types"
                  },
                  "expansion_signal_polarities": {
                    "$ref": "#/components/schemas/expansion_signal_polarities"
                  },
                  "news_search_term_languages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "en"
                    ],
                    "description": "Which translations `search_term`, `search_terms` and `exclude_search_terms` are matched against. By default every translation is searched, so an English keyword also finds an article first written in Japanese. Accepts the same codes as `news_languages`."
                  },
                  "language": {
                    "type": "string",
                    "example": "en",
                    "description": "The language titles, summaries and category names come back in: `en`, `zh-CN`, `zh-HK`, `ja`, `ko`, `hi`, `es` or `pt-BR`. Every article is translated into all of them, so this changes only what you read, not which articles are returned. Defaults to your workspace language. To keep only articles originally written in a language, use `news_languages`."
                  },
                  "query": {
                    "type": "string",
                    "example": "Volvo Cars news about electric vehicles in the last 6 months",
                    "description": "A plain-English request. It is turned into filters (`company_names`, `company_roles`, `categories`, `search_terms`, `locations`, `published_dates`, …), which are combined with any filters you send and returned in `metadata.filters` so you can check them."
                  }
                }
              }
            }
          }
        },
        "operationId": "companies_search_news",
        "summary": "Search for company news",
        "description": "Search news about companies. See the [News Search guide](/en/developer-guides/search/news-search).",
        "tags": [
          "Search"
        ]
      }
    },
    "/companies/advertisements/search": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company advertisement search details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "$ref": "#/components/schemas/advertisement_search_metadata"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "pagination": {
                          "$ref": "#/components/schemas/search_pagination"
                        },
                        "advertisements": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/advertisement_search_result"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "profile": null,
                    "filters": {
                      "source_types": [
                        "linkedin"
                      ],
                      "per_page": 25,
                      "language": "en"
                    },
                    "ignored_fields": [],
                    "applied_source_types": [
                      "linkedin"
                    ]
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 694356,
                      "total_pages": 27775,
                      "total_display_pages": 250,
                      "is_timeout": false
                    },
                    "advertisements": [
                      {
                        "target_country_codes": [
                          "US",
                          "GB",
                          "SG"
                        ],
                        "advertisement_id": "3af8cb80-9a04-49a8-832d-333961d5f77a",
                        "advertisement_search_id": "3af8cb80-9a04-49a8-832d-333961d5f77a",
                        "created_at": "2026-03-03T01:46:35.909Z",
                        "last_modified": "2026-03-03T12:46:25.289Z",
                        "started_at": "2026-02-25T00:00:00.000Z",
                        "ended_at": "2026-03-02T00:00:00.000Z",
                        "title": "Thuraya-4 Satellite Solutions for Energy",
                        "source_type": "linkedin",
                        "advertisement_format": "Single Image Ad",
                        "video_url": null,
                        "image_url": "https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg",
                        "carousel_images": null,
                        "destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content",
                        "companies": {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg",
                          "domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a",
                          "company_name": "Space42",
                          "linkedin_name": "space42ai",
                          "country_code": "AE",
                          "domain": "space42.ai"
                        },
                        "raw_link_url": null,
                        "publisher_platforms": null,
                        "advertisement_format_normalized": "image",
                        "is_company_matched": true,
                        "advertiser": "Thuraya",
                        "advertiser_url": "https://www.linkedin.com/company/thuraya",
                        "advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
                        "total_impressions": "< 1k",
                        "total_impressions_lower": null,
                        "total_impressions_upper": 1000
                      },
                      {
                        "target_country_codes": [
                          "US",
                          "GB",
                          "SG"
                        ],
                        "advertisement_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022",
                        "advertisement_search_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022",
                        "created_at": "2026-06-03T22:00:33.035Z",
                        "last_modified": "2026-06-05T18:15:51.823Z",
                        "started_at": "2026-05-25T07:00:00.000Z",
                        "ended_at": "2026-06-03T07:00:00.000Z",
                        "title": "Dubai Opportunities. One Exclusive Event",
                        "source_type": "facebook",
                        "advertisement_format": "DCO",
                        "video_url": null,
                        "image_url": "https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg",
                        "carousel_images": null,
                        "destination_url": "https://promotions.damacproperties.com/en/event-in-egypt-social-specific/",
                        "raw_link_url": "http://fb.me/",
                        "publisher_platforms": [
                          "facebook",
                          "instagram"
                        ],
                        "companies": {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                          "domain_search_id": "9da7386c-5bdc-42b2-8fee-456e91024a3a",
                          "company_name": "Damac Properties",
                          "linkedin_name": "damac-properties",
                          "country_code": "AE",
                          "domain": "damacproperties.com"
                        },
                        "advertisement_format_normalized": "image",
                        "is_company_matched": true,
                        "advertiser": "Thuraya",
                        "advertiser_url": "https://www.linkedin.com/company/thuraya",
                        "advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
                        "total_impressions": "< 1k",
                        "total_impressions_lower": null,
                        "total_impressions_upper": 1000
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target_locations": {
                    "$ref": "#/components/schemas/target_locations"
                  },
                  "exclude_target_locations": {
                    "$ref": "#/components/schemas/exclude_target_locations"
                  },
                  "search_terms": {
                    "$ref": "#/components/schemas/search_terms"
                  },
                  "headlines": {
                    "$ref": "#/components/schemas/headlines"
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/ads_filter_conditions"
                  },
                  "start_dates": {
                    "$ref": "#/components/schemas/start_dates"
                  },
                  "end_dates": {
                    "$ref": "#/components/schemas/end_dates"
                  },
                  "active_dates": {
                    "$ref": "#/components/schemas/advertisement_active_dates_search"
                  },
                  "created_at": {
                    "$ref": "#/components/schemas/search_created_at"
                  },
                  "company_locations": {
                    "$ref": "#/components/schemas/company_locations"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "advertisement_search_id": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/advertisement_search_id"
                      }
                    ],
                    "description": "Return only this one record. Handy for re-fetching a row you stored earlier without paging."
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "is_realtime_enrichment": {
                    "$ref": "#/components/schemas/is_realtime_enrichment"
                  },
                  "advertisement_formats": {
                    "$ref": "#/components/schemas/advertisement_formats"
                  },
                  "reach_tiers": {
                    "$ref": "#/components/schemas/advertisement_reach_tiers"
                  },
                  "advertisement_active_ads": {
                    "$ref": "#/components/schemas/advertisement_active_ads"
                  },
                  "advertisement_running_ads": {
                    "$ref": "#/components/schemas/advertisement_running_ads"
                  },
                  "advertisement_total_ads": {
                    "$ref": "#/components/schemas/advertisement_total_ads"
                  },
                  "advertisement_platform_count": {
                    "$ref": "#/components/schemas/advertisement_platform_count"
                  },
                  "advertisement_format_count": {
                    "$ref": "#/components/schemas/advertisement_format_count"
                  },
                  "advertisement_impressions_estimate": {
                    "$ref": "#/components/schemas/advertisement_impressions_estimate"
                  },
                  "advertisement_country_activity": {
                    "$ref": "#/components/schemas/advertisement_country_activity"
                  },
                  "source_types": {
                    "$ref": "#/components/schemas/advertisement_source_types"
                  },
                  "exclude_source_types": {
                    "$ref": "#/components/schemas/advertisement_exclude_source_types"
                  },
                  "enrichment_mode": {
                    "$ref": "#/components/schemas/advertisement_enrichment_mode"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "is_ascending_order": {
                    "$ref": "#/components/schemas/is_ascending_order"
                  },
                  "publisher_platforms": {
                    "$ref": "#/components/schemas/advertisement_publisher_platforms"
                  },
                  "exclude_publisher_platforms": {
                    "$ref": "#/components/schemas/advertisement_exclude_publisher_platforms"
                  },
                  "is_include_unlinked_companies": {
                    "$ref": "#/components/schemas/advertisement_is_include_unlinked_companies"
                  }
                }
              }
            }
          }
        },
        "operationId": "companies_search_advertisements",
        "summary": "Search for company advertisements",
        "description": "Search advertisements run by companies. See the [Advertisement Search guide](/en/developer-guides/search/advertisement-search).",
        "tags": [
          "Search"
        ]
      }
    },
    "/redeem/people/batch/query": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing bulk redeem people details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/data"
                        }
                      ],
                      "properties": {
                        "peoples": {
                          "type": "array",
                          "description": "The redeemed people. `emails` and `phones` are `null` — not `[]` — when nothing is found for that person, so guard before iterating. `total_credit_cost` reflects only successful matches and is `0` when nothing was redeemed; cost scales with how many contact types you request.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "profile": {
                      "credit": 450376,
                      "topup_credit": 235237,
                      "total_charged_credit": 465
                    },
                    "query": {
                      "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
                      "is_completed": true,
                      "estimated_time": 6,
                      "estimated_time_type": "second"
                    },
                    "peoples": [
                      {
                        "people_search_id": "540574d1-ff74-475b-aea2-f8ae643b806d",
                        "emails": [
                          {
                            "value": "example@gmail.com",
                            "type": "email-personal",
                            "status": null
                          },
                          {
                            "value": "example@pubrio.com",
                            "type": "email-work",
                            "status": "Verified"
                          }
                        ],
                        "phones": [
                          {
                            "value": "+1123456789",
                            "type": "phone",
                            "status": null
                          }
                        ]
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "redeem_query_id": {
                    "$ref": "#/components/schemas/redeem_query_id"
                  }
                },
                "required": [
                  "redeem_query_id"
                ]
              }
            }
          }
        },
        "operationId": "redeem_people_batch_query",
        "summary": "Query batch redeem status",
        "description": "Check the status and results of a previously submitted batch redeem request.",
        "tags": [
          "Redeem"
        ]
      }
    },
    "/redeem/people/batch": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing bulk redeem people status.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/data"
                        }
                      ],
                      "properties": {
                        "peoples": {
                          "type": "array",
                          "description": "The redeemed people. `emails` and `phones` are `null` — not `[]` — when nothing is found for that person, so guard before iterating. `total_credit_cost` reflects only successful matches and is `0` when nothing was redeemed; cost scales with how many contact types you request.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
                    "is_completed": false,
                    "estimated_time": 6,
                    "estimated_time_type": "second"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "peoples": {
                    "$ref": "#/components/schemas/peoples"
                  },
                  "people_contact_types": {
                    "$ref": "#/components/schemas/people_contact_types"
                  }
                },
                "required": [
                  "peoples",
                  "people_contact_types"
                ]
              }
            }
          }
        },
        "operationId": "redeem_people_batch",
        "summary": "Batch redeem people contact details",
        "description": "Submit a batch request to unlock contact details for multiple people at once.",
        "tags": [
          "Redeem"
        ]
      }
    },
    "/redeem/people": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing redeem people details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/data"
                        }
                      ],
                      "properties": {
                        "peoples": {
                          "type": "array",
                          "description": "The redeemed people. `emails` and `phones` are `null` — not `[]` — when nothing is found for that person, so guard before iterating. `total_credit_cost` reflects only successful matches and is `0` when nothing was redeemed; cost scales with how many contact types you request.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "profile": {
                      "credit": 450376,
                      "topup_credit": 235237,
                      "total_credit_cost": 45
                    },
                    "peoples": [
                      {
                        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
                        "emails": [
                          {
                            "value": "example@gmail.com",
                            "type": "email-personal",
                            "status": null
                          },
                          {
                            "value": "example@pubrio.com",
                            "type": "email-work",
                            "status": "Verified"
                          }
                        ],
                        "phones": [
                          {
                            "value": "+1123456789",
                            "type": "phone",
                            "status": null
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "people_search_id": {
                    "$ref": "#/components/schemas/people_search_id"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/people_linkedin_url"
                  },
                  "people_contact_types": {
                    "$ref": "#/components/schemas/people_contact_types"
                  }
                },
                "anyOf": [
                  {
                    "title": "People Search ID",
                    "required": [
                      "people_search_id",
                      "people_contact_types"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url",
                      "people_contact_types"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "redeem_people",
        "summary": "Redeem a person's contact details",
        "description": "Spend credits to unlock full contact details (email, phone) for a specific person.",
        "tags": [
          "Redeem"
        ]
      }
    },
    "/redeem/people/contact/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the matched person and match metadata.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/data"
                        }
                      ],
                      "properties": {
                        "peoples": {
                          "type": "array",
                          "description": "The redeemed people. `emails` and `phones` are `null` — not `[]` — when nothing is found for that person, so guard before iterating. `total_credit_cost` reflects only successful matches and is `0` when nothing was redeemed; cost scales with how many contact types you request.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "profile": {
                      "credit": 450375,
                      "topup_credit": 235236,
                      "total_credit_cost": 1
                    },
                    "peoples": [
                      {
                        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
                        "first_name": "King",
                        "last_name": "Lai",
                        "people_name": "King Lai",
                        "company_name": "Pubrio",
                        "domain": "pubrio.com",
                        "match": {
                          "confidence": "exact",
                          "input": {
                            "value": "king.lai@pubrio.com",
                            "type": "email-work"
                          },
                          "input_index": 0,
                          "is_duplicate_input": false
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "$ref": "#/components/schemas/contact_lookup_email"
                  },
                  "phone": {
                    "$ref": "#/components/schemas/contact_lookup_phone"
                  },
                  "first_name": {
                    "$ref": "#/components/schemas/contact_lookup_first_name"
                  },
                  "last_name": {
                    "$ref": "#/components/schemas/contact_lookup_last_name"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/contact_lookup_domain"
                  },
                  "company": {
                    "$ref": "#/components/schemas/contact_lookup_company"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/contact_lookup_is_enable_similarity_search"
                  }
                },
                "anyOf": [
                  {
                    "title": "Email",
                    "required": [
                      "email"
                    ]
                  },
                  {
                    "title": "Phone",
                    "required": [
                      "phone"
                    ]
                  },
                  {
                    "title": "Name + Domain",
                    "required": [
                      "first_name",
                      "last_name",
                      "domain"
                    ]
                  },
                  {
                    "title": "Name + Company",
                    "required": [
                      "first_name",
                      "last_name",
                      "company"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "redeem_people_contact_lookup",
        "summary": "Look up a person by contact identifier",
        "description": "Reverse-lookup a person by email, phone, or first and last name plus domain or company. Returns the matched person's `people_search_id` and base details, plus `match` metadata describing how the match was made. Charges 1 credit per billable match.",
        "tags": [
          "Redeem"
        ]
      }
    },
    "/redeem/people/contact/lookup/batch": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing matched people and per-record match metadata.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/data"
                        }
                      ],
                      "properties": {
                        "peoples": {
                          "type": "array",
                          "description": "The redeemed people. `emails` and `phones` are `null` — not `[]` — when nothing is found for that person, so guard before iterating. `total_credit_cost` reflects only successful matches and is `0` when nothing was redeemed; cost scales with how many contact types you request.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "profile": {
                      "credit": 450374,
                      "topup_credit": 235236,
                      "total_credit_cost": 2
                    },
                    "peoples": [
                      {
                        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
                        "people_name": "King Lai",
                        "company_name": "Pubrio",
                        "domain": "pubrio.com",
                        "match": {
                          "confidence": "exact",
                          "input": {
                            "value": "king.lai@pubrio.com",
                            "type": "email-work"
                          },
                          "input_index": 0,
                          "is_duplicate_input": false
                        }
                      },
                      {
                        "people_search_id": "1c4f0a9d-9a8e-4ab0-9b07-2cd09c4a3a6b",
                        "people_name": "John Smith",
                        "company_name": "Example",
                        "domain": "example.com",
                        "match": {
                          "confidence": "similarity_domain",
                          "input": {
                            "value": "example.com",
                            "type": "domain"
                          },
                          "input_index": 1,
                          "is_duplicate_input": false
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "peoples": {
                    "$ref": "#/components/schemas/contact_lookup_peoples"
                  },
                  "is_enable_similarity_search": {
                    "$ref": "#/components/schemas/contact_lookup_is_enable_similarity_search"
                  }
                },
                "required": [
                  "peoples"
                ]
              }
            }
          }
        },
        "operationId": "redeem_people_contact_lookup_batch",
        "summary": "Bulk-look up people by contact identifier",
        "description": "Batch version of `/redeem/people/contact/lookup`. Submit up to your subscription's bulk size limit in a single request. Each entry in `peoples` accepts the same identifiers as the single-lookup body. Charges 1 credit per billable match. Duplicate inputs (the same email, phone, or name + company sent again) and unmatched entries are not charged.",
        "tags": [
          "Redeem"
        ]
      }
    },
    "/locations": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing location details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "location_id": 472,
                      "flag": "🇦🇩",
                      "idd": {
                        "root": "+3",
                        "suffixes": [
                          "76"
                        ]
                      },
                      "dial_code": "+376",
                      "iso_code": "AD",
                      "location_name": "Andorra"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_locations",
        "summary": "List available locations",
        "description": "Retrieve the list of locations available for search filters.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/technologies": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing technology details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "icon": "Cart-generic.svg",
                      "name": "Cart Functionality",
                      "tag_id": 6630,
                      "website": "https://www.shopify.com/blog/shopping-cart",
                      "logo_url": "https://buckets.pubrio.com/technology-logo/NjYzMGIyOXNtYjhheGNhcnQtZnVuY3Rpb25hbGl0eQ==.jpg",
                      "categories": [
                        {
                          "name": "Ecommerce",
                          "category_id": 26
                        },
                        {
                          "name": "Programming languages",
                          "category_id": 707847256
                        }
                      ]
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "$ref": "#/components/schemas/keyword"
                  }
                }
              }
            }
          }
        },
        "operationId": "filters_list_technologies",
        "summary": "List available technologies",
        "description": "Retrieve the list of technologies available for search filters.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/technologies/categories": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing technology category details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "category_id": 2159464,
                      "slug": "remote-access",
                      "name": "Remote access"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "$ref": "#/components/schemas/keyword"
                  }
                }
              }
            }
          }
        },
        "operationId": "filters_list_technology_categories",
        "summary": "List technology categories",
        "description": "Retrieve the list of technology categories for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/verticals": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing vertical details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "vertical_id": 69276002,
                      "slug": "ai",
                      "vertical_identifier": "99b5d4d2-ca62-4193-a4de-6b20be4bdf8d",
                      "vertical_sub_category_id": 120,
                      "vertical_category_id": 18,
                      "name": "AI",
                      "name_en": "AI"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "$ref": "#/components/schemas/keyword"
                  }
                }
              }
            }
          }
        },
        "operationId": "filters_list_verticals",
        "summary": "List industry verticals",
        "description": "Retrieve the list of industry verticals for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/verticals/categories": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing vertical category details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "vertical_category_id": 6,
                      "gics_sector_code": 25,
                      "gics_industry_group_code": 2510,
                      "vertical_category_identifier": "d968669f-9379-4027-98d9-f4df49da1d4d",
                      "description": null,
                      "slug": "automobiles-components",
                      "name": "Automobiles & Components",
                      "name_en": "Automobiles & Components"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "$ref": "#/components/schemas/keyword"
                  }
                }
              }
            }
          }
        },
        "operationId": "filters_list_vertical_categories",
        "summary": "List vertical categories",
        "description": "Retrieve the list of vertical categories for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/verticals/sub_categories": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing vertical sub-category details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "vertical_sub_category_id": 134,
                      "gics_sector_code": 50,
                      "gics_industry_group_code": 5020,
                      "gics_sub_industry_group_code": 50201010,
                      "vertical_sub_category_identifier": "dd2dc328-9ff6-4f7a-aee8-fdf1d09d856d",
                      "description": null,
                      "slug": "advertising",
                      "name": "Advertising"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "$ref": "#/components/schemas/keyword"
                  }
                }
              }
            }
          }
        },
        "operationId": "filters_list_vertical_sub_categories",
        "summary": "List vertical sub-categories",
        "description": "Retrieve the list of vertical sub-categories for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/companies/news/categories": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing news category details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "news_category_id": "d1920fb3-977d-4a4d-8f7a-72e21d81e5b9",
                      "slug": "acquires",
                      "name": "Mergers & Acquisitions",
                      "name_en": "Mergers & Acquisitions"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_news_categories",
        "summary": "List news categories",
        "description": "Retrieve the list of news article categories for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/companies/news/galleries": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing news gallery details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "news_gallery_id": "97a01204-cf56-43ad-98d2-e4991152b148",
                      "slug": "art-fashion",
                      "name": "Art/Fashion",
                      "name_en": "Art/Fashion"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_news_galleries",
        "summary": "List news galleries",
        "description": "Retrieve the list of news galleries for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/profile": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing profile details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "profile_id": 1,
                    "credit": 457499,
                    "topup_credit": 235237,
                    "name": "Pubrio",
                    "description": null,
                    "is_auto_top_up_credits_enabled": false,
                    "auto_top_up_credit": 2500,
                    "auto_top_up_balance_fall_below": 500,
                    "subscription": {
                      "id": 7,
                      "credit": 2250,
                      "max_api_monthly_query": 0,
                      "max_api_daily_query": 0,
                      "max_api_hourly_query": 0,
                      "is_not_able_to_subscribe": false,
                      "max_portal_monthly_query": 60000,
                      "max_portal_daily_query": 2000,
                      "max_portal_hourly_query": 1000,
                      "amount": 59,
                      "is_custom_plan": false,
                      "currency_id": 14,
                      "currency": "usd",
                      "topup_credit_amount": 0.035,
                      "name": "Business - Annual Subscription",
                      "slug": "business-annual",
                      "collection": "business",
                      "is_annual": true,
                      "is_default": null,
                      "identifier": "2618b67a-cc4d-4fd1-bbe8-f906e4f6632d",
                      "last_charged": "2024-11-09T03:40:41.995Z",
                      "next_charge_date": "2025-11-09T03:40:41.995Z",
                      "last_usage_charged": "2024-10-30T15:01:54.895Z",
                      "next_usage_charge_date": "2024-11-13T15:01:54.895Z",
                      "last_refill_date": "2024-11-09T03:40:41.995Z",
                      "next_refill_date": "2024-12-09T03:40:41.995Z",
                      "usage_charge_period": 2,
                      "usage_charge_period_type": "week",
                      "charge_period": 12,
                      "charge_period_type": "month",
                      "web_intent_signal_credit": 25,
                      "max_search_page": 100,
                      "max_search_per_page": 25,
                      "phone_number_redeem_credit": 30,
                      "email_redeem_credit": 15,
                      "people_search_credit": 3,
                      "company_search_credit": 1,
                      "data_export_credit": 1,
                      "max_session_per_page": 100,
                      "max_export_limit": 25000,
                      "max_select_limit": 5000,
                      "max_record_upload_size": 100000,
                      "max_company_search_select_limit": 1000,
                      "max_people_search_select_limit": 25,
                      "max_channel_email_account": 1,
                      "max_channel_linkedin_account": 1,
                      "max_channel_slack_account": 0,
                      "is_full_export_available": true,
                      "is_api_access_available": false,
                      "is_add_user_available": true,
                      "is_refill_without_charge": false,
                      "is_skip_user_related_calculation": false,
                      "is_credit_rollover_available": false,
                      "is_quota_sharing_available": true,
                      "last_modified": "2024-11-09T03:40:41.995Z",
                      "total_credit_used": 7025,
                      "total_charge_credit": 7000,
                      "credit_refill": 459000,
                      "total_amount": 8988,
                      "products": [
                        {
                          "currency_id": 14,
                          "currency": "usd",
                          "waived_quantity": 6,
                          "is_full_waived": false,
                          "id": 3,
                          "name": "Additional User Licence",
                          "slug": "additional-user-licence",
                          "quantity": 16,
                          "amount": 59,
                          "prorated_amount": 11328,
                          "metadata": {
                            "next_charge_date": "2025-11-09T03:40:41.995Z",
                            "is_annual": true,
                            "charge_period": 12,
                            "charge_period_type": "month",
                            "total_used_subscription": 16,
                            "total_user_subscriptions": 33
                          },
                          "total_amount": 7080
                        },
                        {
                          "currency_id": 14,
                          "currency": "usd",
                          "waived_quantity": 0,
                          "is_full_waived": false,
                          "id": 5,
                          "name": "Profile Subscription",
                          "slug": "profile-subscription",
                          "quantity": 1,
                          "amount": 59,
                          "prorated_amount": 708,
                          "metadata": {
                            "next_charge_date": "2025-11-09T03:40:41.995Z",
                            "is_annual": true,
                            "charge_period": 12,
                            "charge_period_type": "month"
                          },
                          "total_amount": 708
                        }
                      ],
                      "usage_products": [
                        {
                          "currency_id": 14,
                          "currency": "usd",
                          "waived_quantity": 1,
                          "is_full_waived": false,
                          "id": 2,
                          "name": "Website Intent Data",
                          "slug": "website-intent-data",
                          "quantity": 281,
                          "amount": 0.88,
                          "prorated_amount": 245.88,
                          "metadata": {
                            "web_intent_signal_credit": 25,
                            "topup_credit_amount": 0.035
                          },
                          "total_amount": 245,
                          "total_credit_used": 7025,
                          "total_charge_credit": 7000
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "operationId": "profile_get",
        "summary": "Get workspace profile",
        "description": "Retrieve the current workspace profile details including plan information and settings.",
        "tags": [
          "Profile"
        ]
      }
    },
    "/profile/usage": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing profile usage details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "api_monthly_usage": 0,
                    "api_daily_usage": 0,
                    "api_hourly_usage": 0,
                    "api_last_refreshed": "2024-11-13T10:01:13.051Z",
                    "portal_monthly_usage": 848,
                    "portal_daily_usage": 163,
                    "portal_hourly_usage": 4,
                    "portal_last_refreshed": "2024-11-13T10:01:13.051Z",
                    "max_api_monthly_query": 0,
                    "max_api_daily_query": 0,
                    "max_api_hourly_query": 0,
                    "max_portal_monthly_query": 60000,
                    "max_portal_daily_query": 2000,
                    "max_portal_hourly_query": 1000,
                    "total_max_api_monthly_query": 0,
                    "total_max_api_daily_query": 0,
                    "total_max_api_hourly_query": 0,
                    "total_max_portal_monthly_query": 2040000,
                    "total_max_portal_daily_query": 68000,
                    "total_max_portal_hourly_query": 34000,
                    "is_api_access_available": false,
                    "is_quota_sharing_enabled": true,
                    "is_quota_sharing_available": true
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "operationId": "profile_get_usage",
        "summary": "Get workspace usage statistics",
        "description": "Retrieve credit usage and quota statistics for the current workspace profile.",
        "tags": [
          "Profile"
        ]
      }
    },
    "/user": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing user details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "timezone_id": 172,
                    "language": "en",
                    "email": "king.lai@pubrio.com",
                    "user_id": "2981d4b3-f8b1-44d8-9759-8f3faf89bfa2",
                    "nickname": "King Lai",
                    "raw_phone_number": "12345679",
                    "phone_number": "12345679",
                    "company": "Pubrio",
                    "profiles": [
                      {
                        "profile_id": 1,
                        "name": "Pubrio"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "user_get",
        "summary": "Get current user info",
        "description": "Retrieve details about the currently authenticated user.",
        "tags": [
          "Profile"
        ]
      }
    },
    "/timezones": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing company details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "timezone_id": 1,
                      "timezone": "Africa/Abidjan",
                      "utc_offset": "+00:00"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_timezones",
        "summary": "List timezones",
        "description": "Retrieve the list of supported timezones.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/management_levels": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing management level details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "management_level_id": 3,
                      "slug": "c_suite",
                      "name": "C suite"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_management_levels",
        "summary": "List management levels",
        "description": "Retrieve the list of management and seniority levels for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/departments/title": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing department title details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "department_id": 10,
                      "slug": "consulting",
                      "name": "Consulting"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_department_titles",
        "summary": "List department titles",
        "description": "Retrieve the list of department titles for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/departments/function": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing department function details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "department_function_id": 53,
                      "slug": "accounting",
                      "name": "Accounting"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_department_functions",
        "summary": "List department functions",
        "description": "Retrieve the list of department functions for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/company_sizes": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing company size details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "company_size_id": 1,
                      "slug": "1-20",
                      "name": "1 - 20"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_company_sizes",
        "summary": "List company size options",
        "description": "Retrieve the list of company size categories for filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/people/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context — `is_enrichment_available`, `parameters`, `filters`, and (when requested) a `profile` block with `credit`, `topup_credit` and `total_credit_cost`."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946",
                    "name": "Doug McMillon",
                    "first_name": "Doug",
                    "last_name": "McMillon",
                    "title": "President & CEO",
                    "seniority": "c_suite",
                    "functions": null,
                    "headline": "President & CEO at Walmart Inc.",
                    "departments": [
                      "c_suite"
                    ],
                    "subdepartments": [
                      "executive"
                    ],
                    "keywords": null,
                    "employment_history": [
                      {
                        "title": "President & CEO",
                        "current": true,
                        "end_date": null,
                        "start_date": "2014-02-01",
                        "company_name": "Walmart"
                      },
                      {
                        "title": "President & CEO, Walmart International",
                        "current": false,
                        "end_date": "2014-01-01",
                        "start_date": "2009-02-01",
                        "company_name": "Walmart"
                      },
                      {
                        "title": "President & CEO",
                        "current": false,
                        "end_date": "2009-01-01",
                        "start_date": "2005-08-01",
                        "company_name": "Sam's Club"
                      }
                    ],
                    "location": "United States",
                    "state": "Arkansas",
                    "city": "Bentonville",
                    "contacts": null,
                    "emails": null,
                    "phones": null,
                    "facebook_url": null,
                    "github_url": null,
                    "twitter_url": null,
                    "linkedin_url": "http://www.linkedin.com/in/dougmcmillon",
                    "saved_lists": null,
                    "company": {
                      "company_name": "Walmart",
                      "company_url": "http://walmart.com",
                      "domain_id": 26067151,
                      "domain_ids": [
                        757023267,
                        368242703,
                        26067151
                      ],
                      "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6",
                      "founded_year": 1962,
                      "location": "United States",
                      "phones": null,
                      "company_size_printed": "466,000",
                      "company_size": 466000,
                      "industry": "Retail",
                      "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg",
                      "linkedin_url": "http://www.linkedin.com/company/walmart",
                      "facebook_url": "http://facebook.com/walmart",
                      "twitter_url": "https://twitter.com/walmart",
                      "crunchbase_url": null,
                      "instagram_url": "http://instagram.com/walmart",
                      "youtube_url": "http://youtube.com/user/walmart"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "people_search_id": {
                    "$ref": "#/components/schemas/people_search_id"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/people_linkedin_url"
                  },
                  "wantedly_url": {
                    "type": "string",
                    "description": "Wantedly profile URL for the person."
                  },
                  "tw104_url": {
                    "type": "string",
                    "description": "104 (Taiwan) profile URL for the person."
                  },
                  "rocketpunch_url": {
                    "type": "string",
                    "description": "RocketPunch profile URL for the person."
                  },
                  "remember_url": {
                    "type": "string",
                    "description": "Remember profile URL for the person."
                  },
                  "youtrust_url": {
                    "type": "string",
                    "description": "YOUTRUST profile URL for the person."
                  },
                  "is_enrichment_available": {
                    "type": "boolean",
                    "description": "Run realtime enrichment when the stored record is incomplete — fills in contact details, employment history and social profiles. Consumes credits. Leave unset for a cache-only read.",
                    "example": true
                  },
                  "is_profile_metadata_available": {
                    "type": "boolean",
                    "description": "Include your workspace credit accounting for this call under `metadata.profile`.",
                    "example": true
                  },
                  "exclude_fields": {
                    "type": "array",
                    "description": "Field slugs to omit from the returned record.",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "anyOf": [
                  {
                    "title": "People Search ID",
                    "required": [
                      "people_search_id"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  },
                  {
                    "title": "Wantedly URL",
                    "required": [
                      "wantedly_url"
                    ]
                  },
                  {
                    "title": "104 URL",
                    "required": [
                      "tw104_url"
                    ]
                  },
                  {
                    "title": "RocketPunch URL",
                    "required": [
                      "rocketpunch_url"
                    ]
                  },
                  {
                    "title": "Remember URL",
                    "required": [
                      "remember_url"
                    ]
                  },
                  {
                    "title": "YOUTRUST URL",
                    "required": [
                      "youtrust_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "people_lookup",
        "summary": "Look up a person by ID",
        "description": "Retrieve detailed information about a specific person using their Pubrio search ID or LinkedIn URL.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/people/linkedin/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing real-time linkedin details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "linkedin_name": "jeffweiner08",
                    "linkedin_url": "https://www.linkedin.com/in/jeffweiner08",
                    "name": "Jeff Weiner",
                    "created_at": "2025-06-08T16:58:16.145Z",
                    "image_url": "https://media.licdn.com/dms/image/v2/C4D16AQFJHyicpAYHXQ/profile-displaybackgroundimage-shrink_200_800/profile-displaybackgroundimage-shrink_200_800/0/1515797967677?e=2147483647&v=beta&t=bAdvQ-o7JZ1b7OKSKau1vB3DMZIHPtefC40_43yzasI",
                    "logo_url": "https://media.licdn.com/dms/image/v2/C4D03AQFM3Y2r-OEStw/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1515623804978?e=2147483647&v=beta&t=8gxxYGav4qEN7hXdbULm_h_JbZKg9lreAZ7HPXDUbF0",
                    "headline": "Executive Chairman at LinkedIn / Founding Partner Next Play Ventures",
                    "description": "Jeff Weiner is the executive chairman of LinkedIn, where he continues to help LinkedIn realize its vision of creating economic opportunity for every member of the global workforce through mentorship, coaching and advising current leadership. \n\nPrior to becoming executive chairman in June 2020, Jeff was the CEO of LinkedIn. During his 11-year tenure, LinkedIn grew its membership base from 33M to more than 690M, increased its revenue from $78M to over $7.9B and expanded the team from 338 employees to over 16,000.\n\nIn addition to his ongoing work at LinkedIn, Jeff is the founding partner of Next Play Ventures, where he’s focused on investing in and coaching early stage start-ups and growth stage companies. \n\nHe is also a founding LP and serves on the Investment Committee of Concrete Rose Capital, an early stage venture fund focused on investing in diverse founders, start-ups serving underserved communities and/or building diverse teams. \n\nJeff is also the co-founder of The Compassion Project, whose mission is to ensure compassion is taught in every elementary school in the U.S.\n\nHe presently resides on the board of directors of Donorschoose.org. \n\nPrior to LinkedIn, Jeff was an Executive in Residence at Accel Partners and Greylock Partners, primarily focused on advising the leadership teams of the firm's existing consumer technology portfolio companies while also working closely with the firm’s partners to evaluate new investment opportunities.\n\nPreviously, he served in key leadership roles at Yahoo! for over seven years, including Executive Vice President of Yahoo!'s Network Division managing Yahoo's consumer web product portfolio, including Yahoo's Front Page, Mail, Search, and Media products.",
                    "country_code": "US",
                    "location": null,
                    "city": "United States",
                    "linkedin_uid": "22330283",
                    "company": {
                      "linkedin_url": "https://www.linkedin.com/company/linkedin",
                      "company_name": "LinkedIn",
                      "linkedin_name": "linkedin",
                      "location": null
                    },
                    "employment_history": [
                      {
                        "title": "LinkedIn",
                        "company_name": "LinkedIn",
                        "linkedin_name": "linkedin",
                        "linkedin_url": "https://www.linkedin.com/company/linkedin?trk=public_profile_experience-group-header",
                        "logo_url": null,
                        "positions": [
                          {
                            "subtitle": "LinkedIn",
                            "meta": "Jul 2020 - Present 5 years",
                            "start_date": "Jul 2020",
                            "end_date": "Present",
                            "title": "Executive Chairman",
                            "description_html": null,
                            "location": null
                          },
                          {
                            "subtitle": "LinkedIn",
                            "meta": "Dec 2008 - Jun 2020 11 years 7 months",
                            "start_date": "Dec 2008",
                            "end_date": "Jun 2020",
                            "title": "CEO",
                            "description_html": null,
                            "location": null
                          }
                        ],
                        "duration": "16 years 7 months",
                        "unformatted_description": null
                      },
                      "..."
                    ],
                    "follower_size": 10410599,
                    "connection_size": 500,
                    "recommendations": [
                      "Akosua Boadi-Agyemang “Personally, Jeff, has impacted my journey so much during his tenure as CEO of LinkedIn. In so doing, he has shown me the true personification of servant leadership. Jeff has showed up for me in ways that have changed the trajectory of my career and life, and he did so without knowing me, initially. While I was searching for an internship in 2017, Jeff showed up (commented on my LinkedIn post) and said “Akosua, would be surprised if something doesn’t materialize.” This played a massive part in where I am in my career at Microsoft today. He showed up to support my first LinkedIn Live stream as a beta tester for the feature. I told him the day and time. I was nervous, had never beta tested anything before. I asked the audience “can anyone see and hear me?” and he showed up, saying, “can hear and see you perfectly”. His support is incredible. When I wrote my first article documenting #theBOLDjourney, Jeff showed up - “This is just the beginning.” Again with the encouragement. To say the least, Jeff has used his power and platform as CEO of LinkedIn to not only empower me but, to uplift millions, globally. In addition, through the #plusonepledge he initiated during his tenure, he ensured that others show up for one another, as well. Jeff, thank you for always showing up. And for embodying the true meaning of the Ngoni Bantu word, “Ubuntu” (I am, because we are).”",
                      "Derek E. Baird, M.Ed. “While I was at Yahoo!, I had the honor of working for Jeff on the Yahoo! Teachers social networking product. Jeff was our executive sponsor on this project and he was our strongest and most passionate advocate. His knowledge of the consumer Internet and youth media space was invaluable and his strategic eye was instrumental in moving our product from a hack day idea into a full beta. On this project Jeff also demonstrated his deep and unwavering commitment to social responsibility. Jeff is a doer. Throughout his tenure on this project he was always more than willing to channel the many resources at Yahoo!, as well as his many connections, to help improve public education in this country. Jeff is a truly exceptional, visionary and inspiring leader. It was a true pleasure to have had the opportunity to work for Jeff Weiner. It was, and continues to be, a highlight of my career.”"
                    ],
                    "honors_and_awards": null,
                    "education": null,
                    "bio": [
                      {
                        "title": "Company Website",
                        "url": "http://www.linkedin.com/"
                      },
                      "..."
                    ],
                    "people_also_viewed": [
                      {
                        "linkedin_url": "https://www.linkedin.com/in/coppedge?trk=public_profile_browsemap-profile",
                        "name": "Rob Coppedge",
                        "headline": null,
                        "location": "Portland, Oregon Metropolitan Area"
                      },
                      "..."
                    ],
                    "similar_profiles": [
                      {
                        "linkedin_url": "https://www.linkedin.com/in/coppedge",
                        "name": "Rob Coppedge",
                        "headline": null
                      },
                      "..."
                    ],
                    "recent_activities": [
                      {
                        "id": "7328934302337945608",
                        "linkedin_url": "https://www.linkedin.com/posts/akothari_next-play-a-mindset-i-picked-up-from-activity-7328934302337945608-hfLO",
                        "title": "“Next play!” —A mindset I picked up from Jeff, and I believe he got it from Coach K. Doesn’t matter if you just crushed it or slipped up — keep…",
                        "interaction": "Liked by Jeff Weiner",
                        "image_url": "https://media.licdn.com/dms/image/v2/D5605AQFsD_LNcQzcKA/videocover-high/B56ZbWa0QpH0B4-/0/1747354093631?e=2147483647&v=beta&t=cqAOZlz3UZdpiX7O-HSMwAROHRS_R8KzIbsp7nAUyfE"
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "linkedin_url": {
                    "$ref": "#/components/schemas/people_linkedin_url"
                  }
                },
                "required": [
                  "linkedin_url"
                ]
              }
            }
          }
        },
        "operationId": "people_lookup_linkedin",
        "summary": "Look up a person by LinkedIn URL",
        "description": "Retrieve person details using a LinkedIn profile URL. Provides real-time data retrieval.",
        "tags": [
          "LinkedIn"
        ]
      }
    },
    "/companies/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context: `is_enrichment_available` (whether realtime enrichment ran), the echoed `parameters` and `filters`, and a `profile` block with `credit`, `topup_credit` and `total_credit_cost`."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "logo_url": "https://buckets.pubrio.com/company-logo/NzMwNTQzMzkzaWxqOXNzbmoxbmV0ZmxpeC5jb21saW5rZWRpbl8zMzMxMjk0OQ==.jpg",
                    "emails": [
                      "..."
                    ],
                    "phones": [
                      "..."
                    ],
                    "contacts": [
                      "..."
                    ],
                    "estimated_revenue": 38900000000,
                    "publicly_traded_symbol": "NFLX",
                    "publicly_traded_exchange": "nasdaq",
                    "specialties": [
                      "Entertainment",
                      "Entertainment Providers",
                      "Telecommunications",
                      "Media Production"
                    ],
                    "company_keywords": [
                      "consumer electronics",
                      "games",
                      "entertainment",
                      "consumer internet",
                      "hardware",
                      "information technology",
                      "internet",
                      "revolutionizing the way people watch tv shows & movies"
                    ],
                    "company_ranking": 232,
                    "title": "Netflix - Watch TV Shows Online, Watch Movies Online",
                    "description": "Netflix is one of the world's leading entertainment services with over 247 million paid memberships in over 190 countries enjoying TV series, films and games across a wide variety of genres and languages. Members can play, pause and resume watching as much as they want, anytime, anywhere, and can change their plans at any time.",
                    "company_address": "100 Winchester Circle, Los Gatos, Ca, Us",
                    "company_name": "Netflix",
                    "founded_year": 1997,
                    "industry": "Entertainment",
                    "domain": "netflix.com",
                    "domain_search_id": "575463e2-474d-4f0a-acc3-fdc2be51e07e",
                    "domain_id": 70635725,
                    "linkedin_company_id": 33312949,
                    "domain_ids": [
                      585935484,
                      730543393,
                      368242675,
                      70635725
                    ],
                    "company_size": 16000,
                    "company_size_printed": "16,000",
                    "youtube_url": null,
                    "crunchbase_url": null,
                    "linkedin_url": "http://www.linkedin.com/company/netflix",
                    "instagram_url": "http://instagram.com/netflix",
                    "facebook_url": "http://facebook.com/netflixus",
                    "twitter_url": "https://twitter.com/netflix",
                    "github_url": null,
                    "x_url": null,
                    "country_code": "US",
                    "location": "United States",
                    "company_url": "http://netflix.com",
                    "company_addresses": [
                      "100 Winchester Circle Los Gatos, CA, US",
                      "5808 W Sunset Blvd Los Angeles, CA 90028, US",
                      "Alameda Xingu, 350 Barueri, SP 06455-030, BR",
                      "245 W 17th St New York, 10011, US",
                      "Stadhouderskade 55 Amsterdam, North Holland 1072 AB, NL",
                      "9 Straits Vw Marina South, 01, SG",
                      "Av. Paseo De La Reforma 483 Torre Reforma, Floor 37 Mexico City, Cuauhtémoc 06500, MX"
                    ],
                    "saved_lists": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  },
                  "tiktok_url": {
                    "type": "string",
                    "description": "TikTok profile URL for the company."
                  },
                  "wantedly_url": {
                    "type": "string",
                    "description": "Wantedly profile URL for the company."
                  },
                  "tw104_url": {
                    "type": "string",
                    "description": "104 (Taiwan) profile URL for the company."
                  },
                  "rocketpunch_url": {
                    "type": "string",
                    "description": "RocketPunch profile URL for the company."
                  },
                  "remember_url": {
                    "type": "string",
                    "description": "Remember profile URL for the company."
                  },
                  "youtrust_url": {
                    "type": "string",
                    "description": "YOUTRUST profile URL for the company."
                  },
                  "is_enrichment_available": {
                    "type": "boolean",
                    "description": "Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.",
                    "example": true
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "companies_lookup",
        "summary": "Look up a company by ID",
        "description": "Retrieve detailed information about a specific company using their Pubrio search ID, domain, or LinkedIn URL.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/companies/linkedin/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing real-time linkedin details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "linkedin_name": "stripe",
                    "linkedin_url": "https://www.linkedin.com/company/stripe",
                    "created_at": "2025-06-01T10:13:03.994Z",
                    "image_url": "https://media.licdn.com/dms/image/v2/C561BAQEd_16iHeIr1Q/company-background_10000/company-background_10000/0/1594068230381/stripe_cover?e=2147483647&v=beta&t=o62bVF0Z15cf0OFikrsuge1xW-iQR4Td6cSOXrMip6I",
                    "logo_url": "https://media.licdn.com/dms/image/v2/D4E0BAQFqiwiSMcKk6A/company-logo_200_200/company-logo_200_200/0/1724937022726/stripe_logo?e=2147483647&v=beta&t=--CED0oRQUupcr1Q2MktzOErO8NMpjCjxa4-JiqrGzU",
                    "company_type": "Privately Held",
                    "company_name": "Stripe",
                    "title": "Help increase the GDP of the internet.",
                    "description": "Stripe builds programmable financial services. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.",
                    "unformatted_description": "\n              Stripe builds programmable financial services. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.\n          ",
                    "linkedin_uid": "2135371",
                    "founded_year": 2010,
                    "follower_size": 1045523,
                    "company_addresses": [
                      "515 N State St, Chicago, Illinois 60610, US",
                      "..."
                    ],
                    "unformatted_company_addresses": [
                      "515 N State St Chicago, Illinois 60610, US",
                      "..."
                    ],
                    "headquarters": "South San Francisco, California",
                    "company_address": "South San Francisco, California",
                    "country_codes": [
                      "US",
                      "..."
                    ],
                    "company_address_directions": [
                      {
                        "directions_url": "https://www.bing.com/maps?where=354+Oyster+Point+Blvd+South+San+Francisco+94080+California+US&trk=org-locations_url"
                      },
                      "..."
                    ],
                    "country_code": "US",
                    "company_size": 11833,
                    "unformatted_company_size": "5,001-10,000 employees",
                    "company_size_printed": "11,900+",
                    "industry": "Technology, Information And Internet",
                    "additional_information": "Additional jobs info: Stripe (2,886 open jobs). Analyst (694,057 open jobs). Engineer (555,845 open jobs). Manager (1,880,925 open jobs). Account Executive (71,457 open jobs). Associate (1,091,945 open jobs). Director (1,220,357 open jobs). Marketing Manager (106,879 open jobs). Scientist (48,969 open jobs). Project Manager (253,048 open jobs). Account Manager (121,519 open jobs). Developer (258,935 open jobs). Software Engineer (300,699 open jobs). Product Manager (199,941 open jobs). Intern (71,196 open jobs). Specialist (768,666 open jobs). Vice President (235,270 open jobs). Executive (690,514 open jobs). Senior Software Engineer (78,145 open jobs). Solutions Architect (100,488 open jobs)",
                    "alumni": null,
                    "alumni_information": null,
                    "company_url": "https://stripe.com/",
                    "domain": "stripe.com",
                    "unique_domain": "stripe.com",
                    "similar_companies": [
                      {
                        "linkedin_url": "https://www.linkedin.com/company/joinsquare?trk=similar-pages",
                        "company_name": "Square",
                        "industry": "Software Development",
                        "location": "San Francisco, CA"
                      },
                      "..."
                    ],
                    "affiliated_pages": [
                      {
                        "linkedin_url": "https://www.linkedin.com/showcase/stripe-partner-ecosystem/?trk=affiliated-pages",
                        "title": "Stripe Partner Ecosystem",
                        "subtitle": "Internet Publishing",
                        "location": "South San Francisco, California"
                      }
                    ],
                    "people": [
                      {
                        "linkedin_url": "https://www.linkedin.com/in/krishnanrajagopalan?trk=org-employees",
                        "name": "Krishnan Rajagopalan",
                        "logo_url": "https://media.licdn.com/dms/image/v2/C5603AQFZAI0yL2gFMg/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1604036687597?e=2147483647&v=beta&t=4XvEQpAzyC6VkTwjEJoipu-RzjVZlghMKRJ9T-bq7gg"
                      },
                      "..."
                    ],
                    "recent_activities": [
                      {
                        "likes_count": 229,
                        "text": "For businesses, sending payouts can be slow, costly, and error-prone. One of the hardest parts about sending money is accurately collecting recipient information like bank account details. Global Payouts allows you to send money to third parties with only their email address. Recipients can instantly authenticate their bank details, decreasing failed payouts by 88%: https://lnkd.in/gCfPBKPH .",
                        "time": "5d",
                        "title": "Stacey Wong",
                        "comments_count": 14,
                        "images": [
                          "https://media.licdn.com/dms/image/sync/v2/D4D27AQG-wcPKYC6OSw/articleshare-shrink_800/B4DZcxj37wGcAM-/0/1748883180077?e=2147483647&v=beta&t=qf6nEEODJRERCfkaegnnDuc0zqIg7NOZX5SXzGsr9Pw"
                        ],
                        "post_url": "https://www.linkedin.com/posts/stripe_activity-7335388680838152194-vzX3",
                        "post_id": "7335388680838152194",
                        "date": "2025-06-03T10:13:03.854Z",
                        "tagged_companies": null,
                        "tagged_people": null,
                        "repost": {
                          "repost_url": null,
                          "repost_id": null,
                          "repost_text": null,
                          "repost_date": null,
                          "tagged_companies": null,
                          "tagged_users": null,
                          "images": null,
                          "videos": null,
                          "external_links": null,
                          "repost_hangtags": null,
                          "repost_followers": null,
                          "repost_title": null
                        }
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  }
                },
                "required": [
                  "linkedin_url"
                ]
              }
            }
          }
        },
        "operationId": "companies_lookup_linkedin",
        "summary": "Look up a company by LinkedIn URL",
        "description": "Retrieve company details using a LinkedIn company page URL. Provides real-time data retrieval.",
        "tags": [
          "LinkedIn"
        ]
      }
    },
    "/companies/similar/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing similar company details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context: `is_enrichment_available` (whether realtime enrichment ran), the echoed `parameters` and `filters`, and a `profile` block with `credit`, `topup_credit` and `total_credit_cost`."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "logo_url": "https://buckets.pubrio.com/company-logo/NzMwNTQzMzkzaWxqOXNzbmoxbmV0ZmxpeC5jb21saW5rZWRpbl8zMzMxMjk0OQ==.jpg",
                    "emails": [
                      "..."
                    ],
                    "phones": [
                      "..."
                    ],
                    "contacts": [
                      "..."
                    ],
                    "estimated_revenue": 38900000000,
                    "publicly_traded_symbol": "NFLX",
                    "publicly_traded_exchange": "nasdaq",
                    "specialties": [
                      "Entertainment",
                      "Entertainment Providers",
                      "Telecommunications",
                      "Media Production"
                    ],
                    "company_keywords": [
                      "consumer electronics",
                      "games",
                      "entertainment",
                      "consumer internet",
                      "hardware",
                      "information technology",
                      "internet",
                      "revolutionizing the way people watch tv shows & movies"
                    ],
                    "company_ranking": 232,
                    "title": "Netflix - Watch TV Shows Online, Watch Movies Online",
                    "description": "Netflix is one of the world's leading entertainment services with over 247 million paid memberships in over 190 countries enjoying TV series, films and games across a wide variety of genres and languages. Members can play, pause and resume watching as much as they want, anytime, anywhere, and can change their plans at any time.",
                    "company_address": "100 Winchester Circle, Los Gatos, Ca, Us",
                    "company_name": "Netflix",
                    "founded_year": 1997,
                    "industry": "Entertainment",
                    "domain": "netflix.com",
                    "domain_search_id": "575463e2-474d-4f0a-acc3-fdc2be51e07e",
                    "domain_id": 70635725,
                    "linkedin_company_id": 33312949,
                    "domain_ids": [
                      585935484,
                      730543393,
                      368242675,
                      70635725
                    ],
                    "company_size": 16000,
                    "company_size_printed": "16,000",
                    "youtube_url": null,
                    "crunchbase_url": null,
                    "linkedin_url": "http://www.linkedin.com/company/netflix",
                    "instagram_url": "http://instagram.com/netflix",
                    "facebook_url": "http://facebook.com/netflixus",
                    "twitter_url": "https://twitter.com/netflix",
                    "github_url": null,
                    "x_url": null,
                    "country_code": "US",
                    "location": "United States",
                    "company_url": "http://netflix.com",
                    "company_addresses": [
                      "100 Winchester Circle Los Gatos, CA, US",
                      "5808 W Sunset Blvd Los Angeles, CA 90028, US",
                      "Alameda Xingu, 350 Barueri, SP 06455-030, BR",
                      "245 W 17th St New York, 10011, US",
                      "Stadhouderskade 55 Amsterdam, North Holland 1072 AB, NL",
                      "9 Straits Vw Marina South, 01, SG",
                      "Av. Paseo De La Reforma 483 Torre Reforma, Floor 37 Mexico City, Cuauhtémoc 06500, MX"
                    ],
                    "saved_lists": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  },
                  "tiktok_url": {
                    "type": "string",
                    "description": "TikTok profile URL for the company."
                  },
                  "wantedly_url": {
                    "type": "string",
                    "description": "Wantedly profile URL for the company."
                  },
                  "tw104_url": {
                    "type": "string",
                    "description": "104 (Taiwan) profile URL for the company."
                  },
                  "rocketpunch_url": {
                    "type": "string",
                    "description": "RocketPunch profile URL for the company."
                  },
                  "remember_url": {
                    "type": "string",
                    "description": "Remember profile URL for the company."
                  },
                  "youtrust_url": {
                    "type": "string",
                    "description": "YOUTRUST profile URL for the company."
                  },
                  "is_enrichment_available": {
                    "type": "boolean",
                    "description": "Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.",
                    "example": true
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "companies_lookup_similar",
        "summary": "Look up similar companies",
        "description": "Legacy alias of Company Lookup: returns the single company record for a Pubrio search ID, domain, or LinkedIn URL. To find similar companies, use Similar Company Search.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/companies/jobs/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company job details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "job_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
                    "job_search_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
                    "last_modified": "2025-05-31T20:41:27.894Z",
                    "companies": {
                      "logo_url": "https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                      "domain_search_id": "539e2c34-de6b-4613-8f5b-e3aa18b4ef47",
                      "company_name": "Google",
                      "linkedin_name": "google",
                      "country_code": "US",
                      "domain": "google.com"
                    },
                    "location": "Seoul, Seoul, South Korea",
                    "job_url": "https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D",
                    "posting_date": "2025-05-31",
                    "country_code": "KR",
                    "location_id": 491,
                    "title": "Software Engineer, gReach Program for People with Disabilities (장애인 채용)",
                    "country": "South Korea"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "job_search_id": {
                    "$ref": "#/components/schemas/job_search_id"
                  }
                },
                "required": [
                  "job_search_id"
                ]
              }
            }
          }
        },
        "operationId": "companies_lookup_jobs",
        "summary": "Look up company job postings",
        "description": "Retrieve job posting details for a specific company using a job search ID.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/companies/news/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company news details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "news_id": "0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd",
                    "news_search_id": "4110b929-17cd-42aa-a159-906ead0c9b56",
                    "keywords": [
                      "AI",
                      "Digital China",
                      "INSEAD",
                      "manajemen perusahaan",
                      "transformasi digital",
                      "studi kasus",
                      "Guo Wei",
                      "proses bisnis",
                      "komputasi awan",
                      "integrasi data"
                    ],
                    "summary_original": "Guo Wei, Chairman Digital China, memaparkan tentang manajemen perusahaan era AI di INSEAD 2025 Asia AI Conference, serta meluncurkan studi kasus tentang perjalanan transformasi AI Digital China.",
                    "title_original": "Digital China membahas manajemen perusahaan era AI di INSEAD",
                    "news_gallery_ids": [
                      "7c8ec9cc-66c5-4153-82da-9c8f356c6c99"
                    ],
                    "country_codes": [
                      "CN",
                      "SG"
                    ],
                    "company_country_codes": [
                      "CN",
                      "FR"
                    ],
                    "amount_normalized": null,
                    "amount": null,
                    "job_title_tags": [
                      "executive",
                      "leadership"
                    ],
                    "job_title": "Chairman",
                    "headcount": null,
                    "financing_type_tags": null,
                    "financing_type_normalized": null,
                    "financing_type": null,
                    "domains": [
                      "insead.edu",
                      "digitalchina.com"
                    ],
                    "companies": [
                      {
                        "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg",
                        "domain_search_id": "dfbe6797-5311-46f9-9518-bf1a7c3d09bc",
                        "country_code": "FR",
                        "company_name": "Insead",
                        "linkedin_name": "insead",
                        "domain": "insead.edu"
                      },
                      {
                        "logo_url": "https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
                        "domain_search_id": "e13a9e24-a07d-4630-9b47-fceb778df74e",
                        "country_code": "CN",
                        "company_name": "Digital China",
                        "linkedin_name": "digital-china",
                        "domain": "digitalchina.com"
                      }
                    ],
                    "news_galleries": [
                      {
                        "slug": "banking-financial-service",
                        "news_gallery_id": "7c8ec9cc-66c5-4153-82da-9c8f356c6c99",
                        "name": "Banking/Financial Service"
                      }
                    ],
                    "locations": [
                      "Singapore",
                      "China"
                    ],
                    "last_modified": "2025-06-01T10:12:25.284Z",
                    "image_url": null,
                    "url": "http://enold.prnasia.com/p/asia-story-125304015-0.shtml",
                    "published_at": "2025-06-01T08:00:00.000Z",
                    "language": "id",
                    "source": "prnasia.com",
                    "category": "launches",
                    "title": "Digital China's AI-driven transformation showcased at INSEAD",
                    "summary": "Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey.",
                    "news_category_name": "Launches"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "news_search_id": {
                    "$ref": "#/components/schemas/news_search_id"
                  }
                },
                "required": [
                  "news_search_id"
                ]
              }
            }
          }
        },
        "operationId": "companies_lookup_news",
        "summary": "Look up company news",
        "description": "Retrieve news article details for a specific company using a news search ID.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/companies/advertisements/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company advertisement details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "headline": "Thuraya-4 Satellite Solutions for Government",
                    "description": "Thuraya-4 provides secure, always-on connectivity for vehicles, aircraft and command centers, ensuring mission continuity. \n\nLearn more about our satellite-powered government solutions.",
                    "poster": "Space42",
                    "poster_title": "Promoted",
                    "promoted_by": null,
                    "cta": "Learn more",
                    "target_country_codes": [
                      "MM",
                      "..."
                    ],
                    "target_locations": [
                      "United Arab Emirates",
                      "..."
                    ],
                    "total_impressions": "10k-20k",
                    "impression_countries": [
                      {
                        "country": "India",
                        "impressions": "19%"
                      },
                      "..."
                    ],
                    "advertisement_id": "a92643e8-9033-4029-aa65-ef929327cebb",
                    "advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
                    "created_at": "2026-03-03T01:01:31.134Z",
                    "last_modified": "2026-03-03T13:01:22.805Z",
                    "started_at": "2026-02-25T00:00:00.000Z",
                    "ended_at": "2026-03-02T00:00:00.000Z",
                    "title": "Thuraya-4 Satellite Solutions for Government",
                    "source_type": "linkedin",
                    "advertisement_format": "Single Image Ad",
                    "video_url": null,
                    "image_url": "https://buckets.pubrio.com/images/public/qDf8TrjHJw9o8xFoQJv7vhnkLXNYKy1ThNVCWSHPmgHG5j7U4EroKtH4cYJcHCzTSh.jpg",
                    "carousel_images": null,
                    "destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content",
                    "companies": {
                      "logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg",
                      "domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a",
                      "company_name": "Space42",
                      "linkedin_name": "space42ai",
                      "country_code": "AE",
                      "domain": "space42.ai"
                    },
                    "raw_link_url": null,
                    "publisher_platforms": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "advertisement_search_id": {
                    "$ref": "#/components/schemas/advertisement_search_id"
                  },
                  "is_include_unlinked_companies": {
                    "$ref": "#/components/schemas/advertisement_is_include_unlinked_companies"
                  }
                },
                "required": [
                  "advertisement_search_id"
                ]
              }
            }
          }
        },
        "operationId": "companies_lookup_advertisements",
        "summary": "Look up company advertisements",
        "description": "Retrieve advertisement details for a specific company using an advertisement search ID. The response includes the resolved `destination_url`, the original `raw_link_url`, and, for Meta ads, `publisher_platforms`.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/technologies/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing company technology details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Request context: `is_enrichment_available` indicates whether realtime enrichment ran for this lookup."
                    },
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "category_id": 1,
                      "technologies": [
                        {
                          "icon": "Google Ads.svg",
                          "name": "Google Ads",
                          "tag_id": 4580,
                          "version": null,
                          "website": "https://ads.google.com/",
                          "location": "pubrio.com",
                          "logo_url": "https://buckets.pubrio.com/technology-logo/NDU4MGIyOXNtYjhheGdvb2dsZS1hZHM=.jpg",
                          "last_detected": null,
                          "first_detected": "2023-01-07T06:40:56.597287"
                        }
                      ],
                      "category_name": "Advertising"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  },
                  "domain_id": {
                    "$ref": "#/components/schemas/domain_id"
                  },
                  "tiktok_url": {
                    "type": "string",
                    "description": "TikTok profile URL for the company."
                  },
                  "wantedly_url": {
                    "type": "string",
                    "description": "Wantedly profile URL for the company."
                  },
                  "tw104_url": {
                    "type": "string",
                    "description": "104 (Taiwan) profile URL for the company."
                  },
                  "rocketpunch_url": {
                    "type": "string",
                    "description": "RocketPunch profile URL for the company."
                  },
                  "remember_url": {
                    "type": "string",
                    "description": "Remember profile URL for the company."
                  },
                  "youtrust_url": {
                    "type": "string",
                    "description": "YOUTRUST profile URL for the company."
                  },
                  "is_enrichment_available": {
                    "type": "boolean",
                    "description": "Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.",
                    "example": true
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  },
                  {
                    "title": "Domain ID",
                    "required": [
                      "domain_id"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "technologies_lookup",
        "summary": "Look up a technology",
        "description": "Retrieve detailed information about a specific technology used by companies.",
        "tags": [
          "Lookup"
        ]
      }
    },
    "/channels/types/templates": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing channel template type details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "channel_type_id": 1,
                      "slug": "email",
                      "channel_type_identifier": "db3ecea8-b838-4cfa-8aa1-c358223b0060",
                      "logo_url": "https://buckets.pubrio.com/technology-logo/tdurnBxI97MV1hr2L1QaYgt.jpg",
                      "node_type": "action",
                      "channel_nodes": [
                        {
                          "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c",
                          "channel_node_identifier": "30896b66-7fc7-42bf-b5fe-ce7e1fdb9e30",
                          "channel_type_id": 1,
                          "slug": "send_email",
                          "parameter_properties": [
                            {
                              "name": "Subject",
                              "slug": "subject",
                              "hints": "My subject line",
                              "field_type": "string",
                              "max_length": 1000,
                              "min_length": 1,
                              "description": "Subject line of the email",
                              "is_required": true,
                              "display_type": "string",
                              "supported_tools": [
                                "variables"
                              ],
                              "is_template_field": true,
                              "is_verify_required": false,
                              "is_display_as_snippet": true,
                              "is_return_in_plain_text": true
                            },
                            {
                              "name": "Content",
                              "slug": "content",
                              "hints": "Write your email content",
                              "field_type": "string",
                              "max_length": 250000,
                              "min_length": 0,
                              "description": "HTML text message of email",
                              "is_required": true,
                              "display_type": "email_editor",
                              "supported_tools": [
                                "formatting_options",
                                "variables",
                                "insert_link",
                                "attachments",
                                "insert_photo",
                                "code_mode",
                                {
                                  "slug": "insert_signature",
                                  "syntax": "{{insert_signature.signature_html}}"
                                }
                              ],
                              "is_template_field": true,
                              "is_verify_required": false,
                              "is_attachment_allowed": true,
                              "is_display_as_snippet": false,
                              "is_return_in_plain_text": false
                            },
                            {
                              "name": "Attachments",
                              "slug": "attachments",
                              "hints": null,
                              "field_type": "array",
                              "max_length": 25,
                              "min_length": 0,
                              "description": null,
                              "is_required": false,
                              "display_type": null,
                              "is_template_field": true,
                              "is_verify_required": false,
                              "is_attachment_allowed": true,
                              "is_hide_from_control_panel": true
                            }
                          ],
                          "is_template_available": true,
                          "logo_url": "https://buckets.pubrio.com/technology-logo/tdurnBxI97MV1hr2L1QaYgt.jpg",
                          "node_type": "action",
                          "input_properties": [
                            {
                              "name": "To email addresses [multiple comma-separated]",
                              "slug": "to_email_addresses",
                              "hints": "to@example.com",
                              "field_type": "array",
                              "max_length": 1000,
                              "min_length": 1,
                              "description": "Email address of the recipient",
                              "is_required": true,
                              "display_type": "email_input",
                              "is_verify_required": false
                            }
                          ],
                          "name": "Send Email",
                          "description": "The Send Email node sends emails using the connected email provider."
                        }
                      ],
                      "name": "Email",
                      "description": "Sends automated emails based on triggers or events."
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "channels_get_template_types",
        "summary": "List channel template types",
        "description": "Retrieve available channel types for outreach templates.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing channel template details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "channel_template_id": 245,
                      "channel_template_identifier": "4f6f40cb-ed6d-4cca-99d8-616feef8de93",
                      "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c",
                      "channel_node_slug": "send_email",
                      "channel_type_id": 1,
                      "channel_type_slug": "email",
                      "owner_email": "example@pubrio.com",
                      "owner_name": "Owner",
                      "name": "email",
                      "description": null,
                      "parameters": {
                        "content": "<div>hello world</div>",
                        "subject": "Hello World",
                        "attachments": []
                      },
                      "default_values": null,
                      "version_number": 1,
                      "version_name": "version 1",
                      "is_default": true,
                      "is_personal": true,
                      "created_at": "2025-07-29T09:07:11.969Z",
                      "last_modified": "2025-07-29T09:07:11.969Z"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_template_identifier": {
                    "$ref": "#/components/schemas/channel_template_identifier"
                  }
                },
                "required": [
                  "channel_template_identifier"
                ]
              }
            }
          }
        },
        "operationId": "channels_lookup_template",
        "summary": "Look up a channel template",
        "description": "Retrieve details of a specific channel template by ID.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing list of channel template details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/data"
                        }
                      ],
                      "properties": {
                        "channel_templates": {
                          "type": "array",
                          "description": "The template body. **Its keys depend on the channel type**, so read `channel_type_slug` before parsing: `email` → `subject`, `content`, `attachments`; `linkedin` (chat message) → `message`, `attachments`; `linkedin` (invitation) → `message`; `twilio` → `message`, `from`, `method`.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 4,
                      "total_pages": 1,
                      "is_timeout": false
                    },
                    "channel_templates": [
                      {
                        "channel_template_id": 1,
                        "channel_template_identifier": "4f6f40cb-ed6d-4cca-99d8-616feef8de93",
                        "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c",
                        "channel_node_slug": "send_email",
                        "channel_type_id": 1,
                        "channel_type_slug": "email",
                        "owner_email": "example@pubrio.com",
                        "owner_name": "Owner",
                        "name": "email",
                        "version_number": 1,
                        "version_name": "version 1",
                        "is_default": true,
                        "is_personal": true,
                        "created_at": "2025-07-29T09:07:11.969Z",
                        "last_modified": "2025-07-29T09:07:11.969Z",
                        "channel_template_versions": [
                          {
                            "channel_template_id": 1,
                            "channel_template_identifier": "4f6f40cb-ed6d-4cca-99d8-616feef8de93",
                            "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c",
                            "channel_node_slug": "send_email",
                            "channel_type_id": 1,
                            "channel_type_slug": "email",
                            "owner_email": "example@pubrio.com",
                            "owner_name": "Owner",
                            "name": "email",
                            "parameters": {
                              "content": "<div>hello world</div>",
                              "subject": "Hello World",
                              "attachments": []
                            },
                            "version_number": 1,
                            "version_name": "version 1",
                            "default_values": null,
                            "is_default": true,
                            "is_personal": true,
                            "created_at": "2025-07-29T09:07:11.969581",
                            "last_modified": "2025-07-29T09:07:11.969581"
                          }
                        ]
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_template_name": {
                    "$ref": "#/components/schemas/channel_template_name"
                  },
                  "channel_nodes": {
                    "$ref": "#/components/schemas/channel_nodes"
                  },
                  "channel_types": {
                    "$ref": "#/components/schemas/channel_types"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  }
                }
              }
            }
          }
        },
        "operationId": "channels_list_templates",
        "summary": "List channel templates",
        "description": "Retrieve a list of all channel outreach templates in the workspace.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates/create": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing list of channel template details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "channel_template_id": 248,
                    "channel_template_identifier": "4c717a78-26e9-49eb-ab2e-e1ce0755674a",
                    "created_at": "2025-08-07T17:22:11.344Z",
                    "version_number": 1,
                    "is_default": true,
                    "name": "Email Template",
                    "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c",
                    "parameters": {
                      "content": "<div>hello world</div>",
                      "subject": "hello world"
                    },
                    "version_name": "Default"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_template_name": {
                    "type": "string",
                    "description": "Display name for the template."
                  },
                  "version_name": {
                    "type": "string",
                    "description": "Label for this version, for example `v1`. Each version is a separate record with its own `channel_template_id`."
                  },
                  "channel_node_id": {
                    "type": "string",
                    "description": "The channel node this template targets, as a UUID. Resolve it from [Channel Template Types](/en/api-reference/endpoint/channels/types_templates) — for example the `send_email` node under the `email` channel type. The node also defines which `parameters` keys are valid."
                  },
                  "parameters": {
                    "type": "object",
                    "description": "The template body. Valid keys are defined by the chosen `channel_node_id`: `send_email` takes `subject`, `content` and `attachments`; LinkedIn chat takes `message` and `attachments`; LinkedIn invitations take `message`; Twilio takes `message`, `from` and `method`."
                  }
                },
                "required": [
                  "channel_template_name",
                  "parameters",
                  "channel_node_id"
                ]
              }
            }
          }
        },
        "operationId": "channels_create_template",
        "summary": "Create a channel template",
        "description": "Create a new outreach channel template with specified parameters.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates/create_version": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing list of channel template details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "channel_template_id": 249,
                    "channel_template_identifier": "4c717a78-26e9-49eb-ab2e-e1ce0755674a",
                    "created_at": "2025-08-07T17:22:11.344Z",
                    "version_number": 2,
                    "is_default": true,
                    "name": "Email Template",
                    "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c",
                    "parameters": {
                      "content": "<div>hello world</div>",
                      "subject": "hello world"
                    },
                    "version_name": "Default 2"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_template_identifier": {
                    "$ref": "#/components/schemas/channel_template_identifier"
                  },
                  "channel_template_id": {
                    "$ref": "#/components/schemas/channel_template_id"
                  },
                  "version_name": {
                    "$ref": "#/components/schemas/version_name"
                  },
                  "is_default": {
                    "$ref": "#/components/schemas/is_default"
                  },
                  "parameters": {
                    "$ref": "#/components/schemas/channel_template_parameters"
                  }
                },
                "required": [
                  "channel_template_identifier"
                ]
              }
            }
          }
        },
        "operationId": "channels_create_template_version",
        "summary": "Create a template version",
        "description": "Create a new version of an existing channel template.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates/default": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing list of channel template details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "channel_template_id": 251,
                      "channel_template_identifier": "4c717a78-26e9-49eb-ab2e-e1ce0755674a",
                      "is_default": true,
                      "last_modified": "2025-08-07T17:58:54.105Z"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_template_id": {
                    "$ref": "#/components/schemas/channel_template_id"
                  }
                },
                "required": [
                  "channel_template_id"
                ]
              }
            }
          }
        },
        "operationId": "channels_get_default_template",
        "summary": "Get default channel template",
        "description": "Retrieve the default channel template for the workspace.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates/update": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing list of channel template details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": {
                    "channel_template_id": 251,
                    "last_modified": "2025-08-07T18:00:43.255Z",
                    "name": "Email Template",
                    "...": "..."
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_template_identifier": {
                    "$ref": "#/components/schemas/channel_template_identifier"
                  },
                  "channel_template_id": {
                    "$ref": "#/components/schemas/channel_template_id"
                  },
                  "channel_template_name": {
                    "type": "string",
                    "description": "Display name for the template."
                  },
                  "version_name": {
                    "type": "string",
                    "description": "Label for this version, for example `v1`. Each version is a separate record with its own `channel_template_id`."
                  },
                  "parameters": {
                    "type": "object",
                    "description": "The template body. Valid keys are defined by the chosen `channel_node_id`: `send_email` takes `subject`, `content` and `attachments`; LinkedIn chat takes `message` and `attachments`; LinkedIn invitations take `message`; Twilio takes `message`, `from` and `method`."
                  }
                },
                "required": [
                  "channel_template_id",
                  "channel_template_identifier"
                ]
              }
            }
          }
        },
        "operationId": "channels_update_template",
        "summary": "Update a channel template",
        "description": "Update an existing channel template's configuration.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/channels/templates/delete": {
      "delete": {
        "responses": {
          "200": {
            "description": "Successful response, no error returned.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data"
                    }
                  }
                },
                "example": {
                  "data": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channel_templates": {
                    "type": "array",
                    "description": "Numeric `channel_template_id` values to delete — not the UUID `channel_template_identifier`. **Each version is deleted separately.** A template created with `create_version` has several ids sharing one identifier; deleting one leaves the others, and the template keeps appearing in the listing. Read every version's `channel_template_id` from [Channel Templates](/en/api-reference/endpoint/channels/templates) and pass them all to remove a template completely.",
                    "items": {
                      "type": "integer"
                    },
                    "example": [
                      380,
                      381
                    ]
                  },
                  "is_entire_templates": {
                    "$ref": "#/components/schemas/is_entire_templates"
                  }
                },
                "required": [
                  "channel_templates"
                ]
              }
            }
          }
        },
        "operationId": "channels_delete_template",
        "summary": "Delete a channel template",
        "description": "Delete a channel template from the workspace.",
        "tags": [
          "Channels"
        ]
      }
    },
    "/monitors/statistics": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing monitor statistics overview.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "total_monitors": {
                          "type": "integer",
                          "description": "Total number of monitors in the workspace."
                        },
                        "triggers_today": {
                          "type": "integer",
                          "description": "Number of monitor triggers today."
                        },
                        "triggers_yesterday": {
                          "type": "integer",
                          "description": "Number of monitor triggers yesterday."
                        },
                        "triggers_comparison_rate": {
                          "type": "number",
                          "description": "Rate of change between today's and yesterday's triggers. Negative values indicate a decrease."
                        },
                        "success_today": {
                          "type": "integer",
                          "description": "Number of successful triggers today."
                        },
                        "success_yesterday": {
                          "type": "integer",
                          "description": "Number of successful triggers yesterday."
                        },
                        "success_rate_today": {
                          "type": "number",
                          "nullable": true,
                          "description": "Success rate for today's triggers (0 to 1). Null when there were no triggers today."
                        },
                        "success_rate_yesterday": {
                          "type": "number",
                          "nullable": true,
                          "description": "Success rate for yesterday's triggers (0 to 1). Null when there were no triggers yesterday."
                        },
                        "triggers_last_7_days": {
                          "type": "integer",
                          "description": "Number of monitor triggers over the last 7 days."
                        },
                        "avg_triggers_per_day": {
                          "type": "number",
                          "description": "Average number of triggers per day over the last 7 days (rounded up)."
                        },
                        "success_rate_last_7_days": {
                          "type": "number",
                          "nullable": true,
                          "description": "Success rate over the last 7 days (0 to 1). Null when there were no triggers in the window."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "total_monitors": 8,
                    "triggers_today": 3,
                    "triggers_yesterday": 46,
                    "triggers_comparison_rate": -0.935,
                    "triggers_last_7_days": 112,
                    "avg_triggers_per_day": 16,
                    "success_today": 3,
                    "success_yesterday": 46,
                    "success_rate_today": 1,
                    "success_rate_yesterday": 1,
                    "success_rate_last_7_days": 0.982
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "operationId": "monitors_get_statistics",
        "summary": "Get monitor statistics",
        "description": "Retrieve a workspace-wide overview of monitor trigger statistics. There is no monitor_id parameter — figures are aggregated across all monitors in the workspace (watchlist-backed monitors are excluded).",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/statistics/logs": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response. The envelope is `{ metadata: { filters }, data: { pagination, monitor_logs } }` — `metadata.filters` echoes the filters that were applied to the search.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "filters": {
                          "type": "object",
                          "description": "Echo of the filters applied to this search."
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "pagination": {
                          "type": "object",
                          "properties": {
                            "page": {
                              "type": "integer",
                              "description": "Current page number."
                            },
                            "per_page": {
                              "type": "integer",
                              "description": "Number of results per page."
                            },
                            "total_entries": {
                              "type": "integer",
                              "description": "Total number of log entries."
                            },
                            "total_pages": {
                              "type": "integer",
                              "description": "Total number of pages."
                            },
                            "total_display_pages": {
                              "type": "integer",
                              "description": "Total number of display pages."
                            },
                            "is_timeout": {
                              "type": "boolean",
                              "description": "Whether the query timed out."
                            }
                          }
                        },
                        "monitor_logs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "monitor_log_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "Unique identifier for this log entry."
                              },
                              "monitor_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "Identifier of the monitor that generated this log."
                              },
                              "parent_monitor_log_id": {
                                "type": "string",
                                "description": "Identifier of the parent log entry, if this is a retry."
                              },
                              "detection_mode": {
                                "type": "string",
                                "description": "Detection mode used. Either 'company_first' or 'signal_first'."
                              },
                              "signal_type": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Types of signals monitored (e.g., 'jobs', 'news', 'advertisements')."
                              },
                              "destination_type": {
                                "type": "string",
                                "description": "Delivery destination type (e.g., 'email', 'webhook')."
                              },
                              "response_status_code": {
                                "type": "integer",
                                "description": "HTTP status code from the destination response."
                              },
                              "status": {
                                "type": "string",
                                "description": "Status of the trigger execution (e.g., 'success', 'failed')."
                              },
                              "error_message": {
                                "type": "string",
                                "description": "Error message if the trigger failed. Empty string on success."
                              },
                              "total_signals": {
                                "type": "integer",
                                "description": "Total number of signals detected."
                              },
                              "total_companies": {
                                "type": "integer",
                                "description": "Total number of companies found."
                              },
                              "total_people": {
                                "type": "integer",
                                "description": "Total number of people found."
                              },
                              "trigger_credit": {
                                "type": "integer",
                                "description": "Credits consumed for the trigger itself."
                              },
                              "total_company_credit": {
                                "type": "integer",
                                "description": "Credits consumed for company enrichment."
                              },
                              "total_people_credit": {
                                "type": "integer",
                                "description": "Credits consumed for people enrichment."
                              },
                              "redeem_email_credit": {
                                "type": "integer",
                                "description": "Credits consumed for email redemption."
                              },
                              "redeem_phone_credit": {
                                "type": "integer",
                                "description": "Credits consumed for phone redemption."
                              },
                              "total_credit": {
                                "type": "integer",
                                "description": "Total credits consumed for this trigger."
                              },
                              "retry_attempt": {
                                "type": "integer",
                                "description": "Number of retry attempts made."
                              },
                              "processing_time_ms": {
                                "type": "integer",
                                "description": "Total processing time in milliseconds."
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Timestamp when the log entry was created."
                              },
                              "retry_logs": {
                                "type": "array",
                                "items": {
                                  "type": "object"
                                },
                                "description": "Array of retry log entries, if any."
                              },
                              "is_retry_succeed": {
                                "type": "boolean",
                                "description": "Whether a retry attempt succeeded."
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "statuses": [
                        "failure"
                      ],
                      "language": "en"
                    }
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 45,
                      "total_pages": 2,
                      "total_display_pages": 2,
                      "is_timeout": false
                    },
                    "monitor_logs": [
                      {
                        "monitor_log_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                        "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
                        "parent_monitor_log_id": "",
                        "detection_mode": "company_first",
                        "signal_type": [
                          "jobs",
                          "news",
                          "advertisements"
                        ],
                        "destination_type": "email",
                        "response_status_code": 200,
                        "status": "success",
                        "error_message": "",
                        "total_signals": 25,
                        "total_companies": 11,
                        "total_people": 32,
                        "trigger_credit": 15,
                        "total_company_credit": 11,
                        "total_people_credit": 33,
                        "redeem_email_credit": 0,
                        "redeem_phone_credit": 0,
                        "total_credit": 59,
                        "retry_attempt": 0,
                        "processing_time_ms": 97952,
                        "created_at": "2026-04-05T18:28:05.000Z",
                        "retry_logs": [],
                        "is_retry_succeed": false
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor to retrieve logs for."
                  },
                  "monitor_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "Filter to logs from these monitors."
                  },
                  "monitor_log_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "Filter to these specific log entries."
                  },
                  "search_term": {
                    "type": "string",
                    "description": "Search term matched against error_message, destination_type, and detection_mode (case-insensitive substring)."
                  },
                  "start_date": {
                    "type": "string",
                    "format": "date",
                    "description": "Start of the created_at date range (ISO date string). Used together with end_date."
                  },
                  "end_date": {
                    "type": "string",
                    "format": "date",
                    "description": "End of the created_at date range (ISO date string). Used together with start_date."
                  },
                  "order_by": {
                    "type": "string",
                    "enum": [
                      "created_at",
                      "total_credit",
                      "processing_time_ms",
                      "total_signals",
                      "status",
                      "retry_attempt"
                    ],
                    "description": "Field to sort by. Defaults to created_at.",
                    "default": "created_at"
                  },
                  "is_ascending_order": {
                    "type": "boolean",
                    "description": "Sort in ascending order. Defaults to false (descending).",
                    "default": false
                  },
                  "statuses": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by trigger status (e.g., 'success', 'failure'). Also accepts the virtual value 'recovered' — failed triggers whose retry later succeeded."
                  },
                  "signal_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter to logs whose signal types include any of these values."
                  },
                  "destination_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by destination types (e.g., ['email', 'webhook'])."
                  },
                  "detection_modes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by detection modes (e.g., ['company_first', 'signal_first'])."
                  },
                  "per_page": {
                    "type": "integer",
                    "description": "Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.",
                    "default": 25
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.",
                    "default": 1
                  }
                }
              }
            }
          }
        },
        "operationId": "monitors_list_statistics_logs",
        "summary": "List monitor statistics logs",
        "description": "Retrieve a paginated list of detection logs for a specific monitor.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/statistics/logs/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing detailed information for a single monitor log entry, including the full request and response payloads. The envelope is `{ metadata: { monitor_log_id }, data: {...} }`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "monitor_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "The monitor log identifier that was looked up."
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for this log entry."
                        },
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Identifier of the monitor that generated this log."
                        },
                        "parent_monitor_log_id": {
                          "type": "string",
                          "description": "Identifier of the parent log entry, if this is a retry."
                        },
                        "detection_mode": {
                          "type": "string",
                          "description": "Detection mode used. Either 'company_first' or 'signal_first'."
                        },
                        "signal_type": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Types of signals monitored."
                        },
                        "destination_type": {
                          "type": "string",
                          "description": "Delivery destination type."
                        },
                        "response_status_code": {
                          "type": "integer",
                          "description": "HTTP status code from the destination response."
                        },
                        "status": {
                          "type": "string",
                          "description": "Status of the trigger execution."
                        },
                        "error_message": {
                          "type": "string",
                          "description": "Error message if the trigger failed."
                        },
                        "total_signals": {
                          "type": "integer",
                          "description": "Total number of signals detected."
                        },
                        "total_companies": {
                          "type": "integer",
                          "description": "Total number of companies found."
                        },
                        "total_people": {
                          "type": "integer",
                          "description": "Total number of people found."
                        },
                        "trigger_credit": {
                          "type": "integer",
                          "description": "Credits consumed for the trigger."
                        },
                        "total_company_credit": {
                          "type": "integer",
                          "description": "Credits consumed for company enrichment."
                        },
                        "total_people_credit": {
                          "type": "integer",
                          "description": "Credits consumed for people enrichment."
                        },
                        "redeem_email_credit": {
                          "type": "integer",
                          "description": "Credits consumed for email redemption."
                        },
                        "redeem_phone_credit": {
                          "type": "integer",
                          "description": "Credits consumed for phone redemption."
                        },
                        "total_credit": {
                          "type": "integer",
                          "description": "Total credits consumed."
                        },
                        "retry_attempt": {
                          "type": "integer",
                          "description": "Number of retry attempts made."
                        },
                        "processing_time_ms": {
                          "type": "integer",
                          "description": "Total processing time in milliseconds."
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp when the log entry was created."
                        },
                        "retry_logs": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Array of retry log entries."
                        },
                        "is_retry_succeed": {
                          "type": "boolean",
                          "description": "Whether a retry attempt succeeded."
                        },
                        "request_payload": {
                          "type": "object",
                          "description": "The full monitor configuration and data that was sent for this trigger execution."
                        },
                        "response_payload": {
                          "type": "object",
                          "description": "The response payload received from the destination."
                        },
                        "attributes": {
                          "type": "object",
                          "description": "Execution attributes captured for this trigger (destination snapshot and related metadata). Webhook signing secrets are scrubbed."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "monitor_log_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                  },
                  "data": {
                    "monitor_log_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
                    "parent_monitor_log_id": "",
                    "detection_mode": "company_first",
                    "signal_type": [
                      "jobs",
                      "news"
                    ],
                    "destination_type": "webhook",
                    "response_status_code": 200,
                    "status": "success",
                    "error_message": "",
                    "total_signals": 10,
                    "total_companies": 5,
                    "total_people": 12,
                    "trigger_credit": 8,
                    "total_company_credit": 5,
                    "total_people_credit": 12,
                    "redeem_email_credit": 0,
                    "redeem_phone_credit": 0,
                    "total_credit": 25,
                    "retry_attempt": 0,
                    "processing_time_ms": 45230,
                    "created_at": "2026-04-05T18:28:05.000Z",
                    "retry_logs": [],
                    "is_retry_succeed": false,
                    "request_payload": {},
                    "response_payload": {},
                    "attributes": {}
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_log_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor log entry to look up."
                  }
                },
                "required": [
                  "monitor_log_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_lookup_statistics_log",
        "summary": "Look up a monitor statistics log",
        "description": "Retrieve details of a specific monitor detection log entry.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/statistics/chart": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing chart data points for monitor trigger statistics over time.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "date_series": {
                            "type": "string",
                            "format": "date",
                            "description": "The date for this data point."
                          },
                          "total_triggers": {
                            "type": "integer",
                            "description": "Total number of triggers on this date."
                          },
                          "total_success": {
                            "type": "integer",
                            "description": "Total number of successful triggers on this date."
                          },
                          "total_failure": {
                            "type": "integer",
                            "description": "Total number of failed triggers on this date."
                          },
                          "total_credit": {
                            "type": "number",
                            "description": "Total credits consumed on this date."
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "date_series": "2026-04-01",
                      "total_triggers": 12,
                      "total_success": 11,
                      "total_failure": 1,
                      "total_credit": 236
                    },
                    {
                      "date_series": "2026-04-02",
                      "total_triggers": 8,
                      "total_success": 8,
                      "total_failure": 0,
                      "total_credit": 154
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Optional. Unique identifier of a monitor to scope the chart to. When omitted, the chart aggregates across all monitors in the workspace."
                  },
                  "start_date": {
                    "type": "string",
                    "format": "date",
                    "description": "Start date for chart range (YYYY-MM-DD)."
                  },
                  "end_date": {
                    "type": "string",
                    "format": "date",
                    "description": "End date for chart range (YYYY-MM-DD)."
                  }
                },
                "required": [
                  "start_date",
                  "end_date"
                ]
              }
            }
          }
        },
        "operationId": "monitors_get_statistics_chart",
        "summary": "Get monitor statistics chart data",
        "description": "Retrieve chart-ready time-series statistics data for a monitor.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/process/try": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the trigger execution results.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "unresolved": {
                          "type": "object",
                          "description": "Inputs no company answered to, per list sent in this request (`null` for a list not sent). Fix or drop them; the monitor was saved with the companies that did resolve.",
                          "properties": {
                            "companies": {
                              "type": "object",
                              "nullable": true,
                              "properties": {
                                "domains": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "linkedin_urls": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "excluded_companies": {
                              "type": "object",
                              "nullable": true,
                              "properties": {
                                "domains": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "linkedin_urls": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Identifier of the monitor that was triggered."
                        },
                        "status": {
                          "type": "string",
                          "description": "Status of the trigger execution."
                        },
                        "total_signals": {
                          "type": "integer",
                          "description": "Total number of signals detected."
                        },
                        "total_credit": {
                          "type": "integer",
                          "description": "Total credits consumed."
                        },
                        "empty_reason": {
                          "type": "string",
                          "enum": [
                            "no_matching_signals",
                            "already_delivered",
                            "company_dedupe_or_excluded",
                            "daily_records_used",
                            "empty_watch_list"
                          ],
                          "description": "Present only when the run delivered nothing, naming the rule that held it: `no_matching_signals` (nothing in the window matched the filters and company scope), `already_delivered` (every match was already delivered by this monitor), `company_dedupe_or_excluded` (the new matches all belong to companies inside `company_dedupe_days` or on the exclusion list), `daily_records_used` (today's `max_daily_records` budget is used, and a try of a saved monitor counts toward it; the monitor resumes tomorrow, or send `max_daily_records: 0` on the try), `empty_watch_list` (the company_first watch list holds no companies)."
                        },
                        "processing_time_ms": {
                          "type": "integer",
                          "description": "Total processing time in milliseconds."
                        },
                        "delivery_result": {
                          "type": "object",
                          "properties": {
                            "is_success": {
                              "type": "boolean",
                              "description": "Whether the delivery was successful."
                            },
                            "error_message": {
                              "type": "string",
                              "nullable": true,
                              "description": "Error message if delivery failed."
                            },
                            "response_status_code": {
                              "type": "integer",
                              "description": "HTTP status code from the destination."
                            },
                            "response_payload": {
                              "type": "string",
                              "description": "Response body from the destination."
                            },
                            "retry_attempt": {
                              "type": "integer",
                              "description": "Retry attempt number."
                            }
                          },
                          "description": "Details of the delivery result."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "status": "success",
                    "total_signals": 25,
                    "total_credit": 59,
                    "processing_time_ms": 99050,
                    "delivery_result": {
                      "is_success": true,
                      "error_message": null,
                      "response_status_code": 200,
                      "response_payload": "OK",
                      "retry_attempt": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Optional. Unique identifier of a saved monitor to trigger. Omit it to run an unsaved ad-hoc configuration passed inline."
                  },
                  "tried_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Timestamp to use as the scan reference point. Use a recent past date to ensure data availability for testing. Using current time may return 0 results."
                  },
                  "name": {
                    "type": "string",
                    "description": "Name for the run configuration."
                  },
                  "detection_mode": {
                    "type": "string",
                    "enum": [
                      "company_first",
                      "signal_first"
                    ],
                    "description": "Detection mode for the run."
                  },
                  "signal_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Signal types to scan (jobs, news, advertisements, expansions)."
                  },
                  "signal_filters": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Per-signal-type filter objects, same shape as Create Monitor. Any other shape (an object keyed by signal type, say) is refused with code `40037`; leave it out or send `[]` for no filters."
                  },
                  "company_filters": {
                    "type": "object",
                    "description": "Global company filters, same parameters as Company Search."
                  },
                  "companies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "Company domain_search_id UUIDs to scan."
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Company domains to scan — resolved to companies."
                  },
                  "linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    },
                    "description": "LinkedIn company URLs to scan — resolved to companies."
                  },
                  "is_company_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich company data in results."
                  },
                  "is_people_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich people data in results."
                  },
                  "people_enrichment_configs": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "People enrichment layers, same shape as Create Monitor."
                  },
                  "destination_type": {
                    "type": "string",
                    "enum": [
                      "webhook",
                      "email",
                      "sequences"
                    ],
                    "description": "Delivery destination type for the run."
                  },
                  "destination_config": {
                    "type": "object",
                    "description": "Destination configuration for the run, same shape as Create Monitor."
                  },
                  "max_records_per_trigger": {
                    "type": "integer",
                    "description": "Maximum records delivered by this run."
                  },
                  "excluded_companies": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Companies to exclude from this run (`domain_search_id` UUIDs); also `excluded_domains` / `excluded_linkedin_urls`.",
                    "example": [
                      "550e8400-e29b-41d4-a716-446655440002"
                    ]
                  },
                  "excluded_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Company domains to exclude (e.g. [\"existing-client.com\"]). Resolved to companies and merged into `excluded_companies`.",
                    "example": [
                      "existing-client.com"
                    ]
                  },
                  "excluded_linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "LinkedIn company URLs to exclude. Resolved to companies and merged into `excluded_companies`.",
                    "example": [
                      "https://linkedin.com/company/existing-client"
                    ]
                  },
                  "record_unit": {
                    "type": "string",
                    "enum": [
                      "signal",
                      "company"
                    ],
                    "description": "Record unit for this run: `signal` or `company`.",
                    "example": "company"
                  },
                  "company_dedupe_days": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Company dedupe window in days for this run (saved monitors only; reads the monitor's delivery history).",
                    "example": 30
                  },
                  "max_daily_records": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Daily record budget for this run (saved monitors only). Send `0` to lift the cap for this try; omit it to keep the monitor's own. A try counts toward the monitor's budget like a scheduled run."
                  },
                  "is_newest_first": {
                    "type": "boolean",
                    "description": "Deliver the freshest matching signals first. With a per-trigger or daily cap the newest records are kept and the monitor's cursor still moves to the newest fetched row, so older rows are skipped, never queued. Default `true` for a new monitor; send `false` for oldest first, nothing skipped.",
                    "example": true
                  }
                }
              }
            }
          }
        },
        "operationId": "monitors_process_try",
        "summary": "Try processing a monitor",
        "description": "Run a saved monitor by id, or run an unsaved ad-hoc configuration by passing the config inline; with monitor_id, inline fields override the saved monitor for this run.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/process/retry": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the retry execution results. The envelope is `{ metadata: { monitor_log_id, status }, data: {...} }`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "monitor_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "The monitor log entry that was retried."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "success",
                            "failure",
                            "skipped"
                          ],
                          "description": "Outcome of the retry. 'skipped' means the original trigger had already succeeded."
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "The monitor log entry that was retried."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "success",
                            "failure",
                            "skipped"
                          ],
                          "description": "Outcome of the retry."
                        },
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Identifier of the monitor."
                        },
                        "delivery_result": {
                          "type": "object",
                          "properties": {
                            "is_success": {
                              "type": "boolean",
                              "description": "Whether the delivery was successful."
                            },
                            "error_message": {
                              "type": "string",
                              "nullable": true,
                              "description": "Error message if delivery failed."
                            },
                            "response_status_code": {
                              "type": "integer",
                              "description": "HTTP status code from the destination."
                            },
                            "response_payload": {
                              "type": "string",
                              "description": "Response body from the destination."
                            },
                            "retry_attempt": {
                              "type": "integer",
                              "description": "Retry attempt number."
                            }
                          },
                          "description": "Details of the delivery result."
                        },
                        "total_credit": {
                          "type": "integer",
                          "description": "Total credits consumed."
                        },
                        "processing_time_ms": {
                          "type": "integer",
                          "description": "Total processing time in milliseconds."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "monitor_log_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
                    "status": "success"
                  },
                  "data": {
                    "monitor_log_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
                    "status": "success",
                    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "delivery_result": {
                      "is_success": true,
                      "error_message": null,
                      "response_status_code": 200,
                      "response_payload": "...",
                      "retry_attempt": 0
                    },
                    "total_credit": 59,
                    "processing_time_ms": 7541
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_log_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor log entry to retry."
                  },
                  "is_use_original_destination": {
                    "type": "boolean",
                    "description": "When true, uses the destination configuration snapshot from the original log entry instead of the current monitor config."
                  },
                  "is_use_original_payload": {
                    "type": "boolean",
                    "default": true,
                    "description": "When false, the retried payload is re-filtered by today's rules first: companies now on the exclusion list and records delivered since the first attempt are dropped, and a retry with nothing left is skipped (code 40085). Default true replays the first attempt's payload unchanged."
                  }
                },
                "required": [
                  "monitor_log_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_process_retry",
        "summary": "Retry processing a monitor",
        "description": "Retry a failed monitor processing run.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/signals/search": {
      "post": {
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "page_token": {
                    "type": "string",
                    "description": "`metadata.window.next_page_token` from a paged delivery or from the previous page. It carries the frozen window, so the same token always reads the same span; `null` on the last page means the window is done."
                  }
                },
                "required": [
                  "page_token"
                ]
              }
            }
          }
        },
        "operationId": "monitors_signals_search",
        "summary": "Search a paged delivery's signals",
        "description": "Read the next page of one paged delivery (`is_paged_delivery: true`). The window is frozen at the run: the page holds only signals of that window, under the monitor's current filters, company scope, exclusions and company dedupe window, in the delivery's order. Each page is one bounded keyset read, and is billed like the equivalent search (one search credit per signal type the page reads; watchlists are free). The page has the webhook payload's shape.",
        "tags": [
          "Monitor"
        ],
        "responses": {
          "200": {
            "description": "The page, in the webhook payload's shape plus the same `pagination` block every search returns. The envelope is `{ metadata: { monitor_log_id, page_token }, data: {...} }`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "monitor_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "The delivery this page belongs to (its Statistic Logs row)."
                        },
                        "page_token": {
                          "type": "string",
                          "description": "The token this page was read with."
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "description": "Same shape as the webhook payload: `monitor`, `metadata`, `triggered_at`, and `signals` (signal record unit) or `companies` (company record unit).",
                      "properties": {
                        "metadata": {
                          "type": "object",
                          "properties": {
                            "monitor_log_id": {
                              "type": "string",
                              "format": "uuid",
                              "description": "The delivery this page belongs to."
                            },
                            "total_signals": {
                              "type": "integer",
                              "description": "Signals on this page."
                            },
                            "total_companies": {
                              "type": "integer",
                              "description": "Companies on this page."
                            },
                            "window": {
                              "type": "object",
                              "properties": {
                                "from": {
                                  "type": "string",
                                  "format": "date-time",
                                  "description": "Start of the window (the previous run)."
                                },
                                "to": {
                                  "type": "string",
                                  "format": "date-time",
                                  "description": "End of the window (this run)."
                                },
                                "next_page_token": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Token for the next page; `null` on the last page."
                                }
                              }
                            }
                          }
                        },
                        "pagination": {
                          "$ref": "#/components/schemas/search_pagination"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "monitor_log_id": "516b72de-79d5-400b-9bae-423a43eca98b",
                    "page_token": "c2b1…"
                  },
                  "data": {
                    "monitor": {
                      "monitor_id": "c9cd5421-b327-4243-9cd7-8b341b3da8bd",
                      "name": "Weekly CFO hires",
                      "detection_mode": "signal_first",
                      "record_unit": "signal"
                    },
                    "metadata": {
                      "monitor_log_id": "516b72de-79d5-400b-9bae-423a43eca98b",
                      "parent_monitor_log_id": null,
                      "total_signals": 25,
                      "total_companies": 25,
                      "total_people": 0,
                      "window": {
                        "from": "2026-10-10T02:09:00.000Z",
                        "to": "2026-10-17T06:09:56.270Z",
                        "next_page_token": "eyJhbGciOi…"
                      }
                    },
                    "triggered_at": "2026-10-17T06:20:11.002Z",
                    "signals": [],
                    "pagination": {
                      "page": 2,
                      "per_page": 25,
                      "total_entries": 395,
                      "total_pages": 16,
                      "total_display_pages": 16,
                      "is_timeout": false,
                      "is_estimated": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/monitors": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing a paginated list of monitors. Watchlist-backed monitors are excluded from this list.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "pagination": {
                          "type": "object",
                          "properties": {
                            "page": {
                              "type": "integer",
                              "description": "Current page number."
                            },
                            "per_page": {
                              "type": "integer",
                              "description": "Number of results per page."
                            },
                            "total_entries": {
                              "type": "integer",
                              "description": "Total number of monitors."
                            },
                            "total_pages": {
                              "type": "integer",
                              "description": "Total number of pages."
                            },
                            "total_display_pages": {
                              "type": "integer",
                              "description": "Total number of display pages."
                            },
                            "is_timeout": {
                              "type": "boolean",
                              "description": "Whether the query timed out."
                            }
                          }
                        },
                        "monitors": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "monitor_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "Unique identifier for the monitor."
                              },
                              "name": {
                                "type": "string",
                                "description": "Name of the monitor."
                              },
                              "description": {
                                "type": "string",
                                "description": "Description of the monitor."
                              },
                              "detection_mode": {
                                "type": "string",
                                "description": "Detection mode: 'company_first' or 'signal_first'."
                              },
                              "signal_types": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Types of signals to monitor (e.g., 'jobs', 'news', 'advertisements')."
                              },
                              "signal_filters": {
                                "type": "object",
                                "description": "Filters applied to signals. Uses the same filter structure as the search endpoints."
                              },
                              "company_filters": {
                                "type": "object",
                                "description": "Filters applied to companies. Uses the same filter structure as the search endpoints."
                              },
                              "is_company_enrichment": {
                                "type": "boolean",
                                "description": "Whether to enrich company data in results."
                              },
                              "is_people_enrichment": {
                                "type": "boolean",
                                "description": "Whether to enrich people data in results."
                              },
                              "people_enrichment_configs": {
                                "type": "array",
                                "description": "Configuration for people enrichment, including filters and limits.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "max_people_to_return": {
                                      "type": "integer",
                                      "description": "Maximum number of people to return per company. Min: 1, Max: 25."
                                    }
                                  }
                                }
                              },
                              "destination_type": {
                                "type": "string",
                                "description": "Delivery destination type (e.g., 'email', 'webhook')."
                              },
                              "destination_config": {
                                "type": "object",
                                "description": "Configuration for the delivery destination (e.g., webhook URL, email address)."
                              },
                              "frequency_minute": {
                                "type": "integer",
                                "description": "Trigger frequency in minutes. Min: 0, Max: 10080, Default: 0."
                              },
                              "max_retry_per_trigger": {
                                "type": "integer",
                                "description": "Maximum retries per trigger. Min: 0, Max: 3, Default: 1."
                              },
                              "max_records_per_trigger": {
                                "type": "integer",
                                "description": "Maximum records per trigger. Min: 1, Max: 100, Default: 25."
                              },
                              "retry_delay_second": {
                                "type": "integer",
                                "description": "Delay between retries in seconds. Min: 1, Max: 5, Default: 1."
                              },
                              "max_daily_trigger": {
                                "type": "integer",
                                "description": "Maximum triggers per day. Min: 0, Max: 86400, Default: 500."
                              },
                              "company_count": {
                                "type": "integer"
                              },
                              "excluded_company_count": {
                                "type": "integer"
                              },
                              "record_unit": {
                                "type": "string",
                                "nullable": true,
                                "enum": [
                                  "signal",
                                  "company"
                                ]
                              },
                              "company_dedupe_days": {
                                "type": "integer"
                              },
                              "is_newest_first": {
                                "type": "boolean"
                              },
                              "is_paged_delivery": {
                                "type": "boolean"
                              },
                              "max_daily_records": {
                                "type": "integer"
                              },
                              "max_failure_trigger": {
                                "type": "integer",
                                "description": "Maximum consecutive failures before pausing. Min: 1, Max: 10, Default: 5."
                              },
                              "masked_signature": {
                                "type": "string",
                                "description": "Masked webhook signature for display purposes."
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "draft",
                                  "active",
                                  "paused",
                                  "inactive"
                                ],
                                "description": "Lifecycle status of the monitor."
                              },
                              "notification_email": {
                                "type": "string",
                                "description": "Email address for monitor notifications."
                              },
                              "repeated_failure_count": {
                                "type": "integer",
                                "description": "Current count of repeated consecutive failures."
                              },
                              "last_trigger_at": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true,
                                "description": "Timestamp of the last trigger."
                              },
                              "last_processed_at": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true,
                                "description": "Timestamp of the last completed processing."
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Timestamp when the monitor was created."
                              },
                              "last_modified": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Timestamp when the monitor was last modified."
                              },
                              "user": {
                                "type": "object",
                                "properties": {
                                  "user_id": {
                                    "type": "string",
                                    "description": "Identifier of the user who created the monitor."
                                  },
                                  "nickname": {
                                    "type": "string",
                                    "description": "Display name of the user."
                                  },
                                  "email": {
                                    "type": "string",
                                    "description": "Email of the user."
                                  }
                                },
                                "description": "User who created the monitor."
                              },
                              "total_trigger_today": {
                                "type": "integer",
                                "description": "Number of triggers executed today."
                              },
                              "success_rate": {
                                "type": "string",
                                "nullable": true,
                                "description": "Overall success rate (0 to 1) as a decimal string, e.g. \"0.983\". Null when the monitor has never triggered."
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 8,
                      "total_pages": 1,
                      "total_display_pages": 1,
                      "is_timeout": false
                    },
                    "monitors": [
                      {
                        "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                        "name": "Company First Monitor",
                        "description": null,
                        "detection_mode": "company_first",
                        "signal_types": [
                          "jobs",
                          "news",
                          "advertisements"
                        ],
                        "signal_filters": [
                          {
                            "filters": {
                              "locations": [
                                "US"
                              ]
                            },
                            "signal_type": "jobs"
                          },
                          {
                            "filters": {
                              "locations": [
                                "US"
                              ]
                            },
                            "signal_type": "news"
                          },
                          {
                            "filters": {
                              "target_locations": [
                                "US"
                              ]
                            },
                            "signal_type": "advertisements"
                          }
                        ],
                        "company_filters": {
                          "locations": [
                            "US"
                          ]
                        },
                        "is_company_enrichment": true,
                        "is_people_enrichment": true,
                        "people_enrichment_configs": [
                          {
                            "filters": {
                              "people_locations": [
                                "US"
                              ]
                            },
                            "max_people_to_return": 3,
                            "people_contact_types": [
                              "email-work"
                            ]
                          }
                        ],
                        "destination_type": "webhook",
                        "destination_config": {
                          "webhook_url": "https://usewebhook.com/example",
                          "headers": {
                            "X-Custom-Auth": "your-token"
                          },
                          "body": {
                            "source": "pubrio"
                          }
                        },
                        "notification_email": "team@example.com",
                        "max_retry_per_trigger": 1,
                        "retry_delay_second": 1,
                        "max_records_per_trigger": 25,
                        "max_daily_trigger": 500,
                        "company_count": 1,
                        "excluded_company_count": 0,
                        "record_unit": null,
                        "company_dedupe_days": 0,
                        "is_newest_first": false,
                        "max_daily_records": 0,
                        "frequency_minute": 0,
                        "status": "active",
                        "max_failure_trigger": 5,
                        "repeated_failure_count": 0,
                        "last_trigger_at": "2026-04-05T22:29:36.349Z",
                        "last_processed_at": "2026-04-05T18:28:05.715Z",
                        "masked_signature": "9••••••••••••••••f09",
                        "created_at": "2026-04-03T18:49:20.048Z",
                        "last_modified": "2026-04-05T22:29:36.349Z",
                        "user": {
                          "user_id": "a1b2c3d4-0000-0000-0000-000000000000",
                          "nickname": "Jane Smith",
                          "email": "jane@example.com"
                        },
                        "total_trigger_today": 4,
                        "success_rate": "1.000"
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "destination_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by destination types (e.g., ['email', 'webhook']). Empty array returns all."
                  },
                  "detection_modes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by detection modes (e.g., ['company_first', 'signal_first']). Empty array returns all."
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "active",
                      "paused",
                      "inactive"
                    ],
                    "description": "Filter by monitor status."
                  },
                  "is_ascending_order": {
                    "type": "boolean",
                    "description": "Sort in ascending order. Defaults to false (descending).",
                    "default": false
                  },
                  "order_by": {
                    "type": "string",
                    "enum": [
                      "name",
                      "last_trigger_at",
                      "last_modified"
                    ],
                    "description": "Field to sort by. Accepted values: 'name', 'last_trigger_at', 'last_modified'. When omitted, the list is ordered by created_at descending."
                  },
                  "search_term": {
                    "type": "string",
                    "nullable": true,
                    "description": "Search term matched against the monitor name only (regular expression, case-insensitive)."
                  },
                  "per_page": {
                    "type": "integer",
                    "description": "Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.",
                    "default": 25
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.",
                    "default": 1
                  }
                }
              }
            }
          }
        },
        "operationId": "monitors_list",
        "summary": "List monitors",
        "description": "Retrieve a list of all monitors in the workspace.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/create": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the newly created monitor details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "unresolved": {
                          "type": "object",
                          "description": "Inputs no company answered to, per list sent in this request (`null` for a list not sent). Fix or drop them; the monitor was saved with the companies that did resolve.",
                          "properties": {
                            "companies": {
                              "type": "object",
                              "nullable": true,
                              "properties": {
                                "domains": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "linkedin_urls": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "excluded_companies": {
                              "type": "object",
                              "nullable": true,
                              "properties": {
                                "domains": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "linkedin_urls": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for the newly created monitor."
                        },
                        "name": {
                          "type": "string",
                          "description": "Name of the monitor."
                        },
                        "description": {
                          "type": "string",
                          "description": "Description of the monitor."
                        },
                        "detection_mode": {
                          "type": "string",
                          "description": "Detection mode: 'company_first' or 'signal_first'."
                        },
                        "signal_types": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Signal types this monitor watches."
                        },
                        "signal_filters": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Per-signal-type filters, as stored. When you create with `query`, this is what your sentence was interpreted into — check it to confirm the monitor watches what you meant."
                        },
                        "company_filters": {
                          "type": "object",
                          "description": "Company-profile filters applied to every matched signal."
                        },
                        "company_count": {
                          "type": "integer"
                        },
                        "is_company_enrichment": {
                          "type": "boolean",
                          "description": "Whether matches are enriched with company details."
                        },
                        "is_people_enrichment": {
                          "type": "boolean",
                          "description": "Whether matches are enriched with people and contacts."
                        },
                        "people_enrichment_configs": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "People enrichment settings, as stored."
                        },
                        "destination_type": {
                          "type": "string",
                          "description": "Delivery destination type."
                        },
                        "destination_config": {
                          "type": "object",
                          "description": "Delivery destination details (emails, or webhook URL)."
                        },
                        "frequency_minute": {
                          "type": "integer",
                          "description": "How often the monitor runs, in minutes."
                        },
                        "notification_email": {
                          "type": "string",
                          "nullable": true,
                          "description": "Address notified about the monitor itself."
                        },
                        "max_retry_per_trigger": {
                          "type": "integer",
                          "description": "Retries allowed per trigger."
                        },
                        "retry_delay_second": {
                          "type": "integer",
                          "description": "Delay between retries, in seconds."
                        },
                        "max_records_per_trigger": {
                          "type": "integer",
                          "description": "Maximum records delivered per trigger."
                        },
                        "max_daily_trigger": {
                          "type": "integer",
                          "description": "Maximum triggers per day."
                        },
                        "max_failure_trigger": {
                          "type": "integer",
                          "description": "Consecutive failures before the monitor stops."
                        },
                        "excluded_company_count": {
                          "type": "integer"
                        },
                        "record_unit": {
                          "type": "string",
                          "nullable": true,
                          "enum": [
                            "signal",
                            "company"
                          ]
                        },
                        "company_dedupe_days": {
                          "type": "integer"
                        },
                        "max_daily_records": {
                          "type": "integer"
                        },
                        "is_newest_first": {
                          "type": "boolean"
                        },
                        "is_paged_delivery": {
                          "type": "boolean"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "draft",
                            "active",
                            "paused",
                            "inactive"
                          ],
                          "description": "Lifecycle status the monitor was created with."
                        },
                        "masked_signature": {
                          "type": "string",
                          "description": "Masked webhook signature for display."
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp when the monitor was created."
                        },
                        "signature": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Webhook signature for verifying payloads. Only returned on creation."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "monitor_id": "c9cd5421-b327-4243-9cd7-8b341b3da8bd",
                    "name": "Expansion signals → JP",
                    "description": null,
                    "detection_mode": "signal_first",
                    "signal_types": [
                      "expansions"
                    ],
                    "signal_filters": [
                      {
                        "signal_type": "expansions",
                        "filters": {
                          "tos": [
                            "JP"
                          ]
                        }
                      }
                    ],
                    "company_filters": {},
                    "company_count": 0,
                    "is_company_enrichment": false,
                    "is_people_enrichment": true,
                    "people_enrichment_configs": [
                      {
                        "max_people_to_return": 5,
                        "filters": {
                          "management_levels": [
                            "c_suite"
                          ]
                        },
                        "people_contact_types": [
                          "email-work"
                        ]
                      }
                    ],
                    "destination_type": "email",
                    "destination_config": {
                      "emails": [
                        "me@company.com"
                      ]
                    },
                    "frequency_minute": 5,
                    "notification_email": null,
                    "max_retry_per_trigger": 3,
                    "retry_delay_second": 60,
                    "max_records_per_trigger": 100,
                    "max_daily_trigger": 24,
                    "max_failure_trigger": 5,
                    "excluded_company_count": 0,
                    "record_unit": null,
                    "company_dedupe_days": 0,
                    "max_daily_records": 0,
                    "is_newest_first": false,
                    "status": "active",
                    "masked_signature": "5••••••••••••••8b8",
                    "created_at": "2026-07-16T10:27:40.469Z",
                    "signature": "52209a0d-f1c8-4111-a685-ac86edc678b8"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Name of the monitor."
                  },
                  "description": {
                    "type": "string",
                    "description": "Description of the monitor."
                  },
                  "status": {
                    "type": "string",
                    "description": "Lifecycle status to create the monitor with. Defaults to `active`. Use `draft` to save a half-built monitor: only `name` is required, validation is deferred until you activate it, and a draft never runs.",
                    "enum": [
                      "draft",
                      "active",
                      "paused",
                      "inactive"
                    ],
                    "default": "active"
                  },
                  "detection_mode": {
                    "type": "string",
                    "description": "How signals are detected. `signal_first` scans the market broadly; `company_first` tracks a named account list and requires at least one company, domain or LinkedIn URL. **Immutable after creation** — changing it on an existing monitor returns `40021`. Create a new monitor instead.",
                    "enum": [
                      "company_first",
                      "signal_first"
                    ]
                  },
                  "signal_types": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "jobs",
                        "news",
                        "advertisements",
                        "expansions",
                        "cloud_footprints"
                      ]
                    },
                    "description": "Types of signals to monitor."
                  },
                  "signal_filters": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "signal_type"
                      ],
                      "properties": {
                        "signal_type": {
                          "type": "string",
                          "enum": [
                            "jobs",
                            "news",
                            "advertisements",
                            "expansions",
                            "cloud_footprints"
                          ],
                          "description": "Which stream this entry filters."
                        },
                        "filters": {
                          "type": "object",
                          "description": "Filters for this stream. `jobs`, `news` and `advertisements` take the parameters of [Job Search](/en/api-reference/endpoint/companies/job_search), [News Search](/en/api-reference/endpoint/companies/news_search) and [Advertisement Search](/en/api-reference/endpoint/companies/advertisements_search). `expansions` takes the [Expansion Search](/en/api-reference/endpoint/expansions/market_lookup) vocabulary: `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Resolve slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types)."
                        }
                      }
                    },
                    "description": "One entry per signal stream the monitor watches. Any other shape (an object keyed by signal type, say) is refused with code `40037`; leave it out or send `[]` for no filters.",
                    "example": [
                      {
                        "signal_type": "jobs",
                        "filters": {
                          "locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "news",
                        "filters": {
                          "locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "advertisements",
                        "filters": {
                          "target_locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "expansions",
                        "filters": {
                          "tos": [
                            "US"
                          ],
                          "stages": [
                            "expanding",
                            "scaling"
                          ],
                          "signal_types": [
                            "HIRE",
                            "EXEC"
                          ],
                          "signal_strengths": [
                            "high",
                            "very_high"
                          ]
                        }
                      }
                    ]
                  },
                  "company_filters": {
                    "type": "object",
                    "description": "Global company filters applied as a second layer across all signal types. Accepts the same parameters as the [Company Search](/en/api-reference/endpoint/companies/search) endpoint — locations, employees, technologies, verticals, and more.",
                    "example": {
                      "locations": [
                        "US"
                      ],
                      "employees": [
                        [
                          501,
                          1000
                        ],
                        [
                          1001,
                          5000
                        ]
                      ]
                    }
                  },
                  "companies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "List of company domain_search_id UUIDs to monitor. Used primarily in company_first mode to specify target companies. You can also use `domains` or `linkedin_urls` as alternatives — only one of the three is required."
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of company domains to monitor (e.g., [\"openai.com\", \"google.com\"]). Alternative to `companies` — Pubrio resolves these to the corresponding companies. Only one of `companies`, `domains`, or `linkedin_urls` is required."
                  },
                  "linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    },
                    "description": "List of LinkedIn company URLs to monitor (e.g., [\"https://linkedin.com/company/pubrio\"]). Alternative to `companies` — Pubrio resolves these to the corresponding companies. Only one of `companies`, `domains`, or `linkedin_urls` is required."
                  },
                  "is_company_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich company data in results."
                  },
                  "is_people_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich people data in results."
                  },
                  "people_enrichment_configs": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Array of people enrichment layers. Each layer runs an independent people search. Contains `max_people_to_return` (1-25), `people_contact_types` (array — refers to [Redeem](/en/api-reference/endpoint/redeem/people) contact types: email-work, email-personal, phone), and `filters` (same parameters as [People Search](/en/api-reference/endpoint/people/search) endpoint).",
                    "example": [
                      {
                        "filters": {
                          "people_locations": [
                            "US"
                          ]
                        },
                        "max_people_to_return": 3,
                        "people_contact_types": [
                          "email-work"
                        ]
                      }
                    ]
                  },
                  "destination_type": {
                    "type": "string",
                    "description": "Delivery destination type.",
                    "enum": [
                      "webhook",
                      "email",
                      "sequences"
                    ]
                  },
                  "destination_config": {
                    "type": "object",
                    "description": "Configuration for the destination. For webhook: requires `webhook_url` (string), optional `headers` (object) and `body` (object). For email: accepts `email` (string) or `emails` (array of strings). For sequences: requires `sequence_identifier` (string) plus at least one of `is_people_search_enrolled` / `is_company_contact_enrolled` set to true.",
                    "example": {
                      "webhook_url": "https://your-webhook.com/endpoint",
                      "headers": {
                        "Authorization": "Bearer token"
                      },
                      "body": {
                        "pipeline": "my-webhook"
                      }
                    }
                  },
                  "frequency_minute": {
                    "type": "integer",
                    "description": "Trigger frequency in minutes. Min: 0, Max: 10080, Default: 0.",
                    "minimum": 0,
                    "maximum": 10080,
                    "default": 0
                  },
                  "max_failure_trigger": {
                    "type": "integer",
                    "description": "Maximum consecutive failures before pausing the monitor. Min: 1, Max: 10, Default: 5.",
                    "minimum": 1,
                    "maximum": 10,
                    "default": 5
                  },
                  "max_daily_trigger": {
                    "type": "integer",
                    "description": "Maximum triggers per day. Min: 0, Max: 86400, Default: 500.",
                    "minimum": 0,
                    "maximum": 86400,
                    "default": 500
                  },
                  "max_records_per_trigger": {
                    "type": "integer",
                    "description": "Controls the maximum number of records delivered per trigger. Lower values reduce payload size per delivery, which is recommended for large result sets or rate-limited integrations. Min: 1, Max: 100, Default: 25. See [Setting up Webhooks](/en/developer-guides/setting-up-webhooks) for guidance.",
                    "minimum": 1,
                    "maximum": 100,
                    "default": 25
                  },
                  "excluded_companies": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Companies this monitor never delivers or bills, as `domain_search_id` UUIDs. Applied in both detection modes at run time, before enrichment and billing; a company on both `companies` and this list is excluded while it stays on the list. Max list size: 100,000 (resolved ids across `excluded_companies`, `excluded_domains` and `excluded_linkedin_urls`).",
                    "example": [
                      "550e8400-e29b-41d4-a716-446655440002"
                    ]
                  },
                  "excluded_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Company domains to exclude (e.g. [\"existing-client.com\"]). Resolved to companies and merged into `excluded_companies`.",
                    "example": [
                      "existing-client.com"
                    ]
                  },
                  "excluded_linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "LinkedIn company URLs to exclude. Resolved to companies and merged into `excluded_companies`.",
                    "example": [
                      "https://linkedin.com/company/existing-client"
                    ]
                  },
                  "record_unit": {
                    "type": "string",
                    "enum": [
                      "signal",
                      "company"
                    ],
                    "description": "What one delivered record is: `signal` (payload `signals[]`, one entry per signal) or `company` (payload `companies[]`, one entry per company with its signals nested). Default follows `detection_mode`: `signal_first` → `signal`, `company_first` → `company`. Caps (`max_records_per_trigger`, `max_daily_records`) count this unit.",
                    "example": "company"
                  },
                  "company_dedupe_days": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "A company appears in at most one delivery per this many days, across all the monitor's signal types; a company delivered inside the window is left out of later deliveries and its later signals in the window are skipped, not queued. `0` = off. Default: 0.",
                    "example": 30
                  },
                  "is_newest_first": {
                    "type": "boolean",
                    "description": "Deliver the freshest matching signals first. With a per-trigger or daily cap the newest records are kept and the monitor's cursor still moves to the newest fetched row, so older rows are skipped, never queued. Default `true` for a new monitor; send `false` for oldest first, nothing skipped. With `is_paged_delivery`, it only sets the page order: page 1 holds the newest of the window, and nothing is skipped.",
                    "example": true
                  },
                  "is_paged_delivery": {
                    "type": "boolean",
                    "description": "One delivery per run, covering only the signals that arrived since the last run. The delivery carries page 1 (up to `max_records_per_trigger`), the window's total in `pagination.total_entries` (the same `pagination` block every search returns) and a `metadata.window.next_page_token`; pull the rest with [Signals Search](/en/api-reference/endpoint/monitors/signals_search). Nothing is carried over to the next run. Jobs, news, advertisements and cloud footprints only: a monitor holding expansion signals is refused with code `40086`. Default `false` (overflow carried over to the next run).",
                    "example": true
                  },
                  "max_daily_records": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Hard cap on records delivered per calendar day in the owner's timezone (`0` = unlimited). Counted in the monitor's record unit over successful deliveries; a trigger delivers at most the remaining budget, then the monitor waits for the next day without moving its cursor. Default: 0.",
                    "example": 200
                  },
                  "notification_email": {
                    "type": "string",
                    "format": "email",
                    "description": "Email address for monitor failure notifications."
                  },
                  "max_retry_per_trigger": {
                    "type": "integer",
                    "description": "Maximum retries per trigger. Min: 0, Max: 3, Default: 1.",
                    "minimum": 0,
                    "maximum": 3,
                    "default": 1
                  },
                  "retry_delay_second": {
                    "type": "integer",
                    "description": "Delay between retries in seconds. Min: 1, Max: 5, Default: 1.",
                    "minimum": 1,
                    "maximum": 5,
                    "default": 1
                  },
                  "query": {
                    "type": "string",
                    "maxLength": 2000,
                    "description": "A natural-language description of the monitor (any language), e.g. \"monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time\". It is interpreted into the fields below (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute) in the same request. Any field you also pass explicitly overrides the interpreted value. If the text is not a monitor request, the call returns 400. Capped at 2000 characters."
                  },
                  "deep": {
                    "type": "boolean",
                    "description": "Optional, only used with `query`. Run the reflection pass for higher interpretation accuracy (default true; roughly doubles the interpretation latency). Set false for a faster single pass."
                  }
                },
                "anyOf": [
                  {
                    "title": "Natural language",
                    "required": [
                      "query"
                    ]
                  },
                  {
                    "title": "Structured fields",
                    "required": [
                      "name",
                      "detection_mode",
                      "signal_types",
                      "destination_type",
                      "destination_config"
                    ]
                  },
                  {
                    "title": "Draft",
                    "required": [
                      "name",
                      "status"
                    ]
                  }
                ]
              }
            }
          }
        },
        "operationId": "monitors_create",
        "summary": "Create a monitor",
        "description": "Create a data monitor: an always-on watch that continuously surfaces the business signals you care about — new job postings, news, advertisements, or market-expansion moves — from the companies and filters you define, enriches each match with company and contact data, and delivers it to your destination (email or webhook) on your chosen schedule. Configure it field by field, or describe the whole monitor in one plain-language sentence with `query` and it is interpreted into the configuration within the same request.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/interpret": {
      "post": {
        "operationId": "interpretMonitor",
        "summary": "Interpret a monitor from natural language",
        "description": "Preview a monitor before you build it — turn a plain-language request (in any language) into a validated **draft** configuration you can inspect, adjust, and then submit to [Create Monitor](/en/api-reference/endpoint/monitors/create). It's safe to call as often as you need: it only drafts, and never persists a monitor, sends alerts, or spends credits. Use `intent` to choose the action; if omitted, an English keyword heuristic is applied and unrecognised input defaults to `create_monitor`.",
        "tags": [
          "Monitor"
        ],
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "maxLength": 2000,
                    "description": "The natural-language request (any language), e.g. \"monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time\". Capped at 2000 characters."
                  },
                  "intent": {
                    "type": "string",
                    "enum": [
                      "create_monitor",
                      "dry_test",
                      "execute",
                      "analyze"
                    ],
                    "description": "Which action to take (language-agnostic). `create_monitor` (default): return a draft config. `dry_test`: draft plus a read-only count of currently matching signals. `execute`: draft plus preview, flagged for confirmation (never auto-activates). `analyze` (e.g. \"which market, SG or JP?\"): answered by the expansion analytical agent instead of building a monitor. If omitted, an English keyword heuristic is used; unrecognised input defaults to `create_monitor`."
                  },
                  "deep": {
                    "type": "boolean",
                    "description": "Run the reflection pass for higher accuracy (default true; roughly doubles latency). Set false for a faster single-pass interpretation."
                  }
                }
              },
              "example": {
                "query": "monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The interpreted draft. Nothing is persisted.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "intent": {
                          "type": "string",
                          "enum": [
                            "create_monitor",
                            "dry_test",
                            "execute",
                            "analyze"
                          ],
                          "description": "The resolved action (create_monitor / dry_test / execute / analyze)."
                        },
                        "no_intent": {
                          "type": "boolean",
                          "description": "true when the request was not a monitor setup (a greeting, off-topic, or nonsense); `config` is then null."
                        },
                        "config": {
                          "type": "object",
                          "nullable": true,
                          "description": "The draft monitor configuration, shaped exactly like the [Create Monitor](/en/api-reference/endpoint/monitors/create) request body (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute, status \"draft\", and so on). Submit it to Create Monitor to activate. It may also carry `domains`/`linkedin_urls`/`company_names`, which Create Monitor resolves to companies. Null when `no_intent` is true."
                        },
                        "missing_fields": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Fields still required before the monitor can be activated (e.g. \"destination\", \"signal_types\", \"companies\"). Collect these in your UI before submitting to Create Monitor."
                        },
                        "requires_confirmation": {
                          "type": "boolean",
                          "description": "true for the `execute` intent — the config is ready but the user must confirm before you activate it."
                        },
                        "preview": {
                          "type": "object",
                          "nullable": true,
                          "description": "Present for `dry_test` and `execute`: a read-only estimate of how many signals currently match, per signal type, over the last 30 days (sampled). No credits are spent."
                        },
                        "interpretation": {
                          "type": "object",
                          "description": "Echo of the raw fields extracted from the query, for display or debugging."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "intent": "create_monitor",
                    "no_intent": false,
                    "config": {
                      "detection_mode": "signal_first",
                      "signal_types": [
                        "expansions"
                      ],
                      "signal_filters": [
                        {
                          "signal_type": "expansions",
                          "filters": {
                            "tos": [
                              "JP"
                            ],
                            "stages": [
                              "exploring",
                              "committing"
                            ]
                          }
                        }
                      ],
                      "company_filters": {},
                      "companies": [],
                      "is_company_enrichment": false,
                      "is_people_enrichment": true,
                      "people_enrichment_configs": [
                        {
                          "max_people_to_return": 5,
                          "filters": {
                            "management_levels": [
                              "c_suite"
                            ]
                          },
                          "people_contact_types": [
                            "email-work"
                          ]
                        }
                      ],
                      "name": "Expansion signals → JP",
                      "destination_type": "email",
                      "destination_config": {
                        "emails": [
                          "me@company.com"
                        ]
                      },
                      "frequency_minute": 5,
                      "status": "draft"
                    },
                    "missing_fields": [],
                    "requires_confirmation": false,
                    "preview": null,
                    "interpretation": {
                      "signal_types": [
                        "expansions"
                      ],
                      "tos": [
                        "JP"
                      ],
                      "management_levels": [
                        "c_suite"
                      ],
                      "people_contact_types": [
                        "email-work"
                      ],
                      "destination_email": "me@company.com",
                      "is_realtime": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/monitors/update": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the updated monitor. The response always includes monitor_id, name, detection_mode, destination_type, status, masked_signature, and last_modified, plus any other columns that were part of the update.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "unresolved": {
                          "type": "object",
                          "description": "Inputs no company answered to, per list sent in this request (`null` for a list not sent). Fix or drop them; the monitor was saved with the companies that did resolve.",
                          "properties": {
                            "companies": {
                              "type": "object",
                              "nullable": true,
                              "properties": {
                                "domains": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "linkedin_urls": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "excluded_companies": {
                              "type": "object",
                              "nullable": true,
                              "properties": {
                                "domains": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "linkedin_urls": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for the monitor."
                        },
                        "name": {
                          "type": "string",
                          "description": "Name of the monitor."
                        },
                        "detection_mode": {
                          "type": "string",
                          "description": "Detection mode."
                        },
                        "destination_type": {
                          "type": "string",
                          "description": "Delivery destination type."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "draft",
                            "active",
                            "paused",
                            "inactive"
                          ],
                          "description": "Lifecycle status of the monitor."
                        },
                        "masked_signature": {
                          "type": "string",
                          "description": "Masked webhook signature."
                        },
                        "last_modified": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp when the monitor was last modified."
                        },
                        "company_count": {
                          "type": "integer"
                        },
                        "excluded_company_count": {
                          "type": "integer"
                        }
                      },
                      "description": "The updated monitor. Any other columns included in the update are also returned."
                    }
                  }
                },
                "example": {
                  "data": {
                    "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
                    "name": "Updated Monitor Name",
                    "detection_mode": "company_first",
                    "destination_type": "webhook",
                    "status": "active",
                    "masked_signature": "9••••••••••••••••f09",
                    "last_modified": "2026-04-05T21:00:00.000Z",
                    "company_count": 1,
                    "excluded_company_count": 0
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor to update."
                  },
                  "name": {
                    "type": "string",
                    "description": "Name of the monitor."
                  },
                  "description": {
                    "type": "string",
                    "description": "Description of the monitor."
                  },
                  "detection_mode": {
                    "type": "string",
                    "description": "How signals are detected. `signal_first` scans the market broadly; `company_first` tracks a named account list and requires at least one company, domain or LinkedIn URL. **Immutable after creation** — changing it on an existing monitor returns `40021`. Create a new monitor instead.",
                    "enum": [
                      "company_first",
                      "signal_first"
                    ]
                  },
                  "signal_types": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "jobs",
                        "news",
                        "advertisements",
                        "expansions",
                        "cloud_footprints"
                      ]
                    },
                    "description": "Types of signals to monitor."
                  },
                  "signal_filters": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "signal_type"
                      ],
                      "properties": {
                        "signal_type": {
                          "type": "string",
                          "enum": [
                            "jobs",
                            "news",
                            "advertisements",
                            "expansions",
                            "cloud_footprints"
                          ],
                          "description": "Which stream this entry filters."
                        },
                        "filters": {
                          "type": "object",
                          "description": "Filters for this stream. `jobs`, `news` and `advertisements` take the parameters of [Job Search](/en/api-reference/endpoint/companies/job_search), [News Search](/en/api-reference/endpoint/companies/news_search) and [Advertisement Search](/en/api-reference/endpoint/companies/advertisements_search). `expansions` takes the [Expansion Search](/en/api-reference/endpoint/expansions/market_lookup) vocabulary: `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Resolve slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types)."
                        }
                      }
                    },
                    "description": "One entry per signal stream the monitor watches. Any other shape (an object keyed by signal type, say) is refused with code `40037`; leave it out or send `[]` for no filters.",
                    "example": [
                      {
                        "signal_type": "jobs",
                        "filters": {
                          "locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "news",
                        "filters": {
                          "locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "advertisements",
                        "filters": {
                          "target_locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "expansions",
                        "filters": {
                          "tos": [
                            "US"
                          ],
                          "stages": [
                            "expanding",
                            "scaling"
                          ],
                          "signal_types": [
                            "HIRE",
                            "EXEC"
                          ],
                          "signal_strengths": [
                            "high",
                            "very_high"
                          ]
                        }
                      }
                    ]
                  },
                  "company_filters": {
                    "type": "object",
                    "description": "Global company filters applied as a second layer across all signal types. Accepts the same parameters as the [Company Search](/en/api-reference/endpoint/companies/search) endpoint — locations, employees, technologies, verticals, and more.",
                    "example": {
                      "locations": [
                        "US"
                      ],
                      "employees": [
                        [
                          501,
                          1000
                        ],
                        [
                          1001,
                          5000
                        ]
                      ]
                    }
                  },
                  "companies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "List of company domain_search_id UUIDs. Alternative: use `domains` or `linkedin_urls`."
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of company domains. Alternative to `companies`."
                  },
                  "linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    },
                    "description": "List of LinkedIn company URLs. Alternative to `companies`."
                  },
                  "is_company_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich company data."
                  },
                  "is_people_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich people data."
                  },
                  "people_enrichment_configs": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Array of people enrichment layers. Each layer runs an independent people search. Contains `max_people_to_return` (1-25), `people_contact_types` (array — refers to [Redeem](/en/api-reference/endpoint/redeem/people) contact types: email-work, email-personal, phone), and `filters` (same parameters as [People Search](/en/api-reference/endpoint/people/search) endpoint).",
                    "example": [
                      {
                        "filters": {
                          "people_locations": [
                            "US"
                          ]
                        },
                        "max_people_to_return": 3,
                        "people_contact_types": [
                          "email-work"
                        ]
                      }
                    ]
                  },
                  "destination_type": {
                    "type": "string",
                    "description": "Delivery destination type.",
                    "enum": [
                      "webhook",
                      "email",
                      "sequences"
                    ]
                  },
                  "destination_config": {
                    "type": "object",
                    "description": "Configuration for the destination. For webhook: requires `webhook_url` (string), optional `headers` (object) and `body` (object). For email: accepts `email` (string) or `emails` (array of strings). For sequences: requires `sequence_identifier` (string) plus at least one of `is_people_search_enrolled` / `is_company_contact_enrolled` set to true.",
                    "example": {
                      "webhook_url": "https://your-webhook.com/endpoint",
                      "headers": {
                        "Authorization": "Bearer token"
                      },
                      "body": {
                        "pipeline": "my-webhook"
                      }
                    }
                  },
                  "frequency_minute": {
                    "type": "integer",
                    "description": "Trigger frequency in minutes. Min: 0, Max: 10080, Default: 0.",
                    "minimum": 0,
                    "maximum": 10080
                  },
                  "max_failure_trigger": {
                    "type": "integer",
                    "description": "Maximum consecutive failures before pausing. Min: 1, Max: 10, Default: 5.",
                    "minimum": 1,
                    "maximum": 10
                  },
                  "max_daily_trigger": {
                    "type": "integer",
                    "description": "Maximum triggers per day. Min: 0, Max: 86400, Default: 500.",
                    "minimum": 0,
                    "maximum": 86400
                  },
                  "max_records_per_trigger": {
                    "type": "integer",
                    "description": "Controls the maximum number of records delivered per trigger. Lower values reduce payload size per delivery, which is recommended for large result sets or rate-limited integrations. Min: 1, Max: 100, Default: 25. See [Setting up Webhooks](/en/developer-guides/setting-up-webhooks) for guidance.",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "excluded_companies": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Companies this monitor never delivers or bills, as `domain_search_id` UUIDs. Applied in both detection modes at run time, before enrichment and billing; a company on both `companies` and this list is excluded while it stays on the list. Max list size: 100,000 (resolved ids across `excluded_companies`, `excluded_domains` and `excluded_linkedin_urls`).",
                    "example": [
                      "550e8400-e29b-41d4-a716-446655440002"
                    ]
                  },
                  "excluded_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Company domains to exclude (e.g. [\"existing-client.com\"]). Resolved to companies and merged into `excluded_companies`.",
                    "example": [
                      "existing-client.com"
                    ]
                  },
                  "excluded_linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "LinkedIn company URLs to exclude. Resolved to companies and merged into `excluded_companies`.",
                    "example": [
                      "https://linkedin.com/company/existing-client"
                    ]
                  },
                  "companies_mode": {
                    "type": "string",
                    "enum": [
                      "replace",
                      "add",
                      "remove"
                    ],
                    "description": "How the sent `companies` / `domains` / `linkedin_urls` meet the stored watch list: `replace` (default) swaps the whole list, `add` appends the sent companies, `remove` drops them. Lists you omit are never touched.",
                    "example": "add"
                  },
                  "excluded_companies_mode": {
                    "type": "string",
                    "enum": [
                      "replace",
                      "add",
                      "remove"
                    ],
                    "description": "Same for the exclusion list (`excluded_companies` / `excluded_domains` / `excluded_linkedin_urls`): `replace` (default), `add` or `remove`.",
                    "example": "add"
                  },
                  "record_unit": {
                    "type": "string",
                    "enum": [
                      "signal",
                      "company"
                    ],
                    "description": "What one delivered record is: `signal` (payload `signals[]`, one entry per signal) or `company` (payload `companies[]`, one entry per company with its signals nested). Default follows `detection_mode`: `signal_first` → `signal`, `company_first` → `company`. Caps (`max_records_per_trigger`, `max_daily_records`) count this unit.",
                    "example": "company"
                  },
                  "company_dedupe_days": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "A company appears in at most one delivery per this many days, across all the monitor's signal types; a company delivered inside the window is left out of later deliveries and its later signals in the window are skipped, not queued. `0` = off. Default: 0.",
                    "example": 30
                  },
                  "is_newest_first": {
                    "type": "boolean",
                    "description": "Deliver the freshest matching signals first. With a per-trigger or daily cap the newest records are kept and the monitor's cursor still moves to the newest fetched row, so older rows are skipped, never queued. Default `true` for a new monitor; send `false` for oldest first, nothing skipped. With `is_paged_delivery`, it only sets the page order: page 1 holds the newest of the window, and nothing is skipped.",
                    "example": true
                  },
                  "is_paged_delivery": {
                    "type": "boolean",
                    "description": "One delivery per run, covering only the signals that arrived since the last run. The delivery carries page 1 (up to `max_records_per_trigger`), the window's total in `pagination.total_entries` (the same `pagination` block every search returns) and a `metadata.window.next_page_token`; pull the rest with [Signals Search](/en/api-reference/endpoint/monitors/signals_search). Nothing is carried over to the next run. Jobs, news, advertisements and cloud footprints only: a monitor holding expansion signals is refused with code `40086`. Default `false` (overflow carried over to the next run).",
                    "example": true
                  },
                  "max_daily_records": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Hard cap on records delivered per calendar day in the owner's timezone (`0` = unlimited). Counted in the monitor's record unit over successful deliveries; a trigger delivers at most the remaining budget, then the monitor waits for the next day without moving its cursor. Default: 0.",
                    "example": 200
                  },
                  "notification_email": {
                    "type": "string",
                    "format": "email",
                    "description": "Email for failure notifications."
                  },
                  "max_retry_per_trigger": {
                    "type": "integer",
                    "description": "Maximum retries per trigger. Min: 0, Max: 3, Default: 1.",
                    "minimum": 0,
                    "maximum": 3
                  },
                  "retry_delay_second": {
                    "type": "integer",
                    "description": "Delay between retries in seconds. Min: 1, Max: 5, Default: 1.",
                    "minimum": 1,
                    "maximum": 5
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "active",
                      "paused",
                      "inactive"
                    ],
                    "description": "Lifecycle status to set. Changing status resets the failure counter."
                  }
                },
                "required": [
                  "monitor_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_update",
        "summary": "Update a monitor",
        "description": "Update an existing monitor's configuration and detection rules.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/duplicate": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the duplicated monitor. The full monitor configuration is returned (signal_types, signal_filters, company_filters, companies, enrichment settings, destination, trigger limits), including the new `signature` generated for the copy.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for the duplicated monitor."
                        },
                        "name": {
                          "type": "string",
                          "description": "Name of the duplicated monitor."
                        },
                        "description": {
                          "type": "string",
                          "description": "Description of the duplicated monitor."
                        },
                        "detection_mode": {
                          "type": "string",
                          "description": "Detection mode."
                        },
                        "destination_type": {
                          "type": "string",
                          "description": "Delivery destination type."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "draft",
                            "active",
                            "paused",
                            "inactive"
                          ],
                          "description": "Lifecycle status of the duplicated monitor."
                        },
                        "masked_signature": {
                          "type": "string",
                          "description": "Masked webhook signature."
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp when the duplicate was created."
                        },
                        "signature": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Webhook signature for the duplicated monitor."
                        }
                      },
                      "description": "The duplicated monitor. The full configuration (signal_types, signal_filters, company_filters, companies, enrichment settings, destination_config, trigger limits) is also returned."
                    }
                  }
                },
                "example": {
                  "data": {
                    "monitor_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
                    "name": "My Monitor (Copy)",
                    "description": "Monitors news and job signals for target companies",
                    "detection_mode": "signal_first",
                    "destination_type": "webhook",
                    "status": "active",
                    "masked_signature": "7••••••••••••••••8df",
                    "created_at": "2026-04-05T21:15:00.000Z",
                    "signature": "f6a7b8c9-d0e1-2345-fabc-456789012345"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor to duplicate."
                  },
                  "name": {
                    "type": "string",
                    "description": "Name for the duplicated monitor. When omitted, the copy is named \"<original name> <duplicate suffix>\" — a default duplicate suffix is appended to the original name."
                  }
                },
                "required": [
                  "monitor_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_duplicate",
        "summary": "Duplicate a monitor",
        "description": "Create a copy of an existing monitor with the same configuration.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/delete": {
      "delete": {
        "responses": {
          "200": {
            "description": "Successful response. The monitor has been deleted.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true,
                      "description": "Returns null on successful deletion."
                    }
                  }
                },
                "example": {
                  "data": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor to delete."
                  }
                },
                "required": [
                  "monitor_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_delete",
        "summary": "Delete a monitor",
        "description": "Delete a monitor from the workspace.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/lookup": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the full monitor details including configuration and destination settings. A monitor that no longer exists (deleted, or not visible to your team) answers `data: null`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for the monitor."
                        },
                        "profile_id": {
                          "type": "integer",
                          "description": "Profile identifier."
                        },
                        "user_id": {
                          "type": "string",
                          "description": "User identifier."
                        },
                        "name": {
                          "type": "string",
                          "description": "Name of the monitor."
                        },
                        "description": {
                          "type": "string",
                          "description": "Description of the monitor."
                        },
                        "detection_mode": {
                          "type": "string",
                          "description": "Detection mode."
                        },
                        "signal_types": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Types of signals monitored."
                        },
                        "signal_filters": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Signal filters configuration."
                        },
                        "company_filters": {
                          "type": "object",
                          "description": "Company filters configuration."
                        },
                        "companies": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Company identifiers."
                        },
                        "company_count": {
                          "type": "integer"
                        },
                        "source_group_id": {
                          "type": "integer",
                          "nullable": true,
                          "description": "Company group that holds the watch list; read it page by page through Company Search with `company_groups`."
                        },
                        "is_company_enrichment": {
                          "type": "boolean",
                          "description": "Whether company enrichment is enabled."
                        },
                        "is_people_enrichment": {
                          "type": "boolean",
                          "description": "Whether people enrichment is enabled."
                        },
                        "people_enrichment_configs": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "People enrichment configuration."
                        },
                        "destination_type": {
                          "type": "string",
                          "description": "Delivery destination type."
                        },
                        "destination_config": {
                          "type": "object",
                          "description": "Full destination configuration details."
                        },
                        "frequency_minute": {
                          "type": "integer",
                          "description": "Trigger frequency in minutes."
                        },
                        "max_retry_per_trigger": {
                          "type": "integer",
                          "description": "Maximum retries per trigger."
                        },
                        "max_records_per_trigger": {
                          "type": "integer",
                          "description": "Maximum records per trigger."
                        },
                        "retry_delay_second": {
                          "type": "integer",
                          "description": "Delay between retries in seconds."
                        },
                        "max_daily_trigger": {
                          "type": "integer",
                          "description": "Maximum triggers per day."
                        },
                        "excluded_companies": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "excluded_company_count": {
                          "type": "integer"
                        },
                        "excluded_group_id": {
                          "type": "integer",
                          "nullable": true,
                          "description": "Company group that holds the exclusion list; readable the same way."
                        },
                        "record_unit": {
                          "type": "string",
                          "nullable": true,
                          "enum": [
                            "signal",
                            "company"
                          ]
                        },
                        "company_dedupe_days": {
                          "type": "integer"
                        },
                        "is_newest_first": {
                          "type": "boolean"
                        },
                        "is_paged_delivery": {
                          "type": "boolean"
                        },
                        "max_daily_records": {
                          "type": "integer"
                        },
                        "max_failure_trigger": {
                          "type": "integer",
                          "description": "Maximum consecutive failures before pausing."
                        },
                        "masked_signature": {
                          "type": "string",
                          "description": "Masked webhook signature."
                        },
                        "signature": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Full webhook signature. Only included when is_signature_reveal is true."
                        },
                        "repeated_failure_count": {
                          "type": "integer",
                          "description": "Current count of repeated consecutive failures."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "draft",
                            "active",
                            "paused",
                            "inactive"
                          ],
                          "description": "Lifecycle status of the monitor."
                        },
                        "language_code": {
                          "type": "string",
                          "nullable": true,
                          "description": "Language code used to render this monitor's deliveries."
                        },
                        "notification_email": {
                          "type": "string",
                          "description": "Notification email address."
                        },
                        "last_trigger_at": {
                          "type": "string",
                          "format": "date-time",
                          "nullable": true,
                          "description": "Timestamp of the last trigger."
                        },
                        "last_processed_at": {
                          "type": "string",
                          "format": "date-time",
                          "nullable": true,
                          "description": "Timestamp of the last completed processing."
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp when the monitor was created."
                        },
                        "last_modified": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp when the monitor was last modified."
                        },
                        "last_processed": {
                          "type": "string",
                          "format": "date-time",
                          "nullable": true,
                          "description": "Timestamp of the last processed event."
                        },
                        "user": {
                          "type": "object",
                          "properties": {
                            "user_id": {
                              "type": "string",
                              "description": "Identifier of the user who created the monitor."
                            },
                            "nickname": {
                              "type": "string",
                              "description": "Display name of the user."
                            },
                            "email": {
                              "type": "string",
                              "description": "Email of the user."
                            }
                          },
                          "description": "User who created the monitor."
                        }
                      },
                      "nullable": true
                    }
                  }
                },
                "example": {
                  "data": {
                    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "profile_id": 1,
                    "user_id": "a1b2c3d4-0000-0000-0000-000000000000",
                    "name": "Signal First Monitor",
                    "description": "Tracking AI job postings",
                    "detection_mode": "signal_first",
                    "signal_types": [
                      "jobs",
                      "news",
                      "advertisements"
                    ],
                    "signal_filters": [
                      {
                        "filters": {
                          "locations": [
                            "US"
                          ],
                          "titles": [
                            "AI Engineer"
                          ]
                        },
                        "signal_type": "jobs"
                      },
                      "..."
                    ],
                    "company_filters": {
                      "locations": [
                        "US"
                      ],
                      "employees": [
                        [
                          501,
                          1000
                        ]
                      ],
                      "...": "..."
                    },
                    "companies": [
                      "67c4696b-b7b0-46b5-b2af-9f434543661e"
                    ],
                    "company_count": 1,
                    "source_group_id": 1042,
                    "is_company_enrichment": true,
                    "is_people_enrichment": true,
                    "people_enrichment_configs": [
                      {
                        "filters": {
                          "management_levels": [
                            "founder",
                            "vp"
                          ],
                          "...": "..."
                        },
                        "max_people_to_return": 25,
                        "people_contact_types": [
                          "email-work",
                          "email-personal",
                          "phone"
                        ]
                      }
                    ],
                    "destination_type": "webhook",
                    "destination_config": {
                      "webhook_url": "https://usewebhook.com/example",
                      "headers": {
                        "X-Custom-Auth": "your-token"
                      },
                      "body": {
                        "source": "pubrio"
                      }
                    },
                    "frequency_minute": 0,
                    "notification_email": "team@example.com",
                    "max_retry_per_trigger": 2,
                    "max_records_per_trigger": 10,
                    "retry_delay_second": 5,
                    "max_daily_trigger": 500,
                    "excluded_companies": [],
                    "excluded_company_count": 0,
                    "excluded_group_id": null,
                    "record_unit": null,
                    "company_dedupe_days": 0,
                    "is_newest_first": false,
                    "max_daily_records": 0,
                    "masked_signature": "7••••••••••••••••8df",
                    "signature": "710a69f6-aaaf-449d-b3f6-78ba66d648df",
                    "repeated_failure_count": 0,
                    "status": "active",
                    "language_code": "en",
                    "max_failure_trigger": 5,
                    "last_processed_at": null,
                    "last_trigger_at": null,
                    "created_at": "2026-04-05T20:30:17.792Z",
                    "last_modified": "2026-04-05T20:30:17.792Z",
                    "last_processed": null,
                    "user": {
                      "user_id": "a1b2c3d4-0000-0000-0000-000000000000",
                      "nickname": "Jane Smith",
                      "email": "jane@example.com"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor to look up."
                  },
                  "is_signature_reveal": {
                    "type": "boolean",
                    "description": "When true, the full webhook signature is included in the response. Defaults to false.",
                    "default": false
                  }
                },
                "required": [
                  "monitor_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_lookup",
        "summary": "Look up a monitor",
        "description": "Retrieve detailed information about a specific monitor.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/signature/reveal": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the monitor's full webhook signature.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "monitor_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier of the monitor."
                        },
                        "signature": {
                          "type": "string",
                          "format": "uuid",
                          "description": "The full webhook signature for payload verification."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
                    "signature": "d4e5f6a7-b8c9-0123-defa-234567890123"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the monitor."
                  }
                },
                "required": [
                  "monitor_id"
                ]
              }
            }
          }
        },
        "operationId": "monitors_reveal_signature",
        "summary": "Reveal monitor webhook signature",
        "description": "Retrieve the webhook signing secret for a monitor.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/monitors/webhook/validate": {
      "post": {
        "responses": {
          "200": {
            "description": "Successful response containing the webhook validation results — the destination configuration and the test request/response payloads. On webhook failure the endpoint responds 400 (MONITOR_WEBHOOK_URL_INVALID) with the webhook's response in the error details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "destination_config": {
                          "type": "object",
                          "description": "The destination configuration that was tested."
                        },
                        "request_payload": {
                          "type": "object",
                          "description": "The request payload sent to the webhook during validation."
                        },
                        "response_payload": {
                          "type": "object",
                          "description": "The response payload received from the webhook."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "destination_config": {
                      "webhook_url": "https://usewebhook.com/example",
                      "headers": {
                        "X-Custom-Auth": "your-token"
                      },
                      "body": {
                        "source": "pubrio"
                      }
                    },
                    "request_payload": {
                      "monitor": {
                        "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                        "name": "My Monitor",
                        "detection_mode": "signal_first",
                        "signal_types": [
                          "jobs",
                          "news",
                          "advertisements"
                        ],
                        "signal_filters": [
                          "..."
                        ],
                        "company_filters": {
                          "...": "..."
                        },
                        "is_company_enrichment": true,
                        "is_people_enrichment": true,
                        "people_enrichment_configs": [
                          "..."
                        ]
                      },
                      "metadata": {
                        "total_signals": 3,
                        "total_companies": 1,
                        "total_people": 0
                      },
                      "triggered_at": "2026-04-05T22:43:06.973Z",
                      "signals": [
                        {
                          "signal_type": "jobs",
                          "signal": {
                            "signal_type": "jobs",
                            "job_search_id": "...",
                            "companies": [
                              "..."
                            ]
                          },
                          "companies": [
                            "..."
                          ]
                        },
                        "..."
                      ],
                      "source": "pubrio"
                    },
                    "response_payload": "OK"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monitor_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of an existing monitor to test. Optional for testing new configurations."
                  },
                  "name": {
                    "type": "string",
                    "description": "Name of the monitor."
                  },
                  "description": {
                    "type": "string",
                    "description": "Description of the monitor."
                  },
                  "detection_mode": {
                    "type": "string",
                    "description": "How signals are detected. `signal_first` scans the market broadly; `company_first` tracks a named account list and requires at least one company, domain or LinkedIn URL. **Immutable after creation** — changing it on an existing monitor returns `40021`. Create a new monitor instead.",
                    "enum": [
                      "company_first",
                      "signal_first"
                    ]
                  },
                  "signal_types": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "jobs",
                        "news",
                        "advertisements",
                        "expansions",
                        "cloud_footprints"
                      ]
                    },
                    "description": "Types of signals to monitor."
                  },
                  "signal_filters": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "signal_type"
                      ],
                      "properties": {
                        "signal_type": {
                          "type": "string",
                          "enum": [
                            "jobs",
                            "news",
                            "advertisements",
                            "expansions",
                            "cloud_footprints"
                          ],
                          "description": "Which stream this entry filters."
                        },
                        "filters": {
                          "type": "object",
                          "description": "Filters for this stream. `jobs`, `news` and `advertisements` take the parameters of [Job Search](/en/api-reference/endpoint/companies/job_search), [News Search](/en/api-reference/endpoint/companies/news_search) and [Advertisement Search](/en/api-reference/endpoint/companies/advertisements_search). `expansions` takes the [Expansion Search](/en/api-reference/endpoint/expansions/market_lookup) vocabulary: `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Resolve slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types)."
                        }
                      }
                    },
                    "description": "One entry per signal stream the monitor watches.",
                    "example": [
                      {
                        "signal_type": "jobs",
                        "filters": {
                          "locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "news",
                        "filters": {
                          "locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "advertisements",
                        "filters": {
                          "target_locations": [
                            "US"
                          ]
                        }
                      },
                      {
                        "signal_type": "expansions",
                        "filters": {
                          "tos": [
                            "US"
                          ],
                          "stages": [
                            "expanding",
                            "scaling"
                          ],
                          "signal_types": [
                            "HIRE",
                            "EXEC"
                          ],
                          "signal_strengths": [
                            "high",
                            "very_high"
                          ]
                        }
                      }
                    ]
                  },
                  "company_filters": {
                    "type": "object",
                    "description": "Global company filters. Accepts the same parameters as the [Company Search](/en/api-reference/endpoint/companies/search) endpoint.",
                    "example": {
                      "locations": [
                        "US"
                      ],
                      "employees": [
                        [
                          501,
                          1000
                        ],
                        [
                          1001,
                          5000
                        ]
                      ]
                    }
                  },
                  "companies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "description": "List of company domain_search_id UUIDs. Alternative: use `domains` or `linkedin_urls`."
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of company domains. Alternative to `companies`."
                  },
                  "linkedin_urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    },
                    "description": "List of LinkedIn company URLs. Alternative to `companies`."
                  },
                  "is_company_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich company data."
                  },
                  "is_people_enrichment": {
                    "type": "boolean",
                    "description": "Whether to enrich people data."
                  },
                  "people_enrichment_configs": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Array of people enrichment layers. Contains `max_people_to_return` (1-25), `people_contact_types` (see [Redeem](/en/api-reference/endpoint/redeem/people)), and `filters` (see [People Search](/en/api-reference/endpoint/people/search)).",
                    "example": [
                      {
                        "filters": {
                          "people_locations": [
                            "US"
                          ]
                        },
                        "max_people_to_return": 3,
                        "people_contact_types": [
                          "email-work"
                        ]
                      }
                    ]
                  },
                  "destination_type": {
                    "type": "string",
                    "description": "Delivery destination type.",
                    "enum": [
                      "webhook",
                      "email",
                      "sequences"
                    ]
                  },
                  "destination_config": {
                    "type": "object",
                    "description": "Configuration for the destination. For webhook: requires `webhook_url` (string), optional `headers` (object) and `body` (object). For email: accepts `email` (string) or `emails` (array of strings). For sequences: requires `sequence_identifier` (string) plus at least one of `is_people_search_enrolled` / `is_company_contact_enrolled` set to true.",
                    "example": {
                      "webhook_url": "https://your-webhook.com/endpoint",
                      "headers": {
                        "Authorization": "Bearer token"
                      },
                      "body": {
                        "pipeline": "my-webhook"
                      }
                    }
                  },
                  "frequency_minute": {
                    "type": "integer",
                    "description": "Trigger frequency in minutes. Min: 0, Max: 10080.",
                    "minimum": 0,
                    "maximum": 10080
                  },
                  "max_failure_trigger": {
                    "type": "integer",
                    "description": "Maximum consecutive failures before pausing. Min: 1, Max: 10.",
                    "minimum": 1,
                    "maximum": 10
                  },
                  "max_daily_trigger": {
                    "type": "integer",
                    "description": "Maximum triggers per day. Min: 0, Max: 86400.",
                    "minimum": 0,
                    "maximum": 86400
                  },
                  "max_records_per_trigger": {
                    "type": "integer",
                    "description": "Controls the maximum number of records delivered per trigger. Lower values reduce payload size per delivery, which is recommended for large result sets or rate-limited integrations. Min: 1, Max: 100, Default: 25. See [Setting up Webhooks](/en/developer-guides/setting-up-webhooks) for guidance.",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "notification_email": {
                    "type": "string",
                    "format": "email",
                    "description": "Email for failure notifications."
                  },
                  "max_retry_per_trigger": {
                    "type": "integer",
                    "description": "Maximum retries per trigger. Min: 0, Max: 3.",
                    "minimum": 0,
                    "maximum": 3
                  },
                  "retry_delay_second": {
                    "type": "integer",
                    "description": "Delay between retries in seconds. Min: 1, Max: 5.",
                    "minimum": 1,
                    "maximum": 5
                  }
                },
                "required": [
                  "destination_config"
                ]
              }
            }
          }
        },
        "operationId": "monitors_validate_webhook",
        "summary": "Validate monitor webhook",
        "description": "Send a signed test payload to a webhook URL and report whether it was accepted.\n\n**This performs a real HTTP delivery**, not a URL syntax check. The receiver must accept a `POST` and respond successfully — a URL that merely serves a page on `GET` still fails. On failure you get `40023` (URL not valid or unreachable) or `40022` (test delivery failed), and `details` carries the raw upstream response body, which can be several kilobytes of HTML. Pass `monitor_id` to sign the test with that monitor's real signature; omit it and a placeholder signature is used.",
        "tags": [
          "Monitor"
        ]
      }
    },
    "/companies/news/languages": {
      "get": {
        "responses": {
          "200": {
            "description": "Successful response containing news language details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/data_array"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "news_language_id": "77bb2cd2-fbea-4cd1-b860-78786c6b2343",
                      "slug": "ar",
                      "locale_code": "ar",
                      "name": "Arabic",
                      "name_en": "Arabic"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "parameters": [],
        "operationId": "filters_list_news_languages",
        "summary": "List news languages",
        "description": "Retrieve the list of available languages for news filtering.",
        "tags": [
          "Filters"
        ]
      }
    },
    "/api_keys/logs": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "List API request logs",
        "description": "Retrieve a paginated list of API request logs for the workspace. Each entry summarizes a single request made with a `pubrio-api-key`, including the path, method, status code, duration, response size, and credit cost. Use the [Look up log details](/api-reference/endpoint/api-keys/logs_lookup) endpoint to fetch the full request/response payload for a specific entry.",
        "operationId": "api_keys_get_logs",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "order_by": {
                    "type": "string",
                    "enum": [
                      "created_at",
                      "duration_ms",
                      "status_code"
                    ],
                    "default": "created_at",
                    "description": "Field to sort the log list by."
                  },
                  "is_ascending_order": {
                    "type": "boolean",
                    "default": false,
                    "description": "Sort direction. `true` for ascending, `false` (default) for descending."
                  },
                  "search_term": {
                    "type": "string",
                    "description": "Free-text search across the request path, log type slug, and raw request body."
                  },
                  "log_types": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Filter by log type IDs."
                  },
                  "log_type_slugs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by log type slugs (e.g. `people_search`, `company_search`)."
                  },
                  "status_codes": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Filter by HTTP status codes (e.g. `[200, 400, 500]`)."
                  },
                  "methods": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Filter by HTTP methods (e.g. `[\"POST\", \"GET\"]`)."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing paginated API request logs.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "filters": {
                          "type": "object",
                          "description": "Echo of the request filters used to produce this response, with empty values stripped.",
                          "additionalProperties": true
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "pagination": {
                          "type": "object",
                          "properties": {
                            "page": {
                              "type": "integer",
                              "description": "Current page number."
                            },
                            "per_page": {
                              "type": "integer",
                              "description": "Number of results per page."
                            },
                            "total_entries": {
                              "type": "integer",
                              "description": "Total number of log entries."
                            },
                            "total_pages": {
                              "type": "integer",
                              "description": "Total number of pages."
                            },
                            "total_display_pages": {
                              "type": "integer",
                              "description": "Maximum number of pages displayable for this plan."
                            },
                            "is_timeout": {
                              "type": "boolean",
                              "description": "Whether the count query timed out."
                            }
                          }
                        },
                        "query_logs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "query_log_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "Unique identifier of the log entry. Pass to `/api_keys/logs/lookup` to retrieve the full payload."
                              },
                              "created_at": {
                                "type": "string",
                                "description": "Timestamp when the request was received (UTC)."
                              },
                              "profile_id": {
                                "type": "integer",
                                "description": "Workspace profile ID associated with the request."
                              },
                              "user_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "User ID associated with the API key."
                              },
                              "method": {
                                "type": "string",
                                "description": "HTTP method of the request."
                              },
                              "path": {
                                "type": "string",
                                "description": "Request path."
                              },
                              "status_code": {
                                "type": "integer",
                                "description": "HTTP status code returned."
                              },
                              "duration_ms": {
                                "type": "integer",
                                "description": "Request processing duration in milliseconds."
                              },
                              "log_type_id": {
                                "type": "integer",
                                "description": "Internal log type ID. `0` if the request did not map to a billable log type."
                              },
                              "log_type_slug": {
                                "type": "string",
                                "nullable": true,
                                "description": "Log type slug (e.g. `people_search`). `null` for unbilled requests."
                              },
                              "log_type_name": {
                                "type": "string",
                                "nullable": true,
                                "description": "Human-readable log type name."
                              },
                              "authentication_type": {
                                "type": "string",
                                "description": "Authentication mechanism used. Always `pubrio-api-key` for API key requests."
                              },
                              "authentication_type_name": {
                                "type": "string",
                                "description": "Human-readable authentication type name."
                              },
                              "masked_authentication": {
                                "type": "string",
                                "description": "Masked representation of the API key used for this request."
                              },
                              "response_size": {
                                "type": "integer",
                                "description": "Size of the response body in bytes."
                              },
                              "credits": {
                                "type": "number",
                                "description": "Total credits charged for this request."
                              },
                              "ip": {
                                "type": "string",
                                "description": "Client IP address of the caller."
                              },
                              "email": {
                                "type": "string",
                                "description": "Email of the user the API key belongs to."
                              },
                              "nickname": {
                                "type": "string",
                                "description": "Nickname of the user the API key belongs to."
                              },
                              "user": {
                                "type": "object",
                                "properties": {
                                  "user_id": {
                                    "type": "string",
                                    "format": "uuid"
                                  },
                                  "nickname": {
                                    "type": "string"
                                  },
                                  "email": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "page": 1,
                      "per_page": 3,
                      "status_codes": [
                        200
                      ]
                    }
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 3,
                      "total_entries": 1109,
                      "total_pages": 370,
                      "total_display_pages": 250,
                      "is_timeout": false
                    },
                    "query_logs": [
                      {
                        "query_log_id": "fc1ce3dd-39f7-4fbd-9d22-569a17115c11",
                        "created_at": "2026-05-14 12:04:32.243",
                        "profile_id": 1,
                        "user_id": "2981d4b3-f8b1-44d8-9759-889f3bfa2faf",
                        "method": "POST",
                        "path": "/api_keys/usage/daily",
                        "status_code": 200,
                        "duration_ms": 1821,
                        "log_type_id": 0,
                        "authentication_type": "pubrio-api-key",
                        "masked_authentication": "0••••••••••••••••f39",
                        "response_size": 2180,
                        "ip": "127.0.0.1",
                        "email": "you@example.com",
                        "nickname": "Example User",
                        "user": {
                          "user_id": "2981d4b3-f8b1-44d8-9759-889f3bfa2faf",
                          "nickname": "Example User",
                          "email": "you@example.com"
                        },
                        "log_type_slug": null,
                        "credits": 0,
                        "log_type_name": null,
                        "authentication_type_name": "API Key"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/api_keys/logs/lookup": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Look up API request log details",
        "description": "Retrieve the full request body, request headers, response body, and response size for a specific API request log entry. Use this to inspect what was sent or returned for a given `query_log_id` discovered via the list endpoint.",
        "operationId": "api_keys_lookup_log",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query_log_id"
                ],
                "properties": {
                  "query_log_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the log entry to look up. Obtain this from `/api_keys/logs`."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing the full request and response payload.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "query_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Identifier of the log entry that was looked up."
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "nullable": true,
                      "properties": {
                        "query_log_id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Identifier of the log entry."
                        },
                        "request_body": {
                          "type": "string",
                          "nullable": true,
                          "description": "Stringified JSON of the original request body."
                        },
                        "request_headers": {
                          "type": "object",
                          "nullable": true,
                          "description": "The original request headers. Sensitive headers such as the API key are stored masked.",
                          "additionalProperties": {
                            "type": "string"
                          }
                        },
                        "response_body": {
                          "type": "string",
                          "nullable": true,
                          "description": "Stringified JSON of the response body returned to the caller."
                        },
                        "response_size": {
                          "type": "integer",
                          "description": "Size of the response body in bytes."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "query_log_id": "fc1ce3dd-39f7-4fbd-9d22-569a17115c11"
                  },
                  "data": {
                    "query_log_id": "fc1ce3dd-39f7-4fbd-9d22-569a17115c11",
                    "request_body": "{\"start_date\":\"2026-05-01\",\"end_date\":\"2026-05-14\"}",
                    "request_headers": {
                      "host": "api.pubrio.com",
                      "user-agent": "curl/8.7.1",
                      "accept": "*/*",
                      "pubrio-api-key": "***",
                      "content-type": "application/json",
                      "content-length": "51"
                    },
                    "response_body": "{\"metadata\":{\"filters\":{\"start_date\":\"2026-05-01\",\"end_date\":\"2026-05-14\"}},\"data\":{\"series\":[...],\"by_log_type\":[...],\"totals\":{\"credits\":41892,\"requests\":4896}}}",
                    "response_size": 2346
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/api_keys/usage/daily": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Get daily API usage timeseries",
        "description": "Retrieve a daily breakdown of API requests and credits consumed by the workspace within a date range. The response includes a per-day timeseries and a stacked per-endpoint series suitable for building usage charts.",
        "operationId": "api_keys_get_usage_daily",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "start_date",
                  "end_date"
                ],
                "properties": {
                  "start_date": {
                    "type": "string",
                    "example": "2026-05-01",
                    "description": "Start of the date range in `YYYY-MM-DD` format (interpreted in the workspace timezone)."
                  },
                  "end_date": {
                    "type": "string",
                    "example": "2026-05-14",
                    "description": "End of the date range in `YYYY-MM-DD` format (interpreted in the workspace timezone)."
                  },
                  "keys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional list of masked API key identifiers (e.g. `0••••••••••••••••f39`) to restrict the results to specific keys. Use the masked values returned by `/api_keys` or by the `masked_authentication` field on a log entry."
                  },
                  "log_type_slugs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional list of log type slugs (e.g. `people_search`, `company_search`, `people_redeem`) to restrict the results to specific endpoints."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing a daily usage timeseries.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "filters": {
                          "type": "object",
                          "description": "Echo of the request filters used to produce this response, with empty values stripped.",
                          "additionalProperties": true
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "series": {
                          "type": "array",
                          "description": "Per-day totals across all endpoints, sorted ascending by date.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "date": {
                                "type": "string",
                                "description": "Day in `YYYY-MM-DD` format."
                              },
                              "credits": {
                                "type": "number",
                                "description": "Credits consumed on this day."
                              },
                              "requests": {
                                "type": "integer",
                                "description": "Number of API requests on this day."
                              }
                            }
                          }
                        },
                        "by_log_type": {
                          "type": "array",
                          "description": "Per-endpoint stacked series, ordered by credits then requests (descending).",
                          "items": {
                            "type": "object",
                            "properties": {
                              "slug": {
                                "type": "string",
                                "description": "Log type slug. `__unknown__` indicates requests not mapped to a billable log type."
                              },
                              "name": {
                                "type": "string",
                                "description": "Human-readable log type name."
                              },
                              "totals": {
                                "type": "object",
                                "properties": {
                                  "credits": {
                                    "type": "number"
                                  },
                                  "requests": {
                                    "type": "integer"
                                  }
                                }
                              },
                              "series": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "date": {
                                      "type": "string"
                                    },
                                    "credits": {
                                      "type": "number"
                                    },
                                    "requests": {
                                      "type": "integer"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        },
                        "totals": {
                          "type": "object",
                          "properties": {
                            "credits": {
                              "type": "number"
                            },
                            "requests": {
                              "type": "integer"
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "start_date": "2026-05-01",
                      "end_date": "2026-05-14"
                    }
                  },
                  "data": {
                    "series": [
                      {
                        "date": "2026-05-01",
                        "credits": 26352,
                        "requests": 2827
                      },
                      {
                        "date": "2026-05-05",
                        "credits": 798,
                        "requests": 402
                      },
                      {
                        "date": "2026-05-11",
                        "credits": 187,
                        "requests": 187
                      }
                    ],
                    "by_log_type": [
                      {
                        "slug": "people_redeem",
                        "name": "Redeem People",
                        "totals": {
                          "credits": 40835,
                          "requests": 4083
                        },
                        "series": [
                          {
                            "date": "2026-05-01",
                            "credits": 26140,
                            "requests": 2614
                          },
                          {
                            "date": "2026-05-11",
                            "credits": 185,
                            "requests": 15
                          }
                        ]
                      },
                      {
                        "slug": "people_search",
                        "name": "People Search",
                        "totals": {
                          "credits": 633,
                          "requests": 212
                        },
                        "series": [
                          {
                            "date": "2026-05-05",
                            "credits": 594,
                            "requests": 199
                          }
                        ]
                      }
                    ],
                    "totals": {
                      "credits": 41892,
                      "requests": 4896
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/api_keys/usage/breakdown": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Get API usage breakdown by key and endpoint",
        "description": "Retrieve a breakdown of API requests and credits consumed within a date range, grouped both by individual API key (`by_key`) and by endpoint (`by_endpoint`). Useful for identifying the highest-traffic keys and the most credit-intensive endpoints across the workspace.",
        "operationId": "api_keys_get_usage_breakdown",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "start_date",
                  "end_date"
                ],
                "properties": {
                  "start_date": {
                    "type": "string",
                    "example": "2026-05-01",
                    "description": "Start of the date range in `YYYY-MM-DD` format (interpreted in the workspace timezone)."
                  },
                  "end_date": {
                    "type": "string",
                    "example": "2026-05-14",
                    "description": "End of the date range in `YYYY-MM-DD` format (interpreted in the workspace timezone)."
                  },
                  "keys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional list of masked API key identifiers (e.g. `0••••••••••••••••f39`) to restrict the results to specific keys. Use the masked values returned by `/api_keys` or by the `masked_authentication` field on a log entry."
                  },
                  "log_type_slugs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional list of log type slugs (e.g. `people_search`, `company_search`, `people_redeem`) to restrict the results to specific endpoints."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing the API usage breakdown.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "filters": {
                          "type": "object",
                          "description": "Echo of the request filters used to produce this response, with empty values stripped.",
                          "additionalProperties": true
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "by_key": {
                          "type": "array",
                          "description": "Usage grouped by API key (top 100, ordered by credits then requests).",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "Masked API key identifier."
                              },
                              "requests": {
                                "type": "integer",
                                "description": "Number of requests made with this key."
                              },
                              "credits": {
                                "type": "number",
                                "description": "Credits consumed by this key."
                              },
                              "last_used": {
                                "type": "string",
                                "nullable": true,
                                "description": "Timestamp of the most recent request from this key, or `null` if never used in the range."
                              },
                              "percent_of_requests": {
                                "type": "number",
                                "description": "Share of total requests, as a percentage."
                              },
                              "percent_of_credits": {
                                "type": "number",
                                "description": "Share of total credits, as a percentage."
                              }
                            }
                          }
                        },
                        "by_endpoint": {
                          "type": "array",
                          "description": "Usage grouped by endpoint (top 100, ordered by credits then requests).",
                          "items": {
                            "type": "object",
                            "properties": {
                              "slug": {
                                "type": "string",
                                "nullable": true,
                                "description": "Log type slug. `null` for requests not mapped to a billable log type."
                              },
                              "name": {
                                "type": "string",
                                "description": "Human-readable log type name."
                              },
                              "requests": {
                                "type": "integer"
                              },
                              "credits": {
                                "type": "number"
                              },
                              "cost_per_call": {
                                "type": "number",
                                "description": "Average credits per request for this endpoint."
                              },
                              "percent_of_requests": {
                                "type": "number",
                                "description": "Share of total requests, as a percentage."
                              },
                              "percent_of_credits": {
                                "type": "number",
                                "description": "Share of total credits, as a percentage."
                              }
                            }
                          }
                        },
                        "totals": {
                          "type": "object",
                          "properties": {
                            "credits": {
                              "type": "number"
                            },
                            "requests": {
                              "type": "integer"
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "start_date": "2026-04-01",
                      "end_date": "2026-05-14"
                    }
                  },
                  "data": {
                    "by_key": [
                      {
                        "name": "2••••••••••••••••a37",
                        "requests": 929,
                        "credits": 42766,
                        "last_used": "2026-05-05 11:09:42.508",
                        "percent_of_requests": 17.892,
                        "percent_of_credits": 99.425
                      },
                      {
                        "name": "0••••••••••••••••f39",
                        "requests": 175,
                        "credits": 187,
                        "last_used": "2026-05-14 12:04:21.651",
                        "percent_of_requests": 3.37,
                        "percent_of_credits": 0.434
                      }
                    ],
                    "by_endpoint": [
                      {
                        "slug": "people_redeem",
                        "name": "Redeem People",
                        "requests": 4088,
                        "credits": 41215,
                        "cost_per_call": 10.08,
                        "percent_of_requests": 78.73,
                        "percent_of_credits": 95.82
                      },
                      {
                        "slug": "people_search",
                        "name": "People Search",
                        "requests": 368,
                        "credits": 1101,
                        "cost_per_call": 2.99,
                        "percent_of_requests": 7.08,
                        "percent_of_credits": 2.55
                      }
                    ],
                    "totals": {
                      "credits": 43013,
                      "requests": 5192
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/companies/jobs/insights": {
      "post": {
        "tags": [
          "Insights"
        ],
        "summary": "Job posting insights",
        "description": "Aggregated hiring-signal insights for a company over a date window: posting volume, seniority distribution, top functions/departments/locations, and a weekly time series.",
        "operationId": "companies_jobs_insights",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "domain_search_id"
                ],
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "date_from": {
                    "$ref": "#/components/schemas/date_from"
                  },
                  "date_to": {
                    "$ref": "#/components/schemas/date_to"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Hiring insight bands for the company and window.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "description": "Insight bands for the requested company and window."
                    }
                  }
                },
                "example": {
                  "data": {
                    "totals": {
                      "open": 3746,
                      "new_in_window": 690,
                      "functions": 18,
                      "locations": 20
                    },
                    "seniority": {
                      "classified": 138,
                      "leadership": 12,
                      "tiers": [
                        {
                          "key": "junior",
                          "rank": 1,
                          "count": 55
                        },
                        {
                          "key": "senior",
                          "rank": 2,
                          "count": 5
                        },
                        {
                          "key": "manager",
                          "rank": 3,
                          "count": 58
                        },
                        {
                          "key": "director",
                          "rank": 4,
                          "count": 12
                        },
                        {
                          "key": "executive",
                          "rank": 5,
                          "count": 8
                        }
                      ]
                    },
                    "postings": [
                      {
                        "c": "CA",
                        "s": 3,
                        "f": [
                          "product_management"
                        ],
                        "w": "2026-08-10"
                      },
                      {
                        "c": "US",
                        "s": 0,
                        "f": null,
                        "w": "2026-08-10"
                      }
                    ],
                    "weekly_series": [
                      {
                        "week_start": "2026-07-27",
                        "count": 10
                      },
                      {
                        "week_start": "2026-08-03",
                        "count": 109
                      }
                    ],
                    "breakdown_function": [
                      {
                        "key": "marketing",
                        "count": 31
                      },
                      {
                        "key": "sales",
                        "count": 19
                      }
                    ],
                    "breakdown_department": [
                      {
                        "key": "master_engineering_technical",
                        "count": 38
                      },
                      {
                        "key": "master_marketing",
                        "count": 35
                      }
                    ],
                    "breakdown_location": [
                      {
                        "key": "US",
                        "count": 402
                      },
                      {
                        "key": "CA",
                        "count": 59
                      }
                    ],
                    "window_days": 31
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/companies/news/insights": {
      "post": {
        "tags": [
          "Insights"
        ],
        "summary": "News insights",
        "description": "Aggregated news-signal insights for a company over a date window: mention volume, top topics and sources, category and market breakdowns, and a weekly time series.",
        "operationId": "companies_news_insights",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "domain_search_id"
                ],
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "date_from": {
                    "$ref": "#/components/schemas/date_from"
                  },
                  "date_to": {
                    "$ref": "#/components/schemas/date_to"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "News insight bands for the company and window.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "description": "Insight bands for the requested company and window.",
                      "properties": {
                        "totals": {
                          "type": "object",
                          "description": "Headline counts for the window. `mentions` is the number of articles, `topics` and `sources` are counts of *distinct* categories and publishers (integers, not lists), and `top_source` is the publisher domain with the most mentions. The per-topic and per-market lists are `category_breakdown` and `market_breakdown`."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "totals": {
                      "mentions": 1785,
                      "topics": 27,
                      "sources": 140,
                      "top_source": "shazoo.ru"
                    },
                    "weekly_series": [
                      {
                        "week_start": "2026-05-18",
                        "count": 31
                      }
                    ],
                    "category_breakdown": [
                      {
                        "key": "launches",
                        "count": 681
                      }
                    ],
                    "market_breakdown": [
                      {
                        "key": "US",
                        "count": 297
                      }
                    ],
                    "window_days": 90
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/companies/advertisements/insights": {
      "post": {
        "tags": [
          "Insights"
        ],
        "summary": "Advertisement insights",
        "description": "Aggregated advertising-signal insights for a company over a date window: active and launched ad counts, channel and placement mix, creative samples, audience reach as a tier distribution, and a weekly time series. Reach is reported as a distribution across tiers, never as a single summed figure.",
        "operationId": "companies_advertisements_insights",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "domain_search_id"
                ],
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "date_from": {
                    "$ref": "#/components/schemas/date_from"
                  },
                  "date_to": {
                    "$ref": "#/components/schemas/date_to"
                  },
                  "is_include_unlinked_companies": {
                    "type": "boolean",
                    "example": false,
                    "description": "Include advertisements not yet linked to a verified company profile."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Advertising insight bands for the company and window.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "description": "Insight bands for the requested company and window.",
                      "properties": {
                        "postings": {
                          "type": "array",
                          "description": "Ad-volume rollup, grouped by reach tier, markets, channel and format. Keys are abbreviated to keep the payload small: `r` = reach tier slug (matches `reach_tiers[].slug`, `null` when the platform reports no reach), `m` = the ISO 3166-1 alpha-2 markets the ads were shown in, `ch` = source channel, `fo` = ad format, `n` = number of ads in this group.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "reach_tiers": {
                          "type": "array",
                          "description": "The reach-tier label catalog, ordered smallest to largest. This is a lookup table, not a distribution — it carries no counts. Join `postings[].r` to `slug` to get the human label, and read the per-tier volume from `postings[].n`. Ad reach is a text range at source, so tiers must never be summed into a single reach figure.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "creatives": {
                          "type": "array",
                          "description": "Recent ad creatives, image-led: creatives with a real image come first, then recent text or video ads so image-less advertisers still appear. `headline`, `body` and `cta` may each be `null`. Everything needed to render a creative gallery is here — no second call to Advertisement Search is required.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "totals": {
                      "total": 14,
                      "launched": 4,
                      "active": 4,
                      "markets": 46,
                      "channels": 2
                    },
                    "weekly_series": [
                      {
                        "week_start": "2026-05-25",
                        "count": 4
                      }
                    ],
                    "postings": [
                      {
                        "r": "10k_50k",
                        "m": [
                          "PE",
                          "KR",
                          "VE",
                          "AR"
                        ],
                        "ch": "facebook",
                        "fo": "video",
                        "n": 1
                      }
                    ],
                    "placement_mix": [
                      {
                        "key": "INSTAGRAM",
                        "count": 10
                      }
                    ],
                    "creatives": [
                      {
                        "advertisement_search_id": "29fbc4ec-d9f2-40dc-be00-c96856271f8c",
                        "image_url": "https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg",
                        "headline": null,
                        "cta": "Learn more",
                        "advertisement_url": "https://www.facebook.com/ads/library?id=1234567890",
                        "destination_url": "https://www.instagram.com/youtube",
                        "advertiser": "YouTube",
                        "body": "this video lives rent free in our minds",
                        "format": "image",
                        "has_video": false
                      }
                    ],
                    "reach_tiers": [
                      {
                        "slug": "lt_1k",
                        "label": "< 1K"
                      },
                      {
                        "slug": "1k_10k",
                        "label": "1K–10K"
                      },
                      {
                        "slug": "10k_50k",
                        "label": "10K–50K"
                      },
                      {
                        "slug": "50k_100k",
                        "label": "50K–100K"
                      },
                      {
                        "slug": "100k_500k",
                        "label": "100K–500K"
                      }
                    ],
                    "window_days": 90
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/dashboard": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Expansion Overview",
        "description": "Market-level expansion KPIs — per-market stage counts and top cross-border flows. Aggregated, not paginated. Answers `408` when the request cannot finish in time.",
        "operationId": "expansions_dashboard",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "froms": {
                    "$ref": "#/components/schemas/expansion_froms"
                  },
                  "tos": {
                    "$ref": "#/components/schemas/expansion_tos"
                  },
                  "exclude_froms": {
                    "$ref": "#/components/schemas/expansion_exclude_froms"
                  },
                  "exclude_tos": {
                    "$ref": "#/components/schemas/expansion_exclude_tos"
                  },
                  "stages": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_stages"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "momentum": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_momentum"
                      }
                    ],
                    "description": "Trajectory of the company's movement in the market. `advancing` is gaining ground, `steady` is holding, `pulling_back` covers retreat and contraction.\n\nDo **not** use the values from `directions` in [Expansion Reference](/en/api-reference/endpoint/expansions/types) here. Those (`advancing`, `steady`, `retreating`, `new`) are the *response* values you get back on `stage.direction`; only the three listed above are accepted as a *filter*. Sending `retreating` or `new` silently disables the filter and returns unfiltered results."
                  },
                  "freshness": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_freshness"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "scopes": {
                    "$ref": "#/components/schemas/expansion_scopes"
                  },
                  "ahead_of_pace": {
                    "type": "boolean",
                    "example": false,
                    "description": "Limit to company/market pairs moving faster than the typical pace for that market."
                  },
                  "signal_types": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_signal_type_slugs"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "signal_strengths": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/signal_strengths"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "min_signal_count": {
                    "type": "integer",
                    "example": 3,
                    "description": "Minimum number of expansion signals a company must have in the window — \"very active / heavy footprint\"."
                  },
                  "only_contraction": {
                    "$ref": "#/components/schemas/only_contraction"
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "keywords": {
                    "$ref": "#/components/schemas/keywords"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/expansion_companies"
                  },
                  "job_locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "job_exclude_locations": {
                    "$ref": "#/components/schemas/job_exclude_locations"
                  },
                  "job_posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "job_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "advertisement_target_locations": {
                    "$ref": "#/components/schemas/advertisement_target_locations"
                  },
                  "advertisement_exclude_target_locations": {
                    "$ref": "#/components/schemas/advertisement_exclude_target_locations"
                  },
                  "advertisement_search_terms": {
                    "$ref": "#/components/schemas/advertisement_search_terms"
                  },
                  "advertisement_start_dates": {
                    "$ref": "#/components/schemas/advertisement_start_dates"
                  },
                  "advertisement_end_dates": {
                    "$ref": "#/components/schemas/advertisement_end_dates"
                  },
                  "news_categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "transitioned_dates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "date"
                    },
                    "example": [
                      "2026-06-01",
                      "2026-06-29"
                    ],
                    "description": "ISO date range [start, end] for the display window (map, flows, and watchlist timeline). Defaults to the last 90 days. The `new_transitions_30d` KPI always uses its own fixed 30-day window regardless of this range."
                  },
                  "window_days": {
                    "$ref": "#/components/schemas/window_days"
                  },
                  "min_markets": {
                    "type": "integer",
                    "example": 3,
                    "description": "Minimum number of new markets a company must have entered in the window (wide expanders)."
                  },
                  "home_country_code": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "SG"
                    ],
                    "description": "Filter by company home country (ISO 3166-1 alpha-2). Intersects with `froms` when both are supplied."
                  },
                  "industries": {
                    "$ref": "#/components/schemas/industries"
                  },
                  "exclude_industries": {
                    "$ref": "#/components/schemas/exclude_industries"
                  },
                  "select_size": {
                    "type": "integer",
                    "example": 250,
                    "description": "Max markets to return (plan-capped)."
                  },
                  "flows_size": {
                    "type": "integer",
                    "example": 50,
                    "description": "Max cross-border flows to return (plan-capped)."
                  },
                  "is_include_metadata": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_is_include_metadata"
                      }
                    ],
                    "description": "Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`."
                  },
                  "is_enable_similarity_search": {
                    "type": "boolean",
                    "description": "Enable free-text matching for `verticals`, `vertical_categories`, `vertical_sub_categories` and `technologies`; those filters are dropped unless this is `true`.",
                    "example": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Market dashboard aggregates.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object"
                    },
                    "data": {
                      "type": "object",
                      "description": "Dashboard container: ranked markets plus the top corridor flows. Deprecated legacy mirror. Every container inside `data` is also emitted at the top level (`countries`, `top_flows`, `picks_aggregate`, `watchlist_markets`, `watchlist_timeline`) for older clients. Read them from `data` — the top-level copies will be removed.",
                      "properties": {
                        "countries": {
                          "type": "array",
                          "description": "Ranked markets with per-market signal counts.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "top_flows": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Largest cross-border expansion flows, busiest first."
                        },
                        "picks_aggregate": {
                          "type": "array",
                          "description": "Aggregate roll-up across the markets matched by the current filters.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "watchlist_markets": {
                          "type": "array",
                          "description": "Per-market stage counts limited to the companies saved in your workspace.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "watchlist_timeline": {
                          "type": "array",
                          "description": "Stage-transition events for the companies saved in your workspace, newest first.",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  },
                  "x-legacy-root-keys": [
                    "countries",
                    "top_flows",
                    "picks_aggregate",
                    "watchlist_markets",
                    "watchlist_timeline"
                  ]
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "froms": [
                        "CN"
                      ],
                      "tos": [
                        "GB"
                      ]
                    },
                    "select_size": 250,
                    "flows_size": 50,
                    "transitioned_dates": [
                      "2026-06-01",
                      "2026-06-29"
                    ]
                  },
                  "data": {
                    "countries": [
                      {
                        "country_code": "US",
                        "inbound_count": 18,
                        "outbound_count": 5,
                        "total_companies_with_signals": 23,
                        "exploring_count": 8,
                        "committing_count": 10,
                        "expanding_count": 4,
                        "scaling_count": 1,
                        "new_transitions_30d": 3,
                        "pairs_ahead_of_pace_30d": 1,
                        "freshest_transition_at": "2026-06-27T14:32:10.000Z"
                      }
                    ],
                    "top_flows": [
                      {
                        "home_country_code": "SG",
                        "country_code": "US",
                        "company_count": 5,
                        "new_transitions_30d": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "408": {
            "$ref": "#/components/responses/timeout_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/search": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Expansion Search",
        "description": "Find companies expanding into one or more markets using firmographic and signal filters or a plain-language query, with optional AI match explanations grounded in each company's real signals. Send at least one of `tos`, `froms`, `companies` or `query`.",
        "operationId": "expansions_search",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "froms": {
                    "$ref": "#/components/schemas/expansion_froms"
                  },
                  "tos": {
                    "$ref": "#/components/schemas/expansion_tos"
                  },
                  "exclude_froms": {
                    "$ref": "#/components/schemas/expansion_exclude_froms"
                  },
                  "exclude_tos": {
                    "$ref": "#/components/schemas/expansion_exclude_tos"
                  },
                  "stages": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_stages"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "momentum": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_momentum"
                      }
                    ],
                    "description": "Trajectory of the company's movement in the market. `advancing` is gaining ground, `steady` is holding, `pulling_back` covers retreat and contraction.\n\nDo **not** use the values from `directions` in [Expansion Reference](/en/api-reference/endpoint/expansions/types) here. Those (`advancing`, `steady`, `retreating`, `new`) are the *response* values you get back on `stage.direction`; only the three listed above are accepted as a *filter*. Sending `retreating` or `new` silently disables the filter and returns unfiltered results."
                  },
                  "freshness": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_freshness"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "scopes": {
                    "$ref": "#/components/schemas/expansion_scopes"
                  },
                  "ahead_of_pace": {
                    "type": "boolean",
                    "example": false,
                    "description": "Limit to pairs moving faster than the typical pace for that market."
                  },
                  "signal_types": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_signal_type_slugs"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "signal_strengths": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/signal_strengths"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "min_signal_count": {
                    "type": "integer",
                    "example": 3,
                    "description": "Minimum number of expansion signals a company must have in the window — \"very active / heavy footprint\"."
                  },
                  "only_contraction": {
                    "$ref": "#/components/schemas/only_contraction"
                  },
                  "min_markets": {
                    "type": "integer",
                    "example": 3,
                    "description": "Minimum number of new markets a company must have entered in the window."
                  },
                  "home_country_code": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "SG"
                    ],
                    "description": "Filter by company home country (ISO 3166-1 alpha-2). Intersects with `froms` when both are supplied."
                  },
                  "industries": {
                    "$ref": "#/components/schemas/industries"
                  },
                  "exclude_industries": {
                    "$ref": "#/components/schemas/exclude_industries"
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "keywords": {
                    "$ref": "#/components/schemas/keywords"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/expansion_companies"
                  },
                  "job_locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "job_exclude_locations": {
                    "$ref": "#/components/schemas/job_exclude_locations"
                  },
                  "job_posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "job_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "advertisement_target_locations": {
                    "$ref": "#/components/schemas/advertisement_target_locations"
                  },
                  "advertisement_exclude_target_locations": {
                    "$ref": "#/components/schemas/advertisement_exclude_target_locations"
                  },
                  "advertisement_search_terms": {
                    "$ref": "#/components/schemas/advertisement_search_terms"
                  },
                  "advertisement_start_dates": {
                    "$ref": "#/components/schemas/advertisement_start_dates"
                  },
                  "advertisement_end_dates": {
                    "$ref": "#/components/schemas/advertisement_end_dates"
                  },
                  "news_categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "transitioned_dates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "date"
                    },
                    "example": [
                      "2026-04-01",
                      "2026-06-29"
                    ],
                    "description": "ISO date range for the timeline window. Defaults to the last 90 days. A natural-language `query` may also set this from calendar phrases (\"this year\", \"last year\", \"Q2 2026\")."
                  },
                  "window_days": {
                    "$ref": "#/components/schemas/window_days"
                  },
                  "query": {
                    "type": "string",
                    "example": "fintech companies expanding into the UK",
                    "description": "Natural-language query that Pubrio interprets into expansion + company filters."
                  },
                  "is_explain_match": {
                    "type": "boolean",
                    "example": true,
                    "description": "Include AI-generated explanations of why each company matches the search, grounded in the company's real signals. Best paired with a natural-language query. The number of signals cited and the batch size both scale with `per_page`; high-volume sources (job postings, ad campaigns) are summarized as a window-scoped count (e.g. \"12 job postings\") rather than listed individually."
                  },
                  "sort_by": {
                    "$ref": "#/components/schemas/expansion_sort_by"
                  },
                  "is_include_metadata": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_is_include_metadata"
                      }
                    ],
                    "description": "Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`."
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "is_enable_similarity_search": {
                    "type": "boolean",
                    "description": "Enable free-text matching for `verticals`, `vertical_categories`, `vertical_sub_categories` and `technologies`. Without it, free-text values in those filters match nothing.",
                    "example": true
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/company_filter_conditions"
                  }
                },
                "anyOf": [
                  {
                    "title": "From Markets",
                    "required": [
                      "froms"
                    ]
                  },
                  {
                    "title": "To Markets",
                    "required": [
                      "tos"
                    ]
                  },
                  {
                    "title": "Plain-language Query",
                    "required": [
                      "query"
                    ]
                  },
                  {
                    "title": "Companies",
                    "required": [
                      "companies"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paginated list of companies expanding in the market(s). `filters` echoes the applied (or natural-language-interpreted) criteria; each company includes a `match_summary` when `is_explain_match` is true.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Search metadata: the filters actually applied, plus the market rollup (aggregate, geo scope, top origins/destinations/industries, timeline). API-key responses include the rollup only when `is_include_metadata` is true.",
                      "properties": {
                        "filters": {
                          "type": "object",
                          "description": "The filters as received. With `query`, the interpreted filters, where `country_codes` with `direction: inbound` corresponds to `tos`."
                        },
                        "relaxed_filters": {
                          "type": "array",
                          "description": "Soft filters auto-dropped when a natural-language query matched nothing; null otherwise.",
                          "items": {
                            "type": "string"
                          }
                        },
                        "nl_note": {
                          "type": "string",
                          "description": "Human-readable note when a natural-language query expressed no recognizable criteria; the list is empty in that case."
                        },
                        "nl_note_code": {
                          "type": "string",
                          "description": "Machine-readable code for nl_note (e.g. expansion.search.no_criteria)."
                        },
                        "aggregate": {
                          "type": "object",
                          "description": "Market-level rollup. Present when metadata is requested."
                        },
                        "country_code": {
                          "type": "string"
                        },
                        "country_codes": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "direction": {
                          "type": "string"
                        },
                        "is_global": {
                          "type": "boolean"
                        },
                        "is_multi": {
                          "type": "boolean"
                        },
                        "transitioned_dates": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "top_origins": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        },
                        "top_destinations": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        },
                        "top_industries": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        },
                        "timeline": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "description": "Result container (standard search envelope): the company list plus pagination.",
                      "properties": {
                        "pagination": {
                          "type": "object",
                          "description": "Page, per-page, total entries and total pages."
                        },
                        "companies": {
                          "type": "array",
                          "description": "The company list. Each item carries a nested `stage`; `match_summary` is included when `is_explain_match` is true. API-key responses also include `presence` (`level`: established | emerging | none | no_data; `matched_rule`: office | headcount | share) and a `read` object whose `code` is scaling | deepening | active | establishing (null when there is no local presence to read).",
                          "items": {
                            "type": "object"
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "tos": [
                        "GB"
                      ],
                      "verticals": [
                        "Financial Services"
                      ]
                    }
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 87,
                      "total_pages": 4,
                      "total_display_pages": 4,
                      "is_timeout": false
                    },
                    "companies": [
                      {
                        "expansion_id": "6845525",
                        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                        "country_code": "GB",
                        "target_country_code": "GB",
                        "domain": "example.com",
                        "company_name": "Example Corp",
                        "home_country_code": "CN",
                        "industry": "Consumer Electronics",
                        "founded_year": 2015,
                        "employees_count": 320,
                        "stage": {
                          "slug": "expanding",
                          "expansion_score": 0.72,
                          "scope": "entering_new_market",
                          "direction": "advancing",
                          "freshness": "fresh",
                          "signal_count": 27,
                          "distinct_type_count": 3,
                          "last_transition_at": "2026-06-27T14:32:10.000Z"
                        },
                        "presence": {
                          "level": "established",
                          "local_people_count": 12,
                          "matched_rule": "headcount",
                          "has_known_office": true,
                          "established_min": 10,
                          "share_of_detected": 0.54
                        },
                        "read": {
                          "code": "establishing"
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/companies/compare": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Compare company expansions",
        "description": "Compare the expansion footprint of several companies side by side, with optional comparable peers for a target company.",
        "operationId": "expansions_company_compare",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "companies": {
                    "$ref": "#/components/schemas/expansion_companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "transitioned_dates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "date"
                    },
                    "example": [
                      "2026-04-01",
                      "2026-06-29"
                    ],
                    "description": "ISO `[from, to]` date range for the signal/transition window. Takes precedence over `window_days` when both are supplied."
                  },
                  "window_days": {
                    "$ref": "#/components/schemas/window_days"
                  },
                  "seed_target": {
                    "type": "string",
                    "example": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                    "description": "The company in `companies` to treat as the benchmark target. The rest are ranked by signal volume and confidence, and the top peers are returned in `metadata.seeded_peers`. It selects from the list you send; it does not find new companies."
                  },
                  "is_include_established": {
                    "$ref": "#/components/schemas/expansion_is_include_established"
                  },
                  "is_include_metadata": {
                    "type": "boolean",
                    "description": "Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`.",
                    "example": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Per-company comparison, keyed by domain_search_id.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "seeded_peers": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "The peers selected for `seed_target`, best match first. Empty when `seed_target` is omitted."
                        },
                        "peer_cap": {
                          "type": "integer",
                          "nullable": true,
                          "description": "Maximum peers your plan may benchmark, or `null` when unlimited."
                        },
                        "peers_available": {
                          "type": "integer",
                          "description": "How many peers had signals in the window, before `peer_cap` was applied."
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "companies": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "One entry per company compared, in the order requested."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "seeded_peers": [
                      "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
                    ]
                  },
                  "data": {
                    "companies": [
                      {
                        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                        "home_country_code": "SG",
                        "firmographics": {
                          "company_name": "Example Corp",
                          "country_code": "SG",
                          "company_size": 350,
                          "founded_year": 2015,
                          "industry": "Software Development",
                          "publicly_traded_symbol": null,
                          "estimated_revenue": 25000000
                        },
                        "markets_summary": [
                          {
                            "country_code": "US",
                            "stage_slug": "committing",
                            "signal_count": 12,
                            "distinct_type_count": 4,
                            "first_signal_at": "2026-04-02T08:00:00.000Z",
                            "latest_signal_at": "2026-06-28T10:15:22.000Z",
                            "last_transition_at": "2026-06-25T14:30:00.000Z",
                            "expansion_score": 0.685,
                            "signals": [
                              {
                                "signal_type_slug": "EXEC",
                                "signal_subtype_slug": "country_manager",
                                "event_date": "2026-06-20T14:00:00.000Z",
                                "display_label": "Hired Regional VP for North America"
                              }
                            ]
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/companies/summaries": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Batch company expansion summaries",
        "description": "Ready-to-render expansion summaries for a batch of companies, prepared for side-by-side comparison without client-side aggregation.",
        "operationId": "expansions_company_summaries",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "companies": {
                    "$ref": "#/components/schemas/expansion_companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "transitioned_dates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "date"
                    },
                    "example": [
                      "2026-04-01",
                      "2026-06-29"
                    ],
                    "description": "ISO `[from, to]` date range for the signal/transition window. Takes precedence over `window_days` when both are supplied."
                  },
                  "window_days": {
                    "$ref": "#/components/schemas/window_days"
                  },
                  "is_include_established": {
                    "$ref": "#/components/schemas/expansion_is_include_established"
                  },
                  "is_include_metadata": {
                    "type": "boolean",
                    "description": "Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`.",
                    "example": true
                  }
                },
                "description": "Scope companies with a single `companies` array of mixed identifiers — `domain_search_id`, company domain, or LinkedIn URL — matched as a union (not intersected). The legacy `domain_search_ids`, `domains`, and `linkedin_urls` keys remain accepted for backward compatibility. Up to 25 resolved companies per request."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Array of per-company expansion summaries. Two scores: top-level `expansion_score` is the overall current posture across all markets (stable); `summary.window_expansion_score` is the same measure scoped to the selected window. Both are on a 0-100 scale here (unlike the 0-1 `stage.expansion_score` on search results). When your plan does not include employee counts, `firmographics` returns `company_size`, `employees_count`, and `company_size_printed` as null and sets `is_employees_locked: true`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "companies": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "One ready-to-render summary per company requested."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {},
                  "data": {
                    "companies": [
                      {
                        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                        "home_country_code": "SG",
                        "expansion_score": 82,
                        "firmographics": {
                          "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                          "company_name": "Example Corp",
                          "domain": "example.com",
                          "logo_url": "https://logo.pubrio.com/example.com.png",
                          "country_code": "SG",
                          "company_size": null,
                          "employees_count": 350,
                          "company_size_printed": "351+",
                          "is_employees_locked": false,
                          "founded_year": 2015,
                          "industry": "Software Development",
                          "publicly_traded_symbol": null,
                          "estimated_revenue": 25000000
                        },
                        "markets_summary": [
                          {
                            "country_code": "US",
                            "stage_slug": "committing",
                            "signal_count": 12,
                            "distinct_type_count": 4,
                            "first_signal_at": "2026-04-02T08:00:00.000Z",
                            "latest_signal_at": "2026-06-28T10:15:22.000Z",
                            "last_transition_at": "2026-06-25T14:30:00.000Z",
                            "expansion_score": 0.685,
                            "signals": [
                              {
                                "signal_type_slug": "EXEC",
                                "signal_subtype_slug": "country_manager",
                                "event_date": "2026-06-20T14:00:00.000Z",
                                "display_label": "Hired Regional VP for North America"
                              }
                            ]
                          }
                        ],
                        "signal_weekly_totals": [
                          {
                            "week_start": "2026-06-22",
                            "signal_type_slug": "HIRE",
                            "count": 5
                          }
                        ],
                        "summary": {
                          "active_markets": 1,
                          "total_markets": 1,
                          "new_markets": 1,
                          "momentum_pct": 22,
                          "signal_count": 12,
                          "window_expansion_score": 69,
                          "scaling": 0,
                          "pipeline": 1,
                          "top_market": {
                            "country_code": "US",
                            "country": null,
                            "stage": "committing"
                          },
                          "newest_market": {
                            "country_code": "US",
                            "country": null,
                            "stage": "committing"
                          },
                          "activity_weekly": [
                            3,
                            5,
                            4
                          ]
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/companies/lookup": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Company expansion detail",
        "description": "In-depth expansion profile for a single company — current stage, signals, market presence, and stage-transition history — for one market or aggregated across all markets.",
        "operationId": "expansions_company_lookup",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "country_code": {
                    "$ref": "#/components/schemas/expansion_country_code"
                  },
                  "is_all_markets": {
                    "$ref": "#/components/schemas/expansion_is_all_markets"
                  },
                  "signal_type": {
                    "type": "string",
                    "enum": [
                      "AD",
                      "AUDIENCE",
                      "DNS",
                      "ENTITY",
                      "EVENT",
                      "EVENT_PLUS",
                      "EXEC",
                      "HIRE",
                      "INFRA",
                      "IP",
                      "NEWS",
                      "OFFICE",
                      "PARTNER",
                      "PRODUCT",
                      "REG",
                      "SCALE",
                      "TECH"
                    ],
                    "example": "EXEC",
                    "description": "Filter the returned signals to a single type."
                  },
                  "query": {
                    "type": "string",
                    "example": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.",
                    "description": "Plain-language description of what you sell, or the buyer profile you're evaluating this company against. Used only to ground the AI `summary` (see `is_explain_match`); unlike the company search, it is NOT interpreted into filters here."
                  },
                  "is_explain_match": {
                    "type": "boolean",
                    "example": true,
                    "description": "When true and a `query` is supplied, `summary` returns a single AI summary of this company's expansion activity in the current scope (the selected market, or all foreign markets when `is_all_markets` is true), read against your `query` and grounded in the company's real signals with `[n]` citations."
                  },
                  "window_days": {
                    "type": "integer",
                    "example": 90,
                    "default": 90,
                    "description": "Optional. Rolling window (in days) that bounds the AI `summary` feed. Defaults to **90** when neither this nor `transitioned_dates` is supplied. Does not affect the paginated `signals` list (full history)."
                  },
                  "transitioned_dates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "date"
                    },
                    "example": [
                      "2026-04-01",
                      "2026-06-29"
                    ],
                    "description": "ISO `[from, to]` date range for the signal/transition window. Takes precedence over `window_days` when both are supplied."
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  },
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "is_include_established": {
                    "$ref": "#/components/schemas/expansion_is_include_established"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "is_include_metadata": {
                    "type": "boolean",
                    "description": "Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`.",
                    "example": true
                  },
                  "summary_only": {
                    "type": "boolean",
                    "description": "Return the stage summary block (`data`, `company`, `markets_summary`, `signal_weekly_totals`, `recent_signals`, `expansion_score`, `summary`) and skip the paginated signal list and its aggregates.",
                    "example": true
                  },
                  "markets_summary_full": {
                    "type": "boolean",
                    "description": "Include the full ranked market set as `markets_summary` alongside the capped `other_markets` list.",
                    "example": true
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Company-in-market detail.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object"
                    },
                    "data": {
                      "type": "object",
                      "description": "Result container.",
                      "properties": {
                        "domain_search_id": {
                          "type": "string",
                          "description": "Pubrio company identifier."
                        },
                        "country_code": {
                          "type": "string",
                          "description": "Target market, ISO 3166-1 alpha-2."
                        },
                        "country_name": {
                          "type": "string",
                          "description": "Target market name."
                        },
                        "stage_rank": {
                          "type": "integer",
                          "description": "Numeric rank of the stage, higher is further along."
                        },
                        "stage_name": {
                          "type": "string",
                          "description": "Display name of the stage."
                        },
                        "stage": {
                          "type": "object",
                          "description": "Stage detail — score, scope, direction, freshness and signal counts."
                        },
                        "local_people_count": {
                          "type": "integer",
                          "description": "Employees located in the target market."
                        },
                        "local_people_coverage": {
                          "type": "boolean",
                          "description": "Whether headcount coverage is sufficient to trust the count."
                        },
                        "presence": {
                          "type": "object",
                          "description": "In-market footprint: how settled the company already is, independent of its expansion stage.",
                          "properties": {
                            "level": {
                              "type": "string",
                              "enum": [
                                "established",
                                "emerging",
                                "none",
                                "no_data"
                              ],
                              "description": "How settled the company's footprint in this market is: `established`, `emerging`, `none`, or `no_data`. This is the footprint, not the expansion stage."
                            },
                            "local_people_count": {
                              "type": "integer",
                              "description": "Employees located in the target market."
                            },
                            "matched_rule": {
                              "type": "string",
                              "nullable": true,
                              "description": "Which signal established the level — for example `office`, `headcount` or `share`. `null` when no rule matched."
                            }
                          }
                        },
                        "read": {
                          "type": "object",
                          "description": "Read status for this record."
                        }
                      }
                    },
                    "signals": {
                      "type": "array",
                      "description": "The paginated signal rows behind this company/market pair — the evidence list. Page size and totals come from `metadata.pagination`.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "summary": {
                      "type": "object",
                      "description": "One-line stage summary for the pair. First page only."
                    },
                    "company": {
                      "type": "object",
                      "description": "Company chrome — name, domain, logo and social URLs. First page only."
                    },
                    "signal_group_totals": {
                      "type": "object",
                      "description": "Signal counts per type, bucketed by day in your timezone. First page only.",
                      "additionalProperties": {
                        "type": "integer"
                      }
                    },
                    "signal_type_totals": {
                      "type": "object",
                      "description": "All-time signal totals per signal type. First page only.",
                      "additionalProperties": {
                        "type": "integer"
                      }
                    },
                    "signal_type_recent_totals": {
                      "type": "object",
                      "description": "Signal totals per type over the trailing 12 weeks. First page only.",
                      "additionalProperties": {
                        "type": "integer"
                      }
                    },
                    "signal_weekly_totals": {
                      "type": "array",
                      "description": "Weekly signal counts for the heatmap, same window as `signal_type_recent_totals`. First page only.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "evidence_breakdown": {
                      "type": "object",
                      "description": "Evidence roll-up by source type, computed from the returned (redacted) signals. First page only."
                    },
                    "presence": {
                      "type": "array",
                      "description": "Observed physical and digital presence for the company in this market. First page only.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "suppressions": {
                      "type": "array",
                      "description": "Signals suppressed from the stage calculation, with the reason for each. First page only.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "timeline": {
                      "type": "array",
                      "description": "Stage-transition history for this company/market pair. First page only.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "other_markets": {
                      "type": "array",
                      "description": "The company's other active markets. Capped on limited plans — see `other_markets_locked_count`. First page only.",
                      "items": {
                        "type": "object"
                      }
                    },
                    "other_markets_locked_count": {
                      "type": "integer",
                      "description": "How many additional markets your plan did not return in `other_markets`. `0` when nothing was withheld."
                    },
                    "markets_summary": {
                      "type": "array",
                      "description": "Full ranked market set for this company. Returned only when `markets_summary_full` is `true`, on the first page.",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                      "country_code": "US"
                    },
                    "country_code_auto_picked": false,
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 12,
                      "total_pages": 1,
                      "total_display_pages": 1,
                      "is_timeout": false
                    }
                  },
                  "data": {
                    "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                    "country_code": "US",
                    "country_name": "United States",
                    "stage_rank": 3,
                    "stage_name": "Expanding",
                    "stage": {
                      "slug": "expanding",
                      "expansion_score": 0.721,
                      "scope": "entering_new_market",
                      "direction": "advancing",
                      "freshness": "fresh",
                      "contraction_flag": null,
                      "mode_change_flag": false,
                      "signal_count": 5,
                      "distinct_type_count": 3,
                      "has_known_presence": false,
                      "first_signal_at": "2026-05-30T09:00:00.000Z",
                      "latest_signal_at": "2026-06-20T14:00:00.000Z",
                      "last_transition_at": "2026-06-15T09:30:00.000Z"
                    }
                  },
                  "signals": [
                    {
                      "signal_type_slug": "EXEC",
                      "signal_subtype_slug": "country_manager",
                      "signal_strength_slug": "high",
                      "polarity": "expansion",
                      "event_date": "2026-06-20T14:00:00.000Z",
                      "source_type": "linkedin",
                      "display_label": "Hired Regional VP for North America",
                      "evidence_url": "https://linkedin.com/company/example-corp",
                      "source_published_at": "2026-06-20T14:00:00.000Z",
                      "lead_time_days": 0
                    }
                  ],
                  "presence": [
                    {
                      "presence_type": "office",
                      "presence_strength": "high",
                      "address": "123 Market St, San Francisco, CA",
                      "known_since": "2026-03-15T00:00:00.000Z"
                    }
                  ],
                  "timeline": [
                    {
                      "stage_slug": "expanding",
                      "transitioned_at": "2026-06-15T09:30:00.000Z",
                      "transition_kind": "advance"
                    }
                  ],
                  "other_markets": [
                    {
                      "country_code": "CA",
                      "stage_slug": "committing",
                      "signal_count": 8,
                      "first_signal_at": "2026-04-10T00:00:00.000Z",
                      "latest_signal_at": "2026-06-22T16:45:00.000Z",
                      "last_transition_at": "2026-06-18T00:00:00.000Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/companies/pulse_events": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Company Signal Events",
        "description": "Enriched, paginated drill-down into the signal events driving a single company's expansion.",
        "operationId": "expansions_company_pulse_events",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "signal_types": {
                    "$ref": "#/components/schemas/expansion_signal_type_slugs"
                  },
                  "country_codes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "JP",
                      "SG"
                    ],
                    "description": "Optional. Scope the feed to one or more foreign markets (ISO 3166-1 alpha-2, e.g. `[\"JP\",\"SG\"]`). Omitted → all foreign markets (the home market is always excluded)."
                  },
                  "transitioned_dates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "date"
                    },
                    "example": [
                      "2026-04-01",
                      "2026-06-29"
                    ],
                    "description": "ISO `[from, to]` date range for the signal/transition window. Takes precedence over `window_days` when both are supplied."
                  },
                  "window_days": {
                    "type": "integer",
                    "example": 90,
                    "default": 90,
                    "description": "Optional. Size of the rolling events window in days. Defaults to **90** (the standard display window) when neither this nor `transitioned_dates` is supplied. `transitioned_dates` takes precedence when both are sent."
                  },
                  "query": {
                    "type": "string",
                    "example": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.",
                    "description": "Plain-language description of what you sell, or the buyer profile you're evaluating this company against. Used only to ground the AI `summary` (see `is_explain_match`); unlike the company search, it is NOT interpreted into filters here."
                  },
                  "is_explain_match": {
                    "type": "boolean",
                    "example": true,
                    "description": "When true and a `query` is supplied, `data.summary` returns a single AI summary of this company's expansion activity read against your `query`, grounded in the company's real signals with `[n]` citations. Unlike the company search's per-company `match_summary`, this summary is built from the company's ENTIRE feed for the window (all markets, every signal), so it is stable regardless of `page` / `per_page`."
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "linkedin_url": {
                    "$ref": "#/components/schemas/company_linkedin_url"
                  },
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  }
                },
                "anyOf": [
                  {
                    "title": "Domain Search ID",
                    "required": [
                      "domain_search_id"
                    ]
                  },
                  {
                    "title": "Domain",
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "title": "LinkedIn URL",
                    "required": [
                      "linkedin_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paginated signal events. When `is_explain_match` is true and a `query` is supplied, `data.summary` holds an AI summary (`{ text, citations }`) of the company's full-feed activity read against the query; it is `null` otherwise.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object"
                    },
                    "data": {
                      "type": "object",
                      "description": "Result container.",
                      "properties": {
                        "pagination": {
                          "type": "object",
                          "description": "Page, per-page, total entries and total pages."
                        },
                        "events": {
                          "type": "array",
                          "description": "Signal events for this company, newest first.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "summary": {
                          "type": "object",
                          "description": "Optional roll-up of the events on this page; `null` when not computed.",
                          "nullable": true
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
                    }
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 42,
                      "total_pages": 2,
                      "total_display_pages": 2,
                      "is_timeout": false
                    },
                    "events": [
                      {
                        "signal_type_slug": "EXEC",
                        "stage_slug": "expanding",
                        "country_code": "US",
                        "signal_subtype_slug": "country_manager",
                        "source_type": "linkedin",
                        "polarity": "expansion",
                        "display_label": "Hired Country Manager",
                        "evidence_url": "https://linkedin.com/company/example-corp",
                        "event_date": "2026-06-20T14:00:00.000Z"
                      }
                    ],
                    "summary": {
                      "text": "Example Corp is hiring across Tokyo[1] and just added a Japan Country Manager[2], yet has no legal entity on file — it is staffing the market before incorporating, which is exactly your window.",
                      "citations": [
                        {
                          "n": 1,
                          "type": "HIRE",
                          "label": "Tokyo software & field-ops roles",
                          "country": "JP",
                          "date": "2026-06",
                          "url": null
                        },
                        {
                          "n": 2,
                          "type": "EXEC",
                          "label": "Country Manager, Japan",
                          "country": "JP",
                          "date": "2026-06",
                          "url": "https://linkedin.com/in/example"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/companies/rankings": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Expansion Rankings",
        "description": "Lightweight ranked list of company/market pairs by expansion score — suited to map or heatmap rendering.",
        "operationId": "expansions_company_rankings",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "froms": {
                    "$ref": "#/components/schemas/expansion_froms"
                  },
                  "tos": {
                    "$ref": "#/components/schemas/expansion_tos"
                  },
                  "exclude_froms": {
                    "$ref": "#/components/schemas/expansion_exclude_froms"
                  },
                  "exclude_tos": {
                    "$ref": "#/components/schemas/expansion_exclude_tos"
                  },
                  "stages": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_stages"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "signal_types": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_signal_type_slugs"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "signal_strengths": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/signal_strengths"
                      }
                    ],
                    "description": "Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."
                  },
                  "min_signal_count": {
                    "type": "integer",
                    "example": 3,
                    "description": "Minimum number of expansion signals a company must have in the window — \"very active / heavy footprint\"."
                  },
                  "only_contraction": {
                    "$ref": "#/components/schemas/only_contraction"
                  },
                  "domain_search_ids": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_domain_search_ids"
                      }
                    ],
                    "description": "Companies to restrict to, by `domain_search_id`."
                  },
                  "verticals": {
                    "$ref": "#/components/schemas/verticals"
                  },
                  "vertical_categories": {
                    "$ref": "#/components/schemas/vertical_categories"
                  },
                  "vertical_sub_categories": {
                    "$ref": "#/components/schemas/vertical_sub_categories"
                  },
                  "technologies": {
                    "$ref": "#/components/schemas/technologies"
                  },
                  "employees": {
                    "$ref": "#/components/schemas/employees"
                  },
                  "revenues": {
                    "$ref": "#/components/schemas/revenues"
                  },
                  "founded_dates": {
                    "$ref": "#/components/schemas/founded_dates"
                  },
                  "keywords": {
                    "$ref": "#/components/schemas/keywords"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/expansion_companies"
                  },
                  "job_locations": {
                    "$ref": "#/components/schemas/locations"
                  },
                  "job_exclude_locations": {
                    "$ref": "#/components/schemas/job_exclude_locations"
                  },
                  "job_posted_dates": {
                    "$ref": "#/components/schemas/posted_dates"
                  },
                  "job_titles": {
                    "$ref": "#/components/schemas/people_titles"
                  },
                  "advertisement_target_locations": {
                    "$ref": "#/components/schemas/advertisement_target_locations"
                  },
                  "advertisement_exclude_target_locations": {
                    "$ref": "#/components/schemas/advertisement_exclude_target_locations"
                  },
                  "advertisement_search_terms": {
                    "$ref": "#/components/schemas/advertisement_search_terms"
                  },
                  "advertisement_start_dates": {
                    "$ref": "#/components/schemas/advertisement_start_dates"
                  },
                  "advertisement_end_dates": {
                    "$ref": "#/components/schemas/advertisement_end_dates"
                  },
                  "news_categories": {
                    "$ref": "#/components/schemas/news_categories"
                  },
                  "news_published_dates": {
                    "$ref": "#/components/schemas/published_dates"
                  },
                  "is_include_established": {
                    "$ref": "#/components/schemas/expansion_is_include_established"
                  },
                  "select_size": {
                    "$ref": "#/components/schemas/expansion_select_size"
                  },
                  "is_include_metadata": {
                    "type": "boolean",
                    "description": "Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`.",
                    "example": true
                  },
                  "is_enable_similarity_search": {
                    "type": "boolean",
                    "description": "Enable free-text matching for `verticals`, `vertical_categories`, `vertical_sub_categories` and `technologies`; those filters are dropped unless this is `true`.",
                    "example": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ranked company/market markers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object"
                    },
                    "data": {
                      "type": "object",
                      "description": "Result container.",
                      "properties": {
                        "markers": {
                          "type": "array",
                          "description": "One row per company/market pair, ranked by expansion score.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "domain_search_id": {
                                "type": "string",
                                "description": "Pubrio company identifier."
                              },
                              "country_code": {
                                "type": "string",
                                "description": "Target market, ISO 3166-1 alpha-2."
                              },
                              "stage_slug": {
                                "type": "string",
                                "description": "Current expansion stage."
                              },
                              "expansion_score": {
                                "type": "integer",
                                "description": "Expansion score for this company/market pair."
                              },
                              "freshness": {
                                "type": "string",
                                "description": "How recent the underlying signals are."
                              },
                              "direction": {
                                "type": "string",
                                "description": "Trajectory of the stage."
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "froms": [
                        "CN"
                      ],
                      "tos": [
                        "GB"
                      ]
                    },
                    "select_size": 250,
                    "count": 1
                  },
                  "data": {
                    "markers": [
                      {
                        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                        "country_code": "US",
                        "stage_slug": "expanding",
                        "expansion_score": 0.721,
                        "freshness": "fresh",
                        "direction": "advancing"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/types": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Expansion Filters",
        "description": "Reference catalog for the expansion taxonomy — stages, signal types, strengths, polarities, momentum, and freshness — used to resolve the values returned by the other expansion endpoints.",
        "operationId": "expansions_types",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The expansion taxonomy.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "description": "Result container.",
                      "properties": {
                        "stages": {
                          "type": "array",
                          "description": "Expansion stages, in rank order.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "signal_types": {
                          "type": "array",
                          "description": "Signal types, with tier and availability.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "signal_subtypes": {
                          "type": "array",
                          "description": "Signal subtypes, each keyed to its parent type.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "signal_subtypes_by_type": {
                          "type": "object",
                          "description": "Subtypes grouped by parent signal type."
                        },
                        "signal_strengths": {
                          "type": "array",
                          "description": "Signal strength levels.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "dimensions": {
                          "type": "array",
                          "description": "Scoring dimensions behind the expansion score.",
                          "items": {
                            "type": "object"
                          }
                        },
                        "polarities": {
                          "type": "array",
                          "description": "Accepted polarity values.",
                          "items": {
                            "type": "string"
                          }
                        },
                        "directions": {
                          "type": "array",
                          "description": "Direction values returned in `stage.direction`.",
                          "items": {
                            "type": "string"
                          }
                        },
                        "freshness": {
                          "type": "array",
                          "description": "How recent the underlying signals are.",
                          "items": {
                            "type": "string"
                          }
                        },
                        "event_date_precisions": {
                          "type": "array",
                          "description": "Precision levels for an event date.",
                          "items": {
                            "type": "string"
                          }
                        },
                        "presence_types": {
                          "type": "array",
                          "description": "Presence classifications.",
                          "items": {
                            "type": "string"
                          }
                        },
                        "max_record_upload_size": {
                          "type": "integer",
                          "description": "Maximum records accepted per batch upload."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "stages": [
                      {
                        "slug": "exploring",
                        "rank_order": 1,
                        "name": {
                          "en": "Exploring"
                        }
                      },
                      {
                        "slug": "scaling",
                        "rank_order": 4,
                        "name": {
                          "en": "Scaling"
                        }
                      }
                    ],
                    "signal_types": [
                      {
                        "slug": "HIRE",
                        "name": {
                          "en": "Hiring"
                        },
                        "tier": "standard",
                        "is_available": true
                      },
                      {
                        "slug": "INFRA",
                        "name": {
                          "en": "Infrastructure"
                        },
                        "tier": "premier",
                        "is_available": true
                      }
                    ],
                    "signal_strengths": [
                      {
                        "slug": "low",
                        "name": {
                          "en": "Low"
                        }
                      },
                      {
                        "slug": "very_high",
                        "name": {
                          "en": "Very High"
                        }
                      }
                    ],
                    "polarities": [
                      "expansion",
                      "contraction_leading",
                      "contraction_confirming",
                      "contraction_lagging"
                    ],
                    "directions": [
                      "advancing",
                      "steady",
                      "retreating",
                      "new"
                    ],
                    "freshness": [
                      "fresh",
                      "cooling",
                      "stale",
                      "cold"
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/expansions/signals/search": {
      "post": {
        "tags": [
          "Expansion"
        ],
        "summary": "Expansion Signal Search",
        "operationId": "expansions_signals_search",
        "description": "Raw, paginated expansion signal rows — the dated evidence behind each company's stage, with source and evidence URL.",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain_search_ids": {
                    "type": "array",
                    "description": "Companies to restrict to, by `domain_search_id`.",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
                    ]
                  },
                  "is_active": {
                    "type": "boolean",
                    "description": "`true` (the default) returns live signals only; `false` returns retracted signals only.",
                    "example": true,
                    "default": true
                  },
                  "country_codes": {
                    "type": "array",
                    "description": "Target markets to restrict to, as ISO 3166-1 alpha-2 codes.",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "US",
                      "GB"
                    ]
                  },
                  "signal_types": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_signal_type_slugs"
                      }
                    ],
                    "description": "Signal types to restrict to. Unknown values match nothing."
                  },
                  "providers": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Hosting or cloud providers of DNS signals, as named by Cloud Footprint Search."
                  },
                  "exclude_providers": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Providers to leave out."
                  },
                  "cloud_regions": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Provider region codes of DNS signals, e.g. eu-central-1."
                  },
                  "exclude_cloud_regions": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Region codes to leave out."
                  },
                  "cities": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Data-centre cities of DNS signals."
                  },
                  "exclude_cities": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Cities to leave out."
                  },
                  "signal_subtypes": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/expansion_signal_subtype_slugs"
                      }
                    ],
                    "description": "Signal subtypes to restrict to. Unknown values match nothing."
                  },
                  "signal_strengths": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/signal_strengths"
                      }
                    ],
                    "description": "Signal strengths to restrict to. Unknown values match nothing."
                  },
                  "source_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Source types to restrict to: `jobs`, `ads`, `linkedin`, `news`, `pubrio`.",
                    "example": [
                      "jobs",
                      "ads"
                    ]
                  },
                  "polarities": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "expansion",
                        "contraction_leading",
                        "contraction_confirming",
                        "contraction_lagging"
                      ]
                    },
                    "description": "Signal directions to include. `expansion` marks entry and growth; the `contraction_*` values mark retreat.",
                    "example": [
                      "expansion"
                    ]
                  },
                  "event_dates": {
                    "$ref": "#/components/schemas/event_dates"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Expansion Signal Search",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "type": "object",
                      "description": "Echo of the filters applied to this request."
                    },
                    "data": {
                      "type": "object",
                      "description": "Result container.",
                      "properties": {
                        "pagination": {
                          "type": "object",
                          "description": "Page, per-page, total entries and total pages."
                        },
                        "signals": {
                          "type": "array",
                          "description": "The matching signal rows, newest first.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "expansion_signal_id": {
                                "type": "integer",
                                "description": "Unique identifier for this signal row."
                              },
                              "domain_search_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "The company this signal belongs to. Use it with [Company Expansion Detail](/en/api-reference/endpoint/expansions/company_lookup)."
                              },
                              "country_code": {
                                "type": "string",
                                "description": "Target market this signal was observed in, as an ISO 3166-1 alpha-2 code."
                              },
                              "signal_type_slug": {
                                "type": "string",
                                "description": "Signal type. One of the 17 slugs returned by [Expansion Reference](/en/api-reference/endpoint/expansions/types)."
                              },
                              "signal_subtype_slug": {
                                "type": "string",
                                "nullable": true,
                                "description": "Finer-grained subtype, or `null` when the type has no subtype. About 44% of rows are `null`."
                              },
                              "signal_strength_slug": {
                                "type": "string",
                                "description": "Signal strength: `low`, `medium`, `high` or `very_high`."
                              },
                              "polarity": {
                                "type": "string",
                                "description": "Signal direction: `expansion`, or one of the three `contraction_*` values."
                              },
                              "event_date": {
                                "type": "string",
                                "format": "date-time",
                                "description": "When the underlying event happened. Read together with `event_date_precision`."
                              },
                              "event_date_precision": {
                                "type": "string",
                                "description": "How precise `event_date` is: `day`, `month`, `quarter`, `year` or `unknown`."
                              },
                              "source_type": {
                                "type": "string",
                                "description": "Where the signal came from. Observed values: `jobs`, `ads`, `linkedin`, `news`, `pubrio`."
                              },
                              "source_record_id": {
                                "type": "string",
                                "nullable": true,
                                "description": "Identifier of the source record the signal was derived from, when one exists."
                              },
                              "display_label": {
                                "type": "string",
                                "description": "Human-readable one-line summary of the signal."
                              },
                              "evidence_url": {
                                "type": "string",
                                "nullable": true,
                                "description": "Link to the supporting evidence. Frequently `null` — most rows are derived from structured sources rather than a citable page."
                              },
                              "metadata": {
                                "type": "object",
                                "description": "Source-specific detail. Its keys vary by `source_type` — job rows carry `departments`, `seniority`, `top_titles`, `active_postings`; ad rows carry `advertisement_format`, `headline`, `share_pct`."
                              },
                              "extraction_confidence": {
                                "type": "number",
                                "nullable": true,
                                "description": "Model confidence for signals extracted by a model, otherwise `null`."
                              },
                              "extraction_model": {
                                "type": "string",
                                "nullable": true,
                                "description": "Name of the extracting model, when one was used."
                              },
                              "is_active": {
                                "type": "boolean",
                                "description": "`true` for live signals, `false` once a signal has been retracted."
                              },
                              "notes": {
                                "type": "string",
                                "nullable": true,
                                "description": "Free-text annotation. Usually `null`."
                              },
                              "created_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "When the signal row was created."
                              },
                              "last_modified": {
                                "type": "string",
                                "format": "date-time",
                                "description": "When the signal row was last updated."
                              },
                              "source_published_at": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true,
                                "description": "Publication time of the source document, when known."
                              },
                              "lead_time_days": {
                                "type": "integer",
                                "nullable": true,
                                "description": "Days between the source being published and the event date, when both are known."
                              },
                              "occurs_at": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true,
                                "description": "Start of the window the signal covers, for signals that span a period."
                              },
                              "occurs_until": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true,
                                "description": "End of the window the signal covers, for signals that span a period."
                              },
                              "audit": {
                                "type": "object",
                                "description": "Provenance of the row: `profile_id` and `user_id` are set for user-imported signals, `import_id` groups a bulk import, and `is_backfill` marks rows added by a historical backfill.",
                                "properties": {
                                  "profile_id": {
                                    "type": "integer",
                                    "nullable": true
                                  },
                                  "user_id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "nullable": true
                                  },
                                  "import_id": {
                                    "type": "string",
                                    "nullable": true
                                  },
                                  "is_backfill": {
                                    "type": "boolean"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "metadata": {
                    "filters": {
                      "domain_search_ids": [
                        "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
                      ],
                      "country_codes": [
                        "US"
                      ],
                      "signal_types": [
                        "HIRE",
                        "AD"
                      ]
                    }
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 25,
                      "total_entries": 2990,
                      "total_pages": 120
                    },
                    "signals": [
                      {
                        "expansion_signal_id": 580965556,
                        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                        "country_code": "US",
                        "signal_type_slug": "HIRE",
                        "signal_subtype_slug": "country_manager",
                        "signal_strength_slug": "very_high",
                        "polarity": "expansion",
                        "event_date": "2026-06-20T14:00:00.000Z",
                        "event_date_precision": "day",
                        "source_type": "jobs",
                        "source_record_id": "4224659596",
                        "display_label": "Hired Country Manager",
                        "evidence_url": "https://www.linkedin.com/jobs/view/4224659596",
                        "metadata": {
                          "city": "Austin",
                          "country_code": "US",
                          "departments": [
                            "sales"
                          ],
                          "seniority": [
                            "director"
                          ],
                          "top_titles": [
                            "Country Manager, US"
                          ],
                          "active_postings": 3,
                          "window_days": 90
                        },
                        "extraction_confidence": 0.91,
                        "extraction_model": null,
                        "is_active": true,
                        "notes": null,
                        "created_at": "2026-06-20T15:02:11.004Z",
                        "last_modified": "2026-06-20T15:02:11.004Z",
                        "source_published_at": "2026-06-19T08:00:00.000Z",
                        "lead_time_days": 1,
                        "occurs_at": null,
                        "occurs_until": null,
                        "audit": {
                          "profile_id": null,
                          "user_id": null,
                          "import_id": null,
                          "is_backfill": false
                        }
                      },
                      {
                        "expansion_signal_id": 580965557,
                        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
                        "country_code": "US",
                        "signal_type_slug": "AD",
                        "signal_subtype_slug": null,
                        "signal_strength_slug": "low",
                        "polarity": "expansion",
                        "event_date": "2026-06-18T08:12:25.866Z",
                        "event_date_precision": "day",
                        "source_type": "ads",
                        "source_record_id": "3569a83d-6e96-4bc9-b1a7-abbfa8f4b1ad",
                        "display_label": "Full-Stack Observability: 7 Tools Engineers Are Switching To in 2026",
                        "evidence_url": null,
                        "metadata": {
                          "headline": "Full-Stack Observability: 7 Tools Engineers Are Switching To in 2026",
                          "advertisement_format": "Single Image Ad",
                          "source_type": "linkedin",
                          "share_basis": "declared",
                          "share_pct": null,
                          "started_at": null,
                          "ended_at": null
                        },
                        "extraction_confidence": null,
                        "extraction_model": null,
                        "is_active": true,
                        "notes": null,
                        "created_at": "2026-06-18T08:12:25.883Z",
                        "last_modified": "2026-06-18T08:12:25.883Z",
                        "source_published_at": null,
                        "lead_time_days": null,
                        "occurs_at": null,
                        "occurs_until": null,
                        "audit": {
                          "profile_id": null,
                          "user_id": null,
                          "import_id": null,
                          "is_backfill": false
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        },
        "x-mint": {
          "content": "<Warning>\nScope every call — pass `domain_search_ids`, or `country_codes` with `event_dates`. Unscoped and date-only requests are dropped at the gateway with **HTTP 524**.\n</Warning>"
        }
      }
    },
    "/companies/cloud_footprints/search": {
      "post": {
        "tags": [
          "Search"
        ],
        "summary": "Search for company cloud footprints",
        "description": "Search the public cloud and hosting footprint of companies: which providers, countries and regions they run infrastructure in. Each row is one company at one provider in one country. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search).",
        "operationId": "companies_search_cloud_footprints",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "providers": {
                    "$ref": "#/components/schemas/providers"
                  },
                  "exclude_providers": {
                    "$ref": "#/components/schemas/exclude_providers"
                  },
                  "target_locations": {
                    "$ref": "#/components/schemas/target_locations"
                  },
                  "exclude_target_locations": {
                    "$ref": "#/components/schemas/exclude_target_locations"
                  },
                  "cloud_regions": {
                    "$ref": "#/components/schemas/cloud_regions"
                  },
                  "exclude_cloud_regions": {
                    "$ref": "#/components/schemas/exclude_cloud_regions"
                  },
                  "cities": {
                    "$ref": "#/components/schemas/cities"
                  },
                  "exclude_cities": {
                    "$ref": "#/components/schemas/exclude_cities"
                  },
                  "first_seen_dates": {
                    "$ref": "#/components/schemas/first_seen_dates"
                  },
                  "last_seen_dates": {
                    "$ref": "#/components/schemas/last_seen_dates"
                  },
                  "is_cross_border_only": {
                    "$ref": "#/components/schemas/is_cross_border_only"
                  },
                  "host_count": {
                    "$ref": "#/components/schemas/host_count"
                  },
                  "server_count": {
                    "$ref": "#/components/schemas/server_count"
                  },
                  "shared_server_count": {
                    "$ref": "#/components/schemas/shared_server_count"
                  },
                  "region_count": {
                    "$ref": "#/components/schemas/region_count"
                  },
                  "city_count": {
                    "$ref": "#/components/schemas/city_count"
                  },
                  "cloud_footprint_host_count": {
                    "$ref": "#/components/schemas/cloud_footprint_host_count"
                  },
                  "cloud_footprint_server_count": {
                    "$ref": "#/components/schemas/cloud_footprint_server_count"
                  },
                  "cloud_footprint_shared_server_count": {
                    "$ref": "#/components/schemas/cloud_footprint_shared_server_count"
                  },
                  "cloud_footprint_provider_count": {
                    "$ref": "#/components/schemas/cloud_footprint_provider_count"
                  },
                  "cloud_footprint_country_count": {
                    "$ref": "#/components/schemas/cloud_footprint_country_count"
                  },
                  "cloud_footprint_cross_border_country_count": {
                    "$ref": "#/components/schemas/cloud_footprint_cross_border_country_count"
                  },
                  "cloud_footprint_region_count": {
                    "$ref": "#/components/schemas/cloud_footprint_region_count"
                  },
                  "cloud_footprint_city_count": {
                    "$ref": "#/components/schemas/cloud_footprint_city_count"
                  },
                  "company_locations": {
                    "$ref": "#/components/schemas/company_locations"
                  },
                  "cloud_footprint_id": {
                    "$ref": "#/components/schemas/cloud_footprint_id"
                  },
                  "cloud_footprint_ids": {
                    "$ref": "#/components/schemas/cloud_footprint_ids"
                  },
                  "companies": {
                    "$ref": "#/components/schemas/companies"
                  },
                  "domains": {
                    "$ref": "#/components/schemas/domains"
                  },
                  "per_page": {
                    "$ref": "#/components/schemas/per_page"
                  },
                  "page": {
                    "$ref": "#/components/schemas/page"
                  },
                  "is_ascending_order": {
                    "$ref": "#/components/schemas/is_ascending_order"
                  },
                  "cloud_footprint_providers": {
                    "$ref": "#/components/schemas/cloud_footprint_providers"
                  },
                  "cloud_footprint_target_locations": {
                    "$ref": "#/components/schemas/cloud_footprint_target_locations"
                  },
                  "cloud_footprint_primary_provider": {
                    "$ref": "#/components/schemas/cloud_footprint_primary_provider"
                  },
                  "domain": {
                    "$ref": "#/components/schemas/domain"
                  },
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "linkedin_urls": {
                    "$ref": "#/components/schemas/company_linkedin_urls"
                  },
                  "filter_conditions": {
                    "$ref": "#/components/schemas/cloud_footprint_filter_conditions"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paginated cloud footprint rows.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "metadata": {
                    "profile": null,
                    "filters": {
                      "page": 1,
                      "per_page": 1,
                      "is_cross_border_only": true,
                      "language": "en"
                    },
                    "ignored_fields": []
                  },
                  "data": {
                    "pagination": {
                      "page": 1,
                      "per_page": 1,
                      "total_entries": 48700,
                      "total_pages": 48700,
                      "total_display_pages": 250,
                      "is_timeout": false
                    },
                    "cloud_footprints": [
                      {
                        "cloud_footprint_id": "042fee02-5121-4f23-a166-69bc48e9dfe8",
                        "domain_search_id": "2ebd09b1-3bdf-4bf0-9732-c2ed6a734f77",
                        "provider": "AWS",
                        "country_code": "US",
                        "company_country_code": "CL",
                        "is_home_market": false,
                        "host_count": 232,
                        "server_count": 3,
                        "shared_server_count": 0,
                        "region_count": 1,
                        "city_count": 0,
                        "cloud_regions": [
                          "us-east-1"
                        ],
                        "cities": null,
                        "first_seen_at": "2026-07-26T16:57:20.362Z",
                        "last_seen_at": "2026-09-04T10:07:09.799Z",
                        "last_modified": "2026-09-04T10:26:52.183Z",
                        "companies": {
                          "logo_url": "https://buckets.pubrio.com/company-logo/MTc4ODM0MDY5Nmlsajlzc25qMXJ0aWFwLmNvbWxpbmtlZGluXzQ3Njc2Nzkw.jpg",
                          "domain_search_id": "2ebd09b1-3bdf-4bf0-9732-c2ed6a734f77",
                          "company_name": "RTIAP Soluciones Tecnológicas SpA",
                          "linkedin_name": "rtiap",
                          "country_code": "CL",
                          "company_url": "http://www.rtiap.com",
                          "domain": "rtiap.com"
                        },
                        "evidence_url": "https://www.pubrio.com/evidence/84c941ea04a8fa9ed1bbeabc8ff496a7"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/companies/cloud_footprints/lookup": {
      "post": {
        "tags": [
          "Lookup"
        ],
        "summary": "Look up a company cloud footprint",
        "description": "Return a single cloud footprint row by its identifier, with its cloud regions, cities and a recent sample of the infrastructure behind it. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search).",
        "operationId": "companies_lookup_cloud_footprint",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "cloud_footprint_id"
                ],
                "properties": {
                  "cloud_footprint_id": {
                    "$ref": "#/components/schemas/cloud_footprint_id"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "One cloud footprint row with its regions, cities and host sample.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "data": {
                    "country_name": "United States",
                    "hosts": [
                      {
                        "city": "Chicago",
                        "cloud_region": null,
                        "last_seen_at": "2026-09-03T23:09:52.811787",
                        "first_seen_at": "2026-09-03T23:09:52.811787"
                      },
                      {
                        "city": "Chicago",
                        "cloud_region": null,
                        "last_seen_at": "2026-07-28T16:23:24.323615",
                        "first_seen_at": "2026-07-28T16:23:24.323615"
                      }
                    ],
                    "regions": [],
                    "cloud_footprint_id": "e82b2bd0-9971-41da-809b-ee4f2cf3305e",
                    "domain_search_id": "01604baf-ab2d-4930-a867-2fced349f4f4",
                    "provider": "Linode",
                    "country_code": "US",
                    "company_country_code": "IN",
                    "is_home_market": false,
                    "host_count": 2,
                    "server_count": 3,
                    "shared_server_count": 3,
                    "region_count": 0,
                    "city_count": 1,
                    "cloud_regions": null,
                    "cities": [
                      "Chicago"
                    ],
                    "first_seen_at": "2026-07-28T16:23:24.323Z",
                    "last_seen_at": "2026-09-03T23:09:52.811Z",
                    "last_modified": "2026-09-04T09:30:52.103Z",
                    "companies": {
                      "logo_url": "https://buckets.pubrio.com/company-logo/OTg2Mzk1MjVpbGo5c3NuajFiaG9wYWxzZXJ2aWNlY2VudHJlLmNvbQ==.jpg",
                      "domain_search_id": "01604baf-ab2d-4930-a867-2fced349f4f4",
                      "company_name": "bhopalservicecentre.com",
                      "linkedin_name": null,
                      "country_code": "IN",
                      "company_url": "http://www.bhopalservicecentre.com",
                      "domain": "bhopalservicecentre.com"
                    },
                    "evidence_url": "https://www.pubrio.com/evidence/9c6ae876b7bf39f0a5beed66a7ad689e"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    },
    "/companies/cloud_footprints/insights": {
      "post": {
        "tags": [
          "Insights"
        ],
        "summary": "Cloud footprint insights",
        "description": "One company's cloud footprint in a single call: totals, top providers, countries and regions, weekly new hosts, the latest hosts, and flags for changes worth acting on. See the [Cloud Footprint Insights guide](/en/developer-guides/search/cloud-footprint-insights).",
        "operationId": "companies_cloud_footprint_insights",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "domain_search_id"
                ],
                "properties": {
                  "domain_search_id": {
                    "$ref": "#/components/schemas/domain_search_id"
                  },
                  "date_from": {
                    "$ref": "#/components/schemas/date_from"
                  },
                  "date_to": {
                    "$ref": "#/components/schemas/date_to"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The company's cloud footprint and change flags.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "description": "Cloud footprint insights for the company.",
                      "properties": {
                        "totals": {
                          "type": "object",
                          "description": "Totals for the whole footprint. Only `new_hosts` follows the date window.",
                          "properties": {
                            "hosts": {
                              "type": "integer",
                              "description": "Hosts across every provider and country."
                            },
                            "servers": {
                              "type": "integer",
                              "description": "Distinct IP addresses behind those hosts."
                            },
                            "providers": {
                              "type": "integer",
                              "description": "Distinct providers."
                            },
                            "countries": {
                              "type": "integer",
                              "description": "Countries the company hosts in."
                            },
                            "cross_border_countries": {
                              "type": "integer",
                              "description": "Countries outside the company's home market."
                            },
                            "regions": {
                              "type": "integer",
                              "description": "Distinct cloud regions."
                            },
                            "new_hosts": {
                              "type": "integer",
                              "description": "Hosts first seen inside the date window."
                            }
                          }
                        },
                        "providers": {
                          "type": "array",
                          "description": "Top 8 providers, sorted by servers, then hosts.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "description": "Provider name."
                              },
                              "hosts": {
                                "type": "integer",
                                "description": "Hosts on this provider."
                              },
                              "servers": {
                                "type": "integer",
                                "description": "Distinct IP addresses on this provider."
                              },
                              "countries": {
                                "type": "integer",
                                "description": "Countries this provider is used in."
                              }
                            }
                          }
                        },
                        "countries": {
                          "type": "array",
                          "description": "Top 8 countries, sorted by servers, then hosts.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "description": "ISO 3166-1 alpha-2 country code."
                              },
                              "name": {
                                "type": "string",
                                "description": "Country name."
                              },
                              "hosts": {
                                "type": "integer",
                                "description": "Hosts in this country."
                              },
                              "servers": {
                                "type": "integer",
                                "description": "Distinct IP addresses in this country."
                              },
                              "providers": {
                                "type": "integer",
                                "description": "Providers used in this country."
                              },
                              "is_cross_border": {
                                "type": "boolean",
                                "nullable": true,
                                "description": "`true` when the country is outside the company's home market; `null` when the headquarters is unknown."
                              },
                              "evidence_url": {
                                "type": "string",
                                "format": "uri",
                                "nullable": true,
                                "description": "Pubrio evidence page for this market; `null` for the home market."
                              }
                            }
                          }
                        },
                        "regions": {
                          "type": "array",
                          "description": "Top 8 cloud regions, sorted by servers, then hosts.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "provider": {
                                "type": "string",
                                "description": "Provider name."
                              },
                              "region_code": {
                                "type": "string",
                                "description": "The provider's region code, such as `us-east-1`."
                              },
                              "region_name": {
                                "type": "string",
                                "nullable": true,
                                "description": "Region name; `null` when unknown."
                              },
                              "city": {
                                "type": "string",
                                "nullable": true,
                                "description": "City; `null` when unknown."
                              },
                              "country_code": {
                                "type": "string",
                                "description": "ISO 3166-1 alpha-2 country code."
                              },
                              "hosts": {
                                "type": "integer",
                                "description": "Hosts in this region."
                              },
                              "servers": {
                                "type": "integer",
                                "description": "Distinct IP addresses in this region."
                              }
                            }
                          }
                        },
                        "weekly_series": {
                          "type": "array",
                          "description": "Hosts first seen each week inside the date window. Weeks start on Monday in your workspace timezone.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "week_start": {
                                "type": "string",
                                "format": "date",
                                "description": "First day of the week (YYYY-MM-DD)."
                              },
                              "count": {
                                "type": "integer",
                                "description": "Hosts first seen that week."
                              }
                            }
                          }
                        },
                        "recent_hosts": {
                          "type": "array",
                          "description": "Up to 12 hosts first seen inside the date window, newest first, one entry per host.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "provider": {
                                "type": "string",
                                "description": "Provider name."
                              },
                              "country_code": {
                                "type": "string",
                                "description": "ISO 3166-1 alpha-2 country code."
                              },
                              "cloud_region": {
                                "type": "string",
                                "nullable": true,
                                "description": "Cloud region code; `null` when unknown."
                              },
                              "city": {
                                "type": "string",
                                "nullable": true,
                                "description": "City; `null` when unknown."
                              },
                              "first_seen_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "When the host was first seen."
                              },
                              "last_seen_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "When the host was last seen."
                              },
                              "is_cross_border": {
                                "type": "boolean",
                                "nullable": true,
                                "description": "`true` when the country is outside the company's home market; `null` when the headquarters is unknown."
                              }
                            }
                          }
                        },
                        "window_days": {
                          "type": "integer",
                          "description": "Days in the date window, counting both ends."
                        },
                        "flags": {
                          "type": "object",
                          "nullable": true,
                          "description": "Changes worth acting on. Each list holds up to 8 items, newest first. `null` when flags are not ready for this company yet; a single list is `null` when it could not be built on this call.",
                          "properties": {
                            "moved_hosts": {
                              "type": "array",
                              "nullable": true,
                              "description": "Hosts that now answer from a different provider, country or region.",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "host": {
                                    "type": "string",
                                    "description": "Host name."
                                  },
                                  "is_provider_change": {
                                    "type": "boolean",
                                    "description": "`true` when the provider changed; `false` when only the country or region changed."
                                  },
                                  "from": {
                                    "type": "object",
                                    "description": "Where the host answered before.",
                                    "properties": {
                                      "provider": {
                                        "type": "string",
                                        "description": "Provider name."
                                      },
                                      "country_code": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2 country code."
                                      },
                                      "cloud_region": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "Cloud region code; `null` when unknown."
                                      },
                                      "city": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "City; `null` when unknown."
                                      },
                                      "region_name": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "Region name; `null` when unknown."
                                      },
                                      "first_seen_at": {
                                        "type": "string",
                                        "format": "date-time",
                                        "description": "When the host was first seen at this place."
                                      },
                                      "last_seen_at": {
                                        "type": "string",
                                        "format": "date-time",
                                        "description": "When the host was last seen at this place."
                                      }
                                    }
                                  },
                                  "to": {
                                    "type": "object",
                                    "description": "Where the host answers now.",
                                    "properties": {
                                      "provider": {
                                        "type": "string",
                                        "description": "Provider name."
                                      },
                                      "country_code": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2 country code."
                                      },
                                      "cloud_region": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "Cloud region code; `null` when unknown."
                                      },
                                      "city": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "City; `null` when unknown."
                                      },
                                      "region_name": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "Region name; `null` when unknown."
                                      },
                                      "first_seen_at": {
                                        "type": "string",
                                        "format": "date-time",
                                        "description": "When the host was first seen at this place."
                                      },
                                      "last_seen_at": {
                                        "type": "string",
                                        "format": "date-time",
                                        "description": "When the host was last seen at this place."
                                      }
                                    }
                                  },
                                  "is_live_confirmed": {
                                    "type": "boolean",
                                    "description": "`true` when the host answers from `to` right now; `false` when it has left `from` but its new place could not be confirmed."
                                  }
                                }
                              }
                            },
                            "twin_hosts": {
                              "type": "array",
                              "nullable": true,
                              "description": "One service live on two or more clouds at once, with the newest cloud added inside the date window.",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "service": {
                                    "type": "string",
                                    "description": "The service name the hosts share."
                                  },
                                  "providers": {
                                    "type": "array",
                                    "description": "Clouds the service is live on, newest first.",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  "new_provider": {
                                    "type": "string",
                                    "description": "The most recently added cloud."
                                  },
                                  "first_seen_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "When the service was first seen on any of these clouds."
                                  },
                                  "new_provider_first_seen_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "When the service was first seen on `new_provider`."
                                  },
                                  "hosts": {
                                    "type": "array",
                                    "description": "One live host per cloud, up to 3.",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "host": {
                                          "type": "string",
                                          "description": "Host name."
                                        },
                                        "provider": {
                                          "type": "string",
                                          "description": "Provider name."
                                        },
                                        "country_code": {
                                          "type": "string",
                                          "description": "ISO 3166-1 alpha-2 country code."
                                        },
                                        "cloud_region": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Cloud region code; `null` when unknown."
                                        },
                                        "city": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "City; `null` when unknown."
                                        },
                                        "region_name": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Region name; `null` when unknown."
                                        },
                                        "first_seen_at": {
                                          "type": "string",
                                          "format": "date-time",
                                          "description": "When the host was first seen."
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "test_hosts": {
                              "type": "array",
                              "nullable": true,
                              "description": "New development, test, staging or proof-of-concept hosts on a cloud other than the company's primary one.",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "host": {
                                    "type": "string",
                                    "description": "Host name."
                                  },
                                  "tags": {
                                    "type": "array",
                                    "description": "Words in the host name that mark it as non-production, such as `dev` or `staging`.",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  "is_poc": {
                                    "type": "boolean",
                                    "description": "`true` when the host name marks a proof of concept or pilot. These items are listed first."
                                  },
                                  "primary_provider": {
                                    "type": "string",
                                    "description": "The company's primary provider."
                                  },
                                  "first_seen_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "When the host was first seen."
                                  },
                                  "places": {
                                    "type": "array",
                                    "description": "Where the host is live now.",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "provider": {
                                          "type": "string",
                                          "description": "Provider name."
                                        },
                                        "country_code": {
                                          "type": "string",
                                          "description": "ISO 3166-1 alpha-2 country code."
                                        },
                                        "cloud_region": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Cloud region code; `null` when unknown."
                                        },
                                        "city": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "City; `null` when unknown."
                                        },
                                        "region_name": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Region name; `null` when unknown."
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "new_providers": {
                              "type": "array",
                              "nullable": true,
                              "description": "Providers the company started using inside the date window.",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "provider": {
                                    "type": "string",
                                    "description": "Provider name."
                                  },
                                  "first_seen_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "When the company was first seen on this provider."
                                  },
                                  "host_count": {
                                    "type": "integer",
                                    "description": "Hosts the company has on this provider now."
                                  },
                                  "hosts": {
                                    "type": "array",
                                    "description": "Up to 3 live hosts as proof.",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "host": {
                                          "type": "string",
                                          "description": "Host name."
                                        },
                                        "provider": {
                                          "type": "string",
                                          "description": "Provider name."
                                        },
                                        "country_code": {
                                          "type": "string",
                                          "description": "ISO 3166-1 alpha-2 country code."
                                        },
                                        "cloud_region": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Cloud region code; `null` when unknown."
                                        },
                                        "city": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "City; `null` when unknown."
                                        },
                                        "region_name": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Region name; `null` when unknown."
                                        },
                                        "first_seen_at": {
                                          "type": "string",
                                          "format": "date-time",
                                          "description": "When the host was first seen."
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "new_regions": {
                              "type": "array",
                              "nullable": true,
                              "description": "New regions, or new countries, on a provider the company used before the date window.",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "provider": {
                                    "type": "string",
                                    "description": "Provider name."
                                  },
                                  "country_code": {
                                    "type": "string",
                                    "description": "ISO 3166-1 alpha-2 country code."
                                  },
                                  "cloud_region": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Cloud region code; `null` when the flag is a new country on this provider."
                                  },
                                  "city": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "City; `null` when unknown."
                                  },
                                  "region_name": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "Region name; `null` when unknown."
                                  },
                                  "first_seen_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "When the company was first seen in this region."
                                  },
                                  "host_count": {
                                    "type": "integer",
                                    "description": "Hosts the company has in this region now."
                                  },
                                  "hosts": {
                                    "type": "array",
                                    "description": "Up to 3 live hosts as proof.",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "host": {
                                          "type": "string",
                                          "description": "Host name."
                                        },
                                        "provider": {
                                          "type": "string",
                                          "description": "Provider name."
                                        },
                                        "country_code": {
                                          "type": "string",
                                          "description": "ISO 3166-1 alpha-2 country code."
                                        },
                                        "cloud_region": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Cloud region code; `null` when unknown."
                                        },
                                        "city": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "City; `null` when unknown."
                                        },
                                        "region_name": {
                                          "type": "string",
                                          "nullable": true,
                                          "description": "Region name; `null` when unknown."
                                        },
                                        "first_seen_at": {
                                          "type": "string",
                                          "format": "date-time",
                                          "description": "When the host was first seen."
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "is_spam_flood": {
                              "type": "boolean",
                              "description": "`true` when the company's host names are too noisy to flag; every list is then empty."
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "data": {
                    "totals": {
                      "hosts": 1080,
                      "servers": 31,
                      "providers": 3,
                      "countries": 6,
                      "cross_border_countries": 5,
                      "regions": 11,
                      "new_hosts": 1080
                    },
                    "providers": [
                      {
                        "key": "AWS",
                        "hosts": 231,
                        "servers": 19,
                        "countries": 5
                      },
                      {
                        "key": "OCI",
                        "hosts": 866,
                        "servers": 11,
                        "countries": 5
                      },
                      {
                        "key": "GCP",
                        "hosts": 4,
                        "servers": 1,
                        "countries": 1
                      }
                    ],
                    "countries": [
                      {
                        "key": "US",
                        "name": "United States",
                        "hosts": 993,
                        "servers": 15,
                        "providers": 3,
                        "is_cross_border": false,
                        "evidence_url": null
                      },
                      {
                        "key": "CA",
                        "name": "Canada",
                        "hosts": 23,
                        "servers": 6,
                        "providers": 2,
                        "is_cross_border": true,
                        "evidence_url": "https://www.pubrio.com/evidence/37471facc35d4ceef1036b32c645682d"
                      },
                      {
                        "key": "DE",
                        "name": "Germany",
                        "hosts": 33,
                        "servers": 3,
                        "providers": 2,
                        "is_cross_border": true,
                        "evidence_url": "https://www.pubrio.com/evidence/93a7dba47d9a4ddd5776ec49f4444fa1"
                      }
                    ],
                    "regions": [
                      {
                        "provider": "AWS",
                        "region_code": "us-west-2",
                        "region_name": "Oregon",
                        "city": "Portland",
                        "country_code": "US",
                        "hosts": 162,
                        "servers": 8
                      },
                      {
                        "provider": "OCI",
                        "region_code": "us-phoenix-1",
                        "region_name": "Phoenix",
                        "city": "Phoenix",
                        "country_code": "US",
                        "hosts": 827,
                        "servers": 6
                      },
                      {
                        "provider": "AWS",
                        "region_code": "ca-central-1",
                        "region_name": "Montreal",
                        "city": "Montreal",
                        "country_code": "CA",
                        "hosts": 14,
                        "servers": 4
                      }
                    ],
                    "weekly_series": [
                      {
                        "week_start": "2026-08-24",
                        "count": 58
                      },
                      {
                        "week_start": "2026-08-31",
                        "count": 86
                      },
                      {
                        "week_start": "2026-09-07",
                        "count": 233
                      },
                      {
                        "week_start": "2026-09-14",
                        "count": 9
                      }
                    ],
                    "recent_hosts": [
                      {
                        "provider": "OCI",
                        "country_code": "US",
                        "cloud_region": "us-phoenix-1",
                        "city": null,
                        "first_seen_at": "2026-09-14T13:24:51.520776",
                        "last_seen_at": "2026-09-14T13:24:51.520776",
                        "is_cross_border": false
                      },
                      {
                        "provider": "OCI",
                        "country_code": "US",
                        "cloud_region": "us-phoenix-1",
                        "city": null,
                        "first_seen_at": "2026-09-14T04:41:13.649993",
                        "last_seen_at": "2026-09-14T04:41:13.649993",
                        "is_cross_border": false
                      }
                    ],
                    "window_days": 90,
                    "flags": {
                      "moved_hosts": [
                        {
                          "host": "onemindservices-new-jersey-prod.app.pcd.platform9.com",
                          "is_provider_change": true,
                          "from": {
                            "provider": "AWS",
                            "country_code": "US",
                            "cloud_region": "us-west-2",
                            "city": "Portland",
                            "first_seen_at": "2026-07-22T12:07:12.918787",
                            "last_seen_at": "2026-07-22T12:19:41.499986",
                            "region_name": "Oregon"
                          },
                          "to": {
                            "provider": "OCI",
                            "country_code": "US",
                            "cloud_region": "us-phoenix-1",
                            "city": "Phoenix",
                            "first_seen_at": "2026-09-13T16:07:26.248556",
                            "last_seen_at": "2026-09-14T09:41:19.500363",
                            "region_name": "Phoenix"
                          },
                          "is_live_confirmed": true
                        },
                        {
                          "host": "computer-talk-canary.app.pcd.platform9.com",
                          "is_provider_change": true,
                          "from": {
                            "provider": "AWS",
                            "country_code": "CA",
                            "cloud_region": "ca-central-1",
                            "city": "Montreal",
                            "first_seen_at": "2026-08-18T14:09:30.236743",
                            "last_seen_at": "2026-08-18T14:09:30.236743",
                            "region_name": "Montreal"
                          },
                          "to": {
                            "provider": "OCI",
                            "country_code": "CA",
                            "cloud_region": "ca-toronto-1",
                            "city": "Toronto",
                            "first_seen_at": "2026-09-13T04:58:57.154907",
                            "last_seen_at": "2026-09-13T04:58:57.154907",
                            "region_name": null
                          },
                          "is_live_confirmed": true
                        }
                      ],
                      "twin_hosts": [],
                      "test_hosts": [],
                      "new_providers": [],
                      "new_regions": [],
                      "is_spam_flood": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/general_error"
          },
          "429": {
            "$ref": "#/components/responses/rate_limit_error"
          },
          "500": {
            "$ref": "#/components/responses/server_error"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data.",
    "url": "https://docs.pubrio.com"
  },
  "components": {
    "schemas": {
      "is_default": {
        "type": "boolean",
        "description": "When enabled, execution will set this to true for the current record and false for all other linked record groups affected."
      },
      "channel_template_id": {
        "type": "string",
        "format": "uuid",
        "description": "A unique identifier for the channel template operation."
      },
      "channel_template_parameters": {
        "type": "object",
        "description": "The parameter information depends on the channel node requirements."
      },
      "version_name": {
        "type": "string",
        "example": "default",
        "description": "Version names provide a way to identify the history of changes."
      },
      "channel_node_id": {
        "type": "string",
        "format": "uuid",
        "description": "A unique identifier for the channel node operation."
      },
      "is_entire_templates": {
        "type": "boolean",
        "description": "When enabled, the execution will apply to the entire version within the channel template."
      },
      "channel_templates": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "example": [
          1,
          2
        ],
        "description": "A list of `channel_template_id` used to search for specific channel templates."
      },
      "channel_nodes": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "A list of `channel_node_id` used to search for specific channel nodes."
      },
      "channel_template_name": {
        "type": "string",
        "example": "channel template",
        "description": "Filter search results to include a specific channel template name."
      },
      "channel_types": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "example": [
          1,
          2
        ],
        "description": "A list of `channel_type_id` used to search for specific channel types."
      },
      "channel_template_identifier": {
        "type": "string",
        "format": "uuid",
        "description": "The identifier for the channel template version group."
      },
      "domain_search_id": {
        "type": "string",
        "format": "uuid",
        "description": "A unique identifier for the company search operation."
      },
      "domain_id": {
        "type": "integer",
        "description": "A unique identifier for the domain search operation."
      },
      "job_search_id": {
        "type": "string",
        "format": "uuid",
        "example": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
        "description": "A unique identifier for the company job search operation."
      },
      "news_search_id": {
        "type": "string",
        "format": "uuid",
        "example": "4110b929-17cd-42aa-a159-906ead0c9b56",
        "description": "A unique identifier for the company news search operation."
      },
      "people_search_id": {
        "type": "string",
        "format": "uuid",
        "description": "A unique identifier for the people search operation."
      },
      "redeem_query_id": {
        "type": "string",
        "format": "uuid",
        "description": "When a bulk redeem request is initiated, a `redeem_query_id` is returned, which can be used here to retrieve the results."
      },
      "peoples": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "A list of unique identifiers (people_search_id) used for people search operations."
      },
      "companies": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "A list of unique identifiers (domain_search_id) used for company and people search operations."
      },
      "domain": {
        "type": "string",
        "example": "pubrio.com",
        "description": "A company domain used for company search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing."
      },
      "domains": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "pubrio.com"
        ],
        "description": "List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing."
      },
      "people_contact_types": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "email-work",
            "email-personal",
            "phone"
          ]
        },
        "example": [
          "email-work",
          "email-personal",
          "phone"
        ],
        "description": "Which contact details to redeem. Use exactly `email-work`, `email-personal` and/or `phone` — resolve the live list from the `people contact type` endpoint under the Filters tab.\n\n**Unrecognised values are not rejected.** A misspelling such as `work_email` returns HTTP 200 with `emails: null`, `phones: null` and `total_credit_cost: 0` — identical to a person genuinely having no contact data. If redemptions look universally empty, check these slugs first."
      },
      "contact_lookup_email": {
        "type": "string",
        "format": "email",
        "example": "person@example.com",
        "description": "Work or personal email address to look up. The system normalizes case and whitespace before matching."
      },
      "contact_lookup_phone": {
        "type": "string",
        "example": "+15551234567",
        "description": "Phone number to look up. International (E.164) format is recommended."
      },
      "contact_lookup_first_name": {
        "type": "string",
        "example": "King",
        "description": "First name. With `last_name` and either `domain` or `company`, finds the person by name. A row with no `email` or `phone` is always searched this way."
      },
      "contact_lookup_last_name": {
        "type": "string",
        "example": "Lai",
        "description": "Last name. Used with `first_name` and either `domain` or `company` to find the person by name."
      },
      "contact_lookup_company": {
        "type": "string",
        "example": "Pubrio",
        "description": "Company name. With `first_name` + `last_name`, finds the person by name at this company when `domain` is not given."
      },
      "contact_lookup_domain": {
        "type": "string",
        "example": "pubrio.com",
        "description": "Company domain, such as `stripe.com`. A website such as `https://www.stripe.com/` is read as its domain. With `first_name` + `last_name`, finds the person by name at this company."
      },
      "contact_lookup_is_enable_similarity_search": {
        "type": "boolean",
        "default": false,
        "example": true,
        "description": "Only changes rows that have an `email` or `phone`. When `true`, a row whose email or phone finds nobody is then searched by name (`first_name`, `last_name`, and `domain` or `company`). A row with only a name and a company is always searched by name and does not need this."
      },
      "contact_lookup_peoples": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "format": "email"
            },
            "phone": {
              "type": "string"
            },
            "first_name": {
              "type": "string"
            },
            "last_name": {
              "type": "string"
            },
            "company": {
              "type": "string"
            },
            "domain": {
              "type": "string"
            }
          }
        },
        "example": [
          {
            "email": "king.lai@pubrio.com"
          },
          {
            "first_name": "John",
            "last_name": "Smith",
            "domain": "example.com"
          }
        ],
        "description": "Array of lookup specs. Each entry takes `email`, `phone`, or `first_name` + `last_name` + `domain`/`company`, the same as the single-lookup body. Capped by your subscription's bulk size limit. A request where no entry has any of these is refused with `400`."
      },
      "advertisement_source_types": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "linkedin",
            "facebook",
            "google",
            "tiktok",
            "apple"
          ]
        },
        "example": [
          "linkedin",
          "facebook"
        ],
        "description": "Sources to include: `linkedin`, `facebook` (`meta` accepted), `google`, `tiktok`, `apple`. Unknown values match nothing and are echoed in `metadata.unsupported_source_types`."
      },
      "advertisement_enrichment_mode": {
        "type": "string",
        "enum": [
          "default",
          "latest"
        ],
        "default": "default",
        "example": "latest",
        "description": "Controls realtime enrichment behavior. `default` returns whatever is already in the database, and triggers enrichment only when the result set is empty and `is_realtime_enrichment` is set. `latest` bypasses the cache and forces a re-enrichment pass against the freshest source records on every call — it triggers enrichment on its own without needing any other flag."
      },
      "is_realtime_enrichment": {
        "type": "boolean",
        "default": false,
        "example": true,
        "description": "Opt into realtime enrichment for a single, company-scoped query (filtered by `domain_search_id`, `domains`, or `linkedin_urls`). When the initial search returns zero results, the endpoint scrapes the source, persists the records, and re-runs the search before responding. Subject to a per-route deadline."
      },
      "people_titles": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "sales manager",
          "marketing manager"
        ],
        "description": "Job titles associated with the individuals you aim to locate. \n\n The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for `software engineer` may yield results for individuals with the title `senior software engineer`."
      },
      "management_levels": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "c_suite",
            "director",
            "entry",
            "founder",
            "head",
            "intern",
            "manager",
            "owner",
            "partner",
            "senior",
            "vp"
          ]
        },
        "example": [
          "c_suite",
          "vp"
        ],
        "description": "Reporting tier of the person. The C-suite slug is `c_suite`, not `c_level`. An unknown slug matches nobody. Full list from the `management level` endpoint under Filters."
      },
      "departments": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "master_human_resources"
        ],
        "description": "The department field can search for people in specific areas of expertise. \n\n Check out `department` endpoints under the Filters tab for more information."
      },
      "functions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "human_resources"
        ],
        "description": "The filter field for job functions can specify particular roles or areas of expertise when searching for people. \n\n Check out `department functions` endpoints under the Filters tab for more information."
      },
      "locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "SG",
          "CN"
        ],
        "description": "ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out `location` endpoints under the Filters tab for more information."
      },
      "exclude_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "CN",
          "US",
          "RU",
          "CA"
        ],
        "description": "ISO 3166-1 alpha-2 (cca2) is used to filter out locations that does not need to be returned. Check out `location` endpoints under the Filters tab for more information."
      },
      "founded_dates": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "example": [
          2018,
          2024
        ],
        "description": "Years of company founded range. The maximum value founded is the current year."
      },
      "posted_dates": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "2025-01-01",
          "2025-01-10"
        ],
        "description": "Date range of the posted date. The maximum value is the current day. Day boundaries follow your workspace timezone."
      },
      "published_dates": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "2025-01-01",
          "2025-01-10"
        ],
        "description": "Date range of the published date. The maximum value is the current day. Day boundaries follow your workspace timezone."
      },
      "employees": {
        "type": "array",
        "items": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "example": [
          [
            1,
            10
          ],
          [
            11,
            20
          ],
          [
            10001
          ]
        ],
        "description": "The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results. \n\n Check out `company size` endpoints under the Filters tab for more information."
      },
      "revenues": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "example": [
          0,
          100000
        ],
        "description": "Minimum and maximum range of company revenue."
      },
      "company_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "SG",
          "CN"
        ],
        "description": "The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information."
      },
      "people_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "SG",
          "CN"
        ],
        "description": "The location where people live. Check out `location` endpoints under the Filters tab for more information."
      },
      "keyword": {
        "type": "string",
        "description": "Search item by keyword. If you want to get the first few (but not all) items, leave them blank."
      },
      "technologies": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "A list of `tag_id` used to search for specific technologies used by companies. To find the ID, call the `technology` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Shopify\"]`.\n\nA product name the technology list knows matches that product and its own products (`\"Salesforce\"` also matches Salesforce Desk and Salesforce Service Cloud), never look-alikes; other text matches by similarity."
      },
      "categories": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "A list of `category_id` used to search for specific categories of technology used by companies. To find the ID, call the `category` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"CDN\"]`."
      },
      "news_gallery_ids": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "A list of `news_gallery_id` used to search for specific news galleries. To find the ID, call the `news galleries` endpoint under the Filters tab."
      },
      "news_categories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "launches"
        ],
        "description": "List of `category slugs` for searching for specific news categories. To find a slug, call the `news categories` endpoint under the Filters tab."
      },
      "verticals": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "A list of `vertical_id` used to search for companies in a specific vertical or industry. To find the ID, call the `vertical` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"AI\"]`."
      },
      "vertical_categories": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "A list of `vertical_category_id` used to search for companies in a specific vertical category. To find the ID, call the `vertical category` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Information Technology\"]`."
      },
      "vertical_sub_categories": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "A list of `vertical_sub_category_id` used to search for companies in a specific vertical sub-category. To find the ID, call the `vertical sub category` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Software\"]`."
      },
      "company_name": {
        "type": "string",
        "example": "pubrio",
        "description": "Filter search results to include a specific company name. \n \n If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted."
      },
      "search_term": {
        "type": "string",
        "example": "pubrio",
        "description": "A string of words over which we want to filter the results."
      },
      "search_terms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "pubrio"
        ],
        "description": "A list of strings over which we want to filter the results."
      },
      "target_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "TW",
          "AE",
          "NO"
        ],
        "description": "Country codes the results must target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them."
      },
      "exclude_target_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "IS",
          "GB",
          "FR",
          "IE",
          "ES"
        ],
        "description": "Country codes the results must not target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them."
      },
      "headlines": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "ASUS",
          "iPhone"
        ],
        "description": "A list of headlines to filter search results."
      },
      "ads_filter_conditions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "key": {
              "type": "string",
              "enum": [
                "target_locations",
                "publisher_platforms"
              ],
              "example": "target_locations",
              "description": "The filter key specifying which property to apply the operator to."
            },
            "operator": {
              "type": "string",
              "enum": [
                "or",
                "and"
              ],
              "example": "or",
              "description": "The logical operator to apply. Use 'or' to match advertisements carrying any of the listed values, or 'and' to require all of them."
            }
          }
        },
        "description": "Advanced filtering options for advertisement searches. Specify conditions to refine your search results for the ads search endpoint."
      },
      "keywords": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "ecommerce",
          "ai",
          "fintech"
        ],
        "description": "A list of keywords to filter companies by relevance, specialties, or descriptions."
      },
      "advertisement_target_locations": {
        "allOf": [
          {
            "$ref": "#/components/schemas/target_locations"
          }
        ],
        "description": "Target geographic locations for advertisements."
      },
      "advertisement_exclude_target_locations": {
        "allOf": [
          {
            "$ref": "#/components/schemas/exclude_target_locations"
          }
        ],
        "description": "Geographic locations to exclude from advertisement targeting."
      },
      "advertisement_search_terms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "asus"
        ],
        "description": "Keywords used to search within advertisement content or titles."
      },
      "advertisement_start_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "example": [
          "2025-12-25",
          "2025-12-25"
        ],
        "description": "Start date range for advertisement filtering."
      },
      "advertisement_end_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "example": [
          "2025-12-25",
          "2025-12-25"
        ],
        "description": "End date range for advertisement filtering."
      },
      "advertisement_active_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "example": [
          "2026-01-01",
          "2026-01-31"
        ],
        "description": "Find advertisements that were running at any point during this date range (overlap-based: includes ads that started before the range and are still running, not just ads that started inside it)."
      },
      "advertisement_headlines": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "limited time offer"
        ],
        "description": "Keywords to search for within advertisement headline text."
      },
      "advertisement_platforms": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "linkedin",
            "facebook",
            "google",
            "tiktok",
            "apple"
          ]
        },
        "example": [
          "linkedin",
          "facebook"
        ],
        "description": "Filter by which ad library the advertisement was sourced from. Lowercase, case-insensitive. `meta` is accepted as an alias for `facebook`."
      },
      "advertisement_formats": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "image",
            "video",
            "text",
            "carousel",
            "dynamic_product",
            "document",
            "message",
            "event",
            "article",
            "spotlight",
            "follow",
            "job",
            "engagement"
          ]
        },
        "example": [
          "image",
          "video"
        ],
        "description": "Find companies with at least one advertisement in any of these creative formats."
      },
      "advertisement_active_ads": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum count of the company's currently active advertisements, across all countries. Use `null` for an open-ended bound, e.g. `[1, null]` for \"at least one active ad\"."
      },
      "advertisement_running_ads": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum count of the company's advertisements that are still running (no end date, or an end date in the future). Currently populated for LinkedIn ads only."
      },
      "advertisement_total_ads": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          10,
          null
        ],
        "description": "Minimum and maximum count of the company's total advertisements ever recorded, across all countries."
      },
      "advertisement_platform_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          2,
          null
        ],
        "description": "Minimum and maximum number of distinct ad platforms (linkedin, facebook, google, tiktok, apple) the company is actively advertising on."
      },
      "advertisement_format_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          2,
          null
        ],
        "description": "Minimum and maximum number of distinct advertisement creative formats the company is actively running."
      },
      "advertisement_impressions_estimate": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1000,
          null
        ],
        "description": "Minimum and maximum estimated advertisement impressions, summed across all countries. Only advertisements with a reported impression range are counted."
      },
      "advertisement_country_activity": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "example": "US",
            "description": "ISO 3166-1 alpha-2 country code to scope this filter to. Required."
          },
          "rank": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              null,
              500
            ],
            "description": "Rank within that country by advertising volume. 1 is the biggest spender, and the number increases as advertising volume decreases. Use `[null, 500]` to find the top 500 biggest spenders in that country; use `[500, null]` to find everyone ranked 500th or lower."
          },
          "percentile": {
            "type": "array",
            "items": {
              "type": "number",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              90,
              null
            ],
            "description": "Percentile within that country by advertising volume, 0-100. Higher means a bigger spender. Use `[90, null]` for the top 10% of spenders in that country."
          },
          "volume_score": {
            "type": "array",
            "items": {
              "type": "number",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              0.5,
              null
            ],
            "description": "The underlying 0-1 advertising volume score that `rank` and `percentile` are both computed from."
          },
          "active_ads": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              1,
              null
            ],
            "description": "Minimum and maximum active advertisements, scoped to this country."
          },
          "running_ads": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              1,
              null
            ],
            "description": "Minimum and maximum running advertisements, scoped to this country. Currently populated for LinkedIn ads only."
          },
          "total_ads": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              10,
              null
            ],
            "description": "Minimum and maximum total advertisements, scoped to this country."
          },
          "impressions": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              1000,
              null
            ],
            "description": "Minimum and maximum estimated impressions, scoped to this country."
          },
          "first_seen": {
            "type": "array",
            "items": {
              "type": "string",
              "nullable": true,
              "format": "date"
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              "2026-07-01",
              null
            ],
            "description": "[from, to] window for when the company's earliest ad in this country ran — the \"newly entered this market\" filter. Either bound may be null for an open-ended window; dates use the request timezone. A company whose ads carry no start date has no first-seen value and is never reported as new."
          },
          "last_seen": {
            "type": "array",
            "items": {
              "type": "string",
              "nullable": true,
              "format": "date"
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              "2026-07-01",
              null
            ],
            "description": "[from, to] window for when the company's most recent ad in this country ran, for the opposite question: who has gone quiet in a market."
          }
        },
        "required": [
          "country"
        ],
        "example": {
          "country": "US",
          "rank": [
            null,
            500
          ]
        },
        "description": "Advertising activity for one specific country. `country` is required, and at least one other field must be set (a country by itself matches nothing). For an all-country total instead, use the top-level `advertisement_active_ads` / `advertisement_total_ads` / `advertisement_impressions_estimate` filters."
      },
      "places": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "Tokyo"
        ],
        "description": "Place names (city, region) used to filter results. Accepts localized or English place names."
      },
      "exclude_places": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "Tokyo"
        ],
        "description": "Place names (city, region) to exclude from results. Accepts localized or English place names."
      },
      "job_exclude_locations": {
        "allOf": [
          {
            "$ref": "#/components/schemas/exclude_locations"
          }
        ],
        "description": "Geographic locations to exclude from job posting results."
      },
      "exclude_fields": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "emails",
          "phones",
          "contacts"
        ],
        "description": "List of fields to exclude from the response payload."
      },
      "is_company_filter_any_mode": {
        "type": "boolean",
        "description": "When true, company-level filter conditions are ORed instead of ANDed."
      },
      "is_parameter_metadata_available": {
        "type": "boolean",
        "description": "Indicates whether parameter metadata is available for the request."
      },
      "is_profile_metadata_available": {
        "type": "boolean",
        "description": "Indicates whether profile metadata is available for the request."
      },
      "company_filter_conditions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "key": {
              "type": "string",
              "enum": [
                "keywords",
                "verticals",
                "vertical_categories",
                "vertical_sub_categories",
                "technologies",
                "categories",
                "social_media",
                "advertisement_target_locations",
                "job_exclude_locations"
              ],
              "example": "keywords",
              "description": "The filter key specifying which property to apply the operator to."
            },
            "operator": {
              "type": "string",
              "enum": [
                "or",
                "and"
              ],
              "example": "or",
              "description": "The logical operator to apply. Use 'or' to match any of the specified values, or 'and' to require all specified values."
            }
          }
        },
        "description": "Advanced filtering options for company searches. Specify conditions combining keys and logical operators to refine search results."
      },
      "people_filter_conditions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "key": {
              "type": "string",
              "enum": [
                "keywords",
                "verticals",
                "vertical_categories",
                "vertical_sub_categories",
                "technologies",
                "categories",
                "social_media"
              ],
              "example": "technologies",
              "description": "The filter key specifying which property to apply the operator to."
            },
            "operator": {
              "type": "string",
              "enum": [
                "or",
                "and"
              ],
              "example": "and",
              "description": "The logical operator to apply. Use 'or' to match any of the specified values, or 'and' to require all specified values."
            }
          }
        },
        "description": "Per-key AND/OR override for filters in /people/search. Defaults to OR when omitted. See the People + Company Filters developer guide for the full key-remap reference."
      },
      "start_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "example": [
          "2025-12-01",
          "2025-12-01"
        ],
        "description": "A list of start dates to filter search results."
      },
      "end_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "example": [
          "2025-12-25",
          "2025-12-25"
        ],
        "description": "A list of end dates to filter search results."
      },
      "advertisement_search_id": {
        "type": "string",
        "format": "uuid",
        "example": "a92643e8-9033-4029-aa65-ef929327cebb",
        "description": "A unique identifier for the advertisement search result. Used to reference specific advertisements returned from the ads search endpoint."
      },
      "company_linkedin_url": {
        "type": "string",
        "example": "https://www.linkedin.com/company/pubrio",
        "description": "The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`"
      },
      "company_linkedin_urls": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "https://www.linkedin.com/company/pubrio"
        ],
        "description": "The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`"
      },
      "people_linkedin_url": {
        "type": "string",
        "example": "http://www.linkedin.com/in/king-lai-605382b7",
        "description": "The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/`"
      },
      "people_linkedin_urls": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "http://www.linkedin.com/in/king-lai-605382b7"
        ],
        "description": "The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/`"
      },
      "people_name": {
        "type": "string",
        "example": "king",
        "description": "Filter search results to include a specific people name."
      },
      "page": {
        "type": "integer",
        "example": 1,
        "default": 1,
        "description": "Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**."
      },
      "per_page": {
        "type": "integer",
        "example": 25,
        "default": 25,
        "maximum": 25,
        "description": "Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set."
      },
      "is_enable_similarity_search": {
        "type": "boolean",
        "description": "When enabled, the filters listed above that support similarity searches can be filled with free text for specific IDs."
      },
      "similarity_score": {
        "type": "number",
        "format": "float",
        "example": 0.7,
        "description": "It is used in conjunction with `is_enable_similarity_search`. This number is used to analyze whether a specific slug (e.g. vertical industry, technology) is similar to the user input, and the higher the number, the more stringent it is."
      },
      "data_array": {
        "type": "array",
        "nullable": true,
        "items": {
          "type": "object",
          "properties": {}
        },
        "description": "Response info depends on specific endpoint."
      },
      "data": {
        "type": "object",
        "nullable": true,
        "description": "Response info depends on specific endpoint."
      },
      "response_saved_lists": {
        "type": "array",
        "nullable": true,
        "items": {
          "type": "object",
          "properties": {
            "profile_id": {
              "type": "integer"
            },
            "group_id": {
              "type": "integer"
            },
            "name": {
              "type": "string"
            },
            "is_personal": {
              "type": "boolean"
            }
          }
        },
        "description": "List of saved contact or company lists in the workspace."
      },
      "company_filters": {
        "type": "object",
        "description": "Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*. Accepts the same keys as the top-level company filters (e.g. `technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`, `company_locations`, `company_exclude_locations`, `company_places`, `company_exclude_places`, `companies`, `domains`, `company_linkedin_urls`, `is_enable_similarity_search`, `similarity_score`, plus `filter_conditions`). Engine flattens this object to the top level before processing — top-level keys win on conflict. Same shape used by Monitor `company_filters`. See the Filters Overview developer guide for examples.",
        "example": {
          "company_locations": [
            "US"
          ],
          "technologies": [
            37,
            152
          ],
          "founded_dates": [
            2015,
            2023
          ],
          "filter_conditions": [
            {
              "key": "technologies",
              "operator": "and"
            }
          ]
        }
      },
      "advertisement_publisher_platforms": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "facebook",
            "instagram",
            "messenger",
            "threads",
            "audience_network"
          ]
        },
        "example": [
          "facebook",
          "instagram"
        ],
        "description": "Filter Facebook/Meta ads by the platform surface they were delivered on. Lowercase and case-insensitive. Only applies to the `facebook` source (other sources are single-platform)."
      },
      "advertisement_exclude_publisher_platforms": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "facebook",
            "instagram",
            "messenger",
            "threads",
            "audience_network"
          ]
        },
        "example": [
          "audience_network"
        ],
        "description": "Exclude Facebook/Meta ads delivered on these platform surfaces."
      },
      "advertisement_is_include_unlinked_companies": {
        "type": "boolean",
        "default": false,
        "example": true,
        "description": "Include ads not yet linked to a resolved company (raw-layer ads, e.g. scam or burner-page ads). Defaults to false, which returns only company-attributed ads."
      },
      "date_from": {
        "type": "string",
        "format": "date",
        "example": "2026-01-01",
        "description": "Start of the date window (ISO 8601, YYYY-MM-DD). Use together with `date_to` to scope results to a specific range; omit both to use the default window."
      },
      "date_to": {
        "type": "string",
        "format": "date",
        "example": "2026-03-31",
        "description": "End of the date window (ISO 8601, YYYY-MM-DD). Ignored without `date_from`. If the window is invalid or reversed, the default window is used; check `window_days` in the response."
      },
      "window_days": {
        "type": "integer",
        "example": 90,
        "description": "Optional. Size of the rolling window in days. Used when an explicit `transitioned_dates` range is not supplied; if both are omitted, a default window is used."
      },
      "expansion_is_all_markets": {
        "type": "boolean",
        "example": false,
        "description": "Return the company's entire expansion footprint across ALL markets in one call, rather than a single market. When `true`, `country_code` is ignored, the home market is excluded from the signal aggregates when it can be identified, `data` becomes a company-level rollup (dominant stage, total signals, date span, top expansion score), and `markets_summary` lists every market. Defaults to false."
      },
      "expansion_country_code": {
        "type": "string",
        "example": "US",
        "description": "Target market as an ISO 3166-1 alpha-2 (cca2) country code. Omit to auto-pick the company's single most active market; set `is_all_markets` for a cross-market view of every market."
      },
      "expansion_momentum": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "advancing",
            "steady",
            "pulling_back"
          ]
        },
        "example": [
          "advancing",
          "steady"
        ],
        "description": "Trajectory to filter by. Only `advancing`, `steady` and `pulling_back` are accepted; the `directions` values in [Expansion Reference](/en/api-reference/endpoint/expansions/types) are response-side only."
      },
      "expansion_freshness": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "fresh",
            "cooling",
            "stale",
            "cold"
          ]
        },
        "example": [
          "fresh",
          "cooling"
        ],
        "description": "Filter by evidence recency: fresh (~30d), cooling (~30-60d), stale (~60-90d), cold (>90d)."
      },
      "expansion_sort_by": {
        "type": "string",
        "enum": [
          "recent",
          "expansion_score",
          "signal_count",
          "company_ranking"
        ],
        "example": "expansion_score",
        "description": "Result ordering. Omit for the default relevance order: corroborated pairs first (2+ distinct signal types), then repeated-evidence pairs (3+ signals), then the rest — most recently transitioned first within each tier. `recent` — pure recency (most recently transitioned first). `expansion_score` — highest expansion score first. `signal_count` — most signals in the pair first. `company_ranking` — Pubrio's overall company ranking (lower is more prominent), ascending."
      },
      "expansion_scopes": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "entering_new_market",
            "expanding_within_presence",
            "established_only"
          ]
        },
        "example": [
          "entering_new_market"
        ],
        "description": "Filter by market-entry scope."
      },
      "expansion_stage_slug": {
        "type": "string",
        "enum": [
          "exploring",
          "committing",
          "expanding",
          "scaling"
        ],
        "example": "committing",
        "description": "Filter to a single expansion stage. See the Expansion Signals knowledge base for stage definitions."
      },
      "expansion_signal_type_slugs": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "AD",
            "AUDIENCE",
            "DNS",
            "ENTITY",
            "EVENT",
            "EVENT_PLUS",
            "EXEC",
            "HIRE",
            "INFRA",
            "IP",
            "NEWS",
            "OFFICE",
            "PARTNER",
            "PRODUCT",
            "REG",
            "SCALE",
            "TECH"
          ]
        },
        "example": [
          "EXEC",
          "HIRE"
        ],
        "description": "Filter to specific signal types. See the Signal Types catalog in the knowledge base for definitions and tiers (`DNS` and `INFRA` are Premier-tier signals)."
      },
      "expansion_is_include_established": {
        "type": "boolean",
        "example": false,
        "description": "Include the `established` stage (long-standing operators with no active expansion signals). Defaults to false."
      },
      "expansion_is_include_metadata": {
        "type": "boolean",
        "example": true,
        "description": "API-key responses are lean by default. Set true to include the full `metadata` block (aggregates, top origins/destinations, top industries, timeline) and per-company model detail."
      },
      "industries": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "software",
          "financial services"
        ],
        "description": "Filter by industry name (free-text match)."
      },
      "exclude_industries": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "tobacco"
        ],
        "description": "Industries to exclude (free-text match)."
      },
      "expansion_domain_search_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
        ],
        "description": "Company identifiers (domain_search_id UUIDs) to include."
      },
      "expansion_select_size": {
        "type": "integer",
        "example": 50,
        "description": "Maximum number of records to return. Capped by your plan."
      },
      "expansion_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "example": [
          12345,
          12346
        ],
        "description": "Expansion record identifiers to export, as returned by the expansion list endpoints."
      },
      "timezone": {
        "type": "string",
        "example": "America/New_York",
        "description": "IANA timezone name used to bucket time-series by local day. Defaults to UTC."
      },
      "only_contraction": {
        "type": "boolean",
        "example": false,
        "description": "When true, return only contraction-flagged expansions (companies scaling back)."
      },
      "signal_strengths": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high",
            "very_high"
          ]
        },
        "example": [
          "high"
        ],
        "description": "Filter by evidence-confidence bucket: `low`, `medium`, or `high`. Note this is distinct from the per-signal `signal_strength_slug` returned on signal records (which ranges `low` to `very_high`); any other value here matches nothing."
      },
      "expansion_stages": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "exploring",
            "committing",
            "expanding",
            "scaling"
          ]
        },
        "example": [
          "committing",
          "expanding"
        ],
        "description": "Filter to one or more expansion stages. See the Expansion Signals knowledge base for stage definitions."
      },
      "expansion_froms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "GB"
        ],
        "description": "Origin markets (ISO 3166-1 alpha-2). Where a company is expanding FROM — its home / HQ countries. Use alone to find companies growing out of these markets; combine with `tos` for a specific from→to corridor."
      },
      "expansion_tos": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "GB"
        ],
        "description": "Target markets (ISO 3166-1 alpha-2). Where a company is expanding TO. Use alone to find every company entering these markets; combine with `froms` for a specific from→to corridor."
      },
      "expansion_exclude_froms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "GB"
        ],
        "description": "Origin markets to exclude (ISO 3166-1 alpha-2)."
      },
      "expansion_exclude_tos": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US",
          "GB"
        ],
        "description": "Target markets to exclude (ISO 3166-1 alpha-2)."
      },
      "expansion_companies": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "stripe.com",
          "https://www.linkedin.com/company/airbnb",
          "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
        ],
        "description": "Scope to specific companies by any mix of `domain_search_id`, company domain, or a company social media profile URL. Domains and URLs resolve to their best-ranked company."
      },
      "is_expansion_signal_available": {
        "type": "boolean",
        "description": "When `true`, attaches the resolved expansion signals (`expansion_signals`) to each news item and enables the `expansion_signal_types` / `expansion_signal_polarities` filters. Leave unset for the fastest search — the expansion join is only added when this flag is on."
      },
      "expansion_signal_types": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "AD",
            "AUDIENCE",
            "DNS",
            "ENTITY",
            "EVENT",
            "EVENT_PLUS",
            "EXEC",
            "HIRE",
            "INFRA",
            "IP",
            "NEWS",
            "OFFICE",
            "PARTNER",
            "PRODUCT",
            "REG",
            "SCALE",
            "TECH"
          ]
        },
        "example": [
          "HIRE",
          "PARTNER"
        ],
        "description": "Return only news that produced an expansion signal of one of these types (uppercase slugs). Requires `is_expansion_signal_available: true`. A list with only unknown slugs matches nothing."
      },
      "expansion_signal_polarities": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "expansion",
            "contraction_leading",
            "contraction_confirming",
            "contraction_lagging"
          ]
        },
        "example": [
          "expansion"
        ],
        "description": "Return only news whose expansion signal carries one of these polarities. Requires `is_expansion_signal_available: true`. Combined with `expansion_signal_types` as AND."
      },
      "expansion_signal_subtype_slugs": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "marketing_pullback",
            "domain_dropped",
            "entity_dissolution",
            "exhibiting_booth",
            "speaking_breakout",
            "speaking_keynote",
            "sponsorship",
            "key_departure",
            "country_manager",
            "engineering",
            "freelancer",
            "hiring_freeze",
            "job_posting_removal",
            "legal_compliance",
            "local_employee",
            "operations",
            "regional_vp",
            "remote_sales_bd",
            "supply_chain",
            "ip_abandoned",
            "office_closure",
            "partnership_terminated",
            "product_withdrawal",
            "regulatory_surrender",
            "layoffs",
            "content_decay"
          ]
        },
        "example": [
          "country_manager",
          "local_employee"
        ]
      },
      "event_dates": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "2026-06-01",
          "2026-06-30"
        ],
        "description": "Date range of the signal event date. The maximum value is the current day."
      },
      "job_seniority_ranks": {
        "type": "array",
        "items": {
          "type": "integer",
          "enum": [
            1,
            2,
            3,
            4,
            5
          ]
        },
        "example": [
          4,
          5
        ],
        "description": "Seniority tier from the title: `1` junior, `2` senior, `3` manager, `4` director, `5` executive. A value outside 1–5 matches nothing. Rows return their tier in `seniority_rank` (`0` = unclassified)."
      },
      "job_functions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "engineering",
          "product_management"
        ],
        "description": "Function slugs derived from the title, e.g. `engineering`, `sales`, `marketing`, `finance`, `product_management`, or a [Department Functions](/en/api-reference/endpoint/departments/function) slug such as `software_development`, in any case. Unknown slugs match nothing. Full list: [Enums & Constants](/en/api-reference/enums#job-functions)."
      },
      "job_launch_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "minItems": 1,
        "maxItems": 2,
        "example": [
          "2026-08-01",
          "2026-08-31"
        ],
        "description": "Inclusive `[from, to]` window (UTC) on the launch date: `posting_date`, or the ingestion day when absent. Matches how Job Insights counts. A single date matches that day."
      },
      "job_location_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "example": [
          357,
          419
        ],
        "description": "Posting country by Pubrio `location_id` (Locations endpoint; also on each row). Alternative to `locations`."
      },
      "search_created_at": {
        "type": "string",
        "format": "date-time",
        "example": "2026-09-02T12:00:00Z",
        "description": "Ingested at or after this instant (UTC). Date or ISO timestamp. For incremental syncs pass the `created_at` of your newest stored row."
      },
      "is_ascending_order": {
        "type": "boolean",
        "default": false,
        "example": false,
        "description": "Sort direction. Results are returned newest-first by default; set `true` for oldest-first. There is no `sort_by` on this endpoint — the sort key is fixed and stated in the endpoint description."
      },
      "news_published_at_from": {
        "type": "string",
        "format": "date-time",
        "example": "2026-09-01T00:00:00Z",
        "description": "Published at or after this instant (UTC). Date or ISO timestamp. `published_dates` is the closed-window form and uses your workspace timezone."
      },
      "advertisement_reach_tiers": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "lt_1k",
            "1k_10k",
            "10k_50k",
            "50k_100k",
            "100k_500k",
            "500k_1m",
            "1m_plus"
          ]
        },
        "example": [
          "100k_500k",
          "500k_1m",
          "1m_plus"
        ],
        "description": "Impression band of the ad: `lt_1k`, `1k_10k`, `10k_50k`, `50k_100k`, `100k_500k`, `500k_1m`, `1m_plus`. Ads without a `total_impressions` value never match; unknown slugs match nothing."
      },
      "advertisement_exclude_source_types": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "linkedin",
            "facebook",
            "google",
            "tiktok",
            "apple"
          ]
        },
        "example": [
          "apple"
        ],
        "description": "Exclude ads captured from these sources. Same vocabulary as `source_types` (`linkedin`, `facebook`, `google`, `tiktok`, `apple`; `meta` is an alias of `facebook`). Unknown values are ignored."
      },
      "advertisement_active_dates_search": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "date"
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          "2026-08-01",
          "2026-08-31"
        ],
        "description": "Inclusive `[from, to]` window (UTC). Returns ads running at any point in it, including ones that started earlier, so it reconciles with Advertisement Insights. Undated ads count from `created_at`. Both dates required, `from` ≤ `to`."
      },
      "search_result_company": {
        "type": "object",
        "description": "The company the record is linked to.",
        "properties": {
          "domain_search_id": {
            "type": "string",
            "format": "uuid",
            "description": "Pubrio company identifier. Pass it to `companies` on any search, or to Company Lookup."
          },
          "company_name": {
            "type": "string",
            "description": "Company name."
          },
          "linkedin_name": {
            "type": "string",
            "nullable": true,
            "description": "LinkedIn company slug (the part after `linkedin.com/company/`)."
          },
          "country_code": {
            "type": "string",
            "nullable": true,
            "description": "ISO 3166-1 alpha-2 code of the company headquarters."
          },
          "company_url": {
            "type": "string",
            "nullable": true,
            "description": "Company website URL."
          },
          "domain": {
            "type": "string",
            "description": "Company domain, normalised (`stripe.com`)."
          },
          "logo_url": {
            "type": "string",
            "nullable": true,
            "description": "Company logo URL."
          }
        }
      },
      "search_pagination": {
        "type": "object",
        "description": "Pagination for the result set.",
        "properties": {
          "page": {
            "type": "integer",
            "description": "Current page number."
          },
          "per_page": {
            "type": "integer",
            "description": "Records per page."
          },
          "total_entries": {
            "type": "integer",
            "description": "Total matching records. An estimate when `is_estimated` is `true`."
          },
          "total_pages": {
            "type": "integer",
            "description": "`total_entries` divided by `per_page`."
          },
          "total_display_pages": {
            "type": "integer",
            "description": "Page count for this result, capped by your plan's `max_display_search_page`."
          },
          "is_estimated": {
            "type": "boolean",
            "description": "`true` when `total_entries` is an estimate rather than an exact count. Do not use an estimated total to decide when to stop paging; stop when a page returns fewer rows than `per_page`."
          },
          "is_timeout": {
            "type": "boolean",
            "description": "`true` when the search ran out of time. `total_entries` then only counts the rows returned so far, and an empty page means the search did not finish, not that nothing matched."
          }
        }
      },
      "search_metadata": {
        "type": "object",
        "description": "Request context.",
        "properties": {
          "profile": {
            "type": "object",
            "nullable": true,
            "description": "Credit block (`credit`, `topup_credit`, `total_credit_cost`) when credit accounting is requested; `null` on plain API-key traffic."
          },
          "filters": {
            "type": "object",
            "description": "Echo of the request body as the endpoint applied it, including defaults such as `per_page` and `language`."
          },
          "ignored_fields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Body keys the endpoint did not recognise and dropped. Empty means every key applied — a misspelled filter widens the search instead of failing."
          }
        }
      },
      "advertisement_search_metadata": {
        "allOf": [
          {
            "$ref": "#/components/schemas/search_metadata"
          },
          {
            "type": "object",
            "properties": {
              "applied_source_types": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Only when `source_types` was sent: the values that were recognised and applied."
              },
              "unsupported_source_types": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Only when `source_types` contained a value that is not a known source. Those values match nothing."
              },
              "coverage_notes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "source_type": {
                      "type": "string"
                    },
                    "scope": {
                      "type": "string",
                      "enum": [
                        "eea_uk_ch"
                      ]
                    }
                  }
                },
                "description": "Coverage notes for the requested sources, when applicable."
              },
              "skipped_source_types": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "source_type": {
                      "type": "string",
                      "description": "Source that was skipped."
                    },
                    "reason": {
                      "type": "string",
                      "enum": [
                        "country_unknown_until_enriched"
                      ],
                      "description": "Why the source was not applied."
                    }
                  }
                },
                "description": "Sources that were not applied for the requested `target_locations`, each with a `reason`."
              }
            }
          }
        ],
        "description": "Request context."
      },
      "job_search_result": {
        "type": "object",
        "description": "One job posting.",
        "properties": {
          "job_id": {
            "type": "string",
            "format": "uuid",
            "description": "Posting identifier."
          },
          "job_search_id": {
            "type": "string",
            "format": "uuid",
            "description": "Same value as `job_id`. Pass it to Job Lookup."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When Pubrio first ingested the posting. This is the default sort key."
          },
          "last_modified": {
            "type": "string",
            "format": "date-time",
            "description": "When the record was last updated."
          },
          "title": {
            "type": "string",
            "description": "Job title as published."
          },
          "job_url": {
            "type": "string",
            "description": "Link to the posting at the source."
          },
          "location": {
            "type": "string",
            "description": "Free-text location as published.",
            "nullable": true
          },
          "location_id": {
            "type": "integer",
            "nullable": true,
            "description": "Pubrio `location_id` of the posting's country. Same vocabulary as the `location_ids` filter."
          },
          "country": {
            "type": "string",
            "description": "Country name of the posting.",
            "nullable": true
          },
          "country_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 code of the posting's country. Same vocabulary as the `locations` filter.",
            "nullable": true
          },
          "posting_date": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "description": "Publisher's posting date. `launch_dates` filters on it, falling back to `created_at` when it is absent."
          },
          "source_type": {
            "type": "string",
            "description": "Source the posting was captured from, e.g. `linkedin`."
          },
          "functions": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Job-function slugs resolved from the title; `null` when unclassified. Same vocabulary as the `functions` filter."
          },
          "departments": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Department slugs resolved from the title; `null` when unclassified. Same vocabulary as the `departments` filter."
          },
          "seniority_rank": {
            "type": "integer",
            "enum": [
              0,
              1,
              2,
              3,
              4,
              5
            ],
            "description": "Seniority tier `1`–`5` as defined on the `seniority_ranks` filter; `0` when the title could not be classified."
          },
          "base_salary": {
            "type": "string",
            "description": "Salary text as published, when the source provides one.",
            "nullable": true
          },
          "experience_requirement": {
            "type": "string",
            "description": "Experience requirement as published, when the source provides one.",
            "nullable": true
          },
          "education_requirement": {
            "type": "string",
            "description": "Education requirement as published, when the source provides one.",
            "nullable": true
          },
          "employment_type": {
            "type": "string",
            "description": "Employment type as published (e.g. `Full-time`), when the source provides one.",
            "nullable": true
          },
          "companies": {
            "$ref": "#/components/schemas/search_result_company"
          }
        }
      },
      "news_search_result": {
        "type": "object",
        "description": "One news article.",
        "properties": {
          "news_id": {
            "type": "string",
            "format": "uuid",
            "description": "Article identifier."
          },
          "news_search_id": {
            "type": "string",
            "format": "uuid",
            "description": "Search-record identifier. Pass it to News Lookup."
          },
          "title": {
            "type": "string",
            "description": "Headline."
          },
          "summary": {
            "type": "string",
            "description": "Short summary of the article.",
            "nullable": true
          },
          "title_original": {
            "type": "string",
            "description": "The title in the language the article was originally written in."
          },
          "summary_original": {
            "type": "string",
            "description": "The summary in the language the article was originally written in."
          },
          "url": {
            "type": "string",
            "description": "Link to the article."
          },
          "source": {
            "type": "string",
            "description": "Publisher domain.",
            "nullable": true
          },
          "image_url": {
            "type": "string",
            "description": "Lead image, when the article has one.",
            "nullable": true
          },
          "language": {
            "type": "string",
            "description": "The language the article was originally written in. `title` and `summary` are in the `language` you asked for.",
            "nullable": true
          },
          "published_at": {
            "type": "string",
            "format": "date-time",
            "description": "Publication time. This is the default sort key (undated articles sort last).",
            "nullable": true
          },
          "last_modified": {
            "type": "string",
            "format": "date-time",
            "description": "When the record was last updated."
          },
          "category": {
            "type": "string",
            "description": "News category slug. Same vocabulary as the `categories` filter and the News Categories endpoint.",
            "nullable": true
          },
          "news_category_name": {
            "type": "string",
            "description": "Human-readable category name, localised to `language`.",
            "nullable": true
          },
          "news_galleries": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "object",
              "properties": {
                "news_gallery_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                }
              }
            },
            "description": "Galleries the article belongs to; `null` when none."
          },
          "country_codes": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Countries the article is about (ISO 3166-1 alpha-2); `null` when not detected. Same vocabulary as the `locations` filter."
          },
          "company_country_codes": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Headquarters countries of the companies mentioned. Same vocabulary as the `company_locations` filter."
          },
          "locations": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Place names mentioned in the article; `null` when none."
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Domains of every company the article mentions."
          },
          "companies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/search_result_company"
            },
            "description": "Every company the article mentions, in the same order as `domains`."
          },
          "expansion_signals": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "signal_type_slug": {
                  "type": "string",
                  "description": "Signal type, e.g. `HIRE`, `PARTNER`, `PRODUCT`."
                },
                "signal_subtype_slug": {
                  "type": "string",
                  "description": "Signal subtype, when the type has one.",
                  "nullable": true
                },
                "signal_strength_slug": {
                  "type": "string",
                  "description": "Signal strength: `low`, `medium`, `high`, `very_high`."
                },
                "polarity": {
                  "type": "string",
                  "description": "`expansion`, `contraction_leading`, `contraction_confirming` or `contraction_lagging`."
                },
                "country_code": {
                  "type": "string",
                  "description": "Market the signal points at.",
                  "nullable": true
                },
                "domain_search_id": {
                  "type": "string",
                  "format": "uuid",
                  "description": "Company the signal belongs to."
                },
                "event_date": {
                  "type": "string",
                  "format": "date-time",
                  "description": "When the signal occurred."
                }
              }
            },
            "description": "Only when `is_expansion_signal_available: true`: the expansion signals this article produced. Empty array when none."
          }
        }
      },
      "advertisement_search_result": {
        "type": "object",
        "description": "One advertisement.",
        "properties": {
          "advertisement_id": {
            "type": "string",
            "format": "uuid",
            "description": "Advertisement identifier."
          },
          "advertisement_search_id": {
            "type": "string",
            "format": "uuid",
            "description": "Same value as `advertisement_id`. Pass it to Advertisement Lookup."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When Pubrio first captured the ad. This is the default sort key."
          },
          "last_modified": {
            "type": "string",
            "format": "date-time",
            "description": "When the record was last updated."
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the ad started running, as reported by the source.",
            "nullable": true
          },
          "ended_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the ad stopped running; `null` while it is still running.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Headline or ad title.",
            "nullable": true
          },
          "source_type": {
            "type": "string",
            "enum": [
              "linkedin",
              "facebook",
              "google",
              "tiktok",
              "apple"
            ],
            "description": "Source the ad was captured from. Same vocabulary as the `source_types` filter."
          },
          "advertisement_format": {
            "type": "string",
            "description": "Format label exactly as the source publishes it, e.g. `Single Image Ad`, `MULTI_IMAGES`.",
            "nullable": true
          },
          "advertisement_format_normalized": {
            "type": "string",
            "nullable": true,
            "enum": [
              "image",
              "video",
              "text",
              "carousel",
              "dynamic_product",
              "document",
              "message",
              "event",
              "article",
              "spotlight",
              "follow",
              "job",
              "engagement",
              "other"
            ],
            "description": "Canonical format, the vocabulary the `advertisement_formats` filter accepts. `other` when the raw label is not mapped."
          },
          "is_company_matched": {
            "type": "boolean",
            "description": "`true` when the ad is linked to a Pubrio company record. Unlinked ads are returned only with `is_include_unlinked_companies: true`."
          },
          "advertiser": {
            "type": "string",
            "description": "Advertiser name as shown by the source.",
            "nullable": true
          },
          "advertiser_url": {
            "type": "string",
            "description": "Advertiser page at the source, when available.",
            "nullable": true
          },
          "advertisement_url": {
            "type": "string",
            "description": "Link to the ad in the source's ad library, when available.",
            "nullable": true
          },
          "total_impressions": {
            "type": "string",
            "description": "Impression estimate exactly as the source publishes it, e.g. `< 1k`, `10k-50k`. `null` for sources that do not report impressions.",
            "nullable": true
          },
          "total_impressions_lower": {
            "type": "integer",
            "nullable": true,
            "description": "Lower bound of the impression range; `null` for `< N` ranges."
          },
          "total_impressions_upper": {
            "type": "integer",
            "nullable": true,
            "description": "Upper bound of the impression range; `null` for open-ended ranges."
          },
          "image_url": {
            "type": "string",
            "description": "Creative image, when the ad has one.",
            "nullable": true
          },
          "video_url": {
            "type": "string",
            "description": "Creative video, when the ad has one.",
            "nullable": true
          },
          "carousel_images": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Carousel frames, for carousel formats."
          },
          "destination_url": {
            "type": "string",
            "description": "Resolved landing page. Facebook click-wrappers such as `fb.me` are unwrapped to the real funnel URL.",
            "nullable": true
          },
          "raw_link_url": {
            "type": "string",
            "description": "The original link exactly as captured, before unwrapping.",
            "nullable": true
          },
          "target_country_codes": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "description": "Countries the ad was shown in (ISO 3166-1 alpha-2). Same vocabulary as the `target_locations` filter."
          },
          "publisher_platforms": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string",
              "enum": [
                "facebook",
                "instagram",
                "messenger",
                "threads",
                "audience_network"
              ]
            },
            "description": "Meta surfaces the ad ran on: `facebook`, `instagram`, `messenger`, `threads`, `audience_network`. `null` for non-`facebook` sources."
          },
          "companies": {
            "$ref": "#/components/schemas/search_result_company"
          }
        }
      },
      "exclude_people_titles": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "intern",
          "assistant"
        ],
        "description": "Job titles to leave out. Same word-level matching as `people_titles`, so `[\"senior\"]` removes every title containing that word. Applied after `people_titles`."
      },
      "exclude_people_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "US"
        ],
        "description": "Countries the person must **not** live in (ISO 3166-1 alpha-2). Companion of `people_locations`."
      },
      "exclude_departments": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "master_human_resources"
        ],
        "description": "Department slugs to leave out. Same vocabulary as `departments`. People with no department recorded are kept."
      },
      "exclude_department_functions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "software_development"
        ],
        "description": "Function slugs to leave out. Same vocabulary as `department_functions`. People with no function recorded are kept."
      },
      "company_exclude_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "CN"
        ],
        "description": "Headquarters countries to leave out (ISO 3166-1 alpha-2). Companion of `company_locations`; sending the same code in both returns nothing."
      },
      "company_social_media": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "linkedin",
            "facebook",
            "instagram",
            "tiktok",
            "twitter",
            "x",
            "github",
            "wantedly",
            "rocketpunch"
          ]
        },
        "example": [
          "tiktok"
        ],
        "description": "Companies with a profile on any of: `linkedin`, `facebook`, `instagram`, `tiktok`, `twitter`, `x`, `github`, `wantedly`, `rocketpunch`. Promote to AND with `filter_conditions`."
      },
      "advertisement_status": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "currently_running",
            "active_last_30_min"
          ]
        },
        "example": [
          "currently_running"
        ],
        "description": "`currently_running`: companies with advertising on record. `active_last_30_min`: companies whose advertising changed in the last 30 minutes."
      },
      "company_sort_by": {
        "type": "string",
        "enum": [
          "relevance",
          "name",
          "number_of_employees",
          "founded_year",
          "advertisement_country_rank"
        ],
        "example": "advertisement_country_rank",
        "description": "Result ordering. Omit for the default relevance order. `advertisement_country_rank` orders by the company's advertising rank inside the country named in `advertisement_country_activity` (rank 1 = biggest advertiser in that market) and is ignored unless that filter is present. Pair with `is_ascending_order: false` to list the smallest advertisers first. Not yet available: `name` (either direction) and `relevance` with `is_ascending_order: false` — those requests time out. Use the default relevance order, `number_of_employees` or `founded_year` instead."
      },
      "cloud_footprint_target_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "DE",
          "SG"
        ],
        "description": "Companies present in any of these countries anywhere in their footprint."
      },
      "cloud_footprint_exclude_target_locations": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "DE",
          "US",
          "SG"
        ],
        "description": "Remove footprint rows matching these country codes the infrastructure sits in."
      },
      "cloud_footprint_id": {
        "type": "string",
        "format": "uuid",
        "example": "f28215e6-f6ed-40c2-ac9b-d8e70164c0be",
        "description": "Identifier of a single cloud footprint row."
      },
      "cloud_footprint_ids": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "example": [
          "f28215e6-f6ed-40c2-ac9b-d8e70164c0be"
        ],
        "description": "Identifiers of specific cloud footprint rows, for exporting a selection."
      },
      "cloud_footprint_evidence_url": {
        "type": "string",
        "nullable": true,
        "format": "uri",
        "example": "https://www.pubrio.com/evidence/9c6ae876b7bf39f0a5beed66a7ad689e",
        "description": "Link to a Pubrio page that backs this row. `null` for a company's home market, which raises no expansion signal."
      },
      "cloud_footprint_country_activity": {
        "type": "object",
        "required": [
          "country"
        ],
        "properties": {
          "country": {
            "type": "string",
            "example": "DE",
            "description": "ISO 3166-1 alpha-2 country code."
          },
          "host_count": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              100,
              null
            ]
          },
          "server_count": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              100,
              null
            ]
          },
          "shared_server_count": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              100,
              null
            ]
          },
          "region_count": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              100,
              null
            ]
          },
          "city_count": {
            "type": "array",
            "items": {
              "type": "integer",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              100,
              null
            ]
          },
          "first_seen": {
            "type": "array",
            "items": {
              "type": "string",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              "2026-07-01",
              null
            ]
          },
          "last_seen": {
            "type": "array",
            "items": {
              "type": "string",
              "nullable": true
            },
            "minItems": 2,
            "maxItems": 2,
            "example": [
              "2026-07-01",
              null
            ]
          }
        },
        "description": "Bounds scoped to one country: `{\"country\":\"DE\",\"host_count\":[100,null]}` finds companies running 100+ hosts in Germany specifically. The bare `cloud_footprint_host_count` is the company total across all countries, so the two cannot express this together. `country` alone is rejected."
      },
      "cloud_footprint_filter_conditions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "key": {
              "type": "string",
              "enum": [
                "cloud_regions",
                "cities"
              ],
              "example": "cloud_regions",
              "description": "Which array filter the operator applies to."
            },
            "operator": {
              "type": "string",
              "enum": [
                "or",
                "and"
              ],
              "example": "and",
              "description": "`or` matches rows carrying any listed value; `and` requires all of them."
            }
          }
        },
        "description": "Switches an array filter from OR (default: match any value) to AND (match all values). Applies to `cloud_regions` and `cities`."
      },
      "providers": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "AWS",
          "Cloudflare",
          "Hetzner"
        ],
        "description": "Restrict results to footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country."
      },
      "exclude_providers": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "AWS",
          "Cloudflare",
          "Hetzner"
        ],
        "description": "Remove footprint rows matching these cloud or hosting providers. Scoped to this footprint row — one provider in one country."
      },
      "cloud_regions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "us-east-1",
          "eu-central-1"
        ],
        "description": "Restrict results to footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country."
      },
      "exclude_cloud_regions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "us-east-1",
          "eu-central-1"
        ],
        "description": "Remove footprint rows matching these cloud regions. Scoped to this footprint row — one provider in one country."
      },
      "cities": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "Ashburn",
          "Frankfurt"
        ],
        "description": "Restrict results to footprint rows matching these cities. Scoped to this footprint row — one provider in one country."
      },
      "exclude_cities": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "Ashburn",
          "Frankfurt"
        ],
        "description": "Remove footprint rows matching these cities. Scoped to this footprint row — one provider in one country."
      },
      "first_seen_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          "2026-01-01",
          null
        ],
        "description": "Two ISO 8601 dates (YYYY-MM-DD) bounding when the footprint was first seen. Scoped to this footprint row — one provider in one country."
      },
      "last_seen_dates": {
        "type": "array",
        "items": {
          "type": "string",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          "2026-01-01",
          null
        ],
        "description": "Two ISO 8601 dates (YYYY-MM-DD) bounding when the footprint was last seen. Scoped to this footprint row — one provider in one country."
      },
      "is_cross_border_only": {
        "type": "boolean",
        "example": true,
        "description": "When true, return only footprint rows outside the company's home market. Rows whose company has no known headquarters are excluded."
      },
      "host_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum hosts. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."
      },
      "server_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum servers (distinct IP addresses). Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."
      },
      "shared_server_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum servers shared with other companies. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."
      },
      "region_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum cloud regions. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."
      },
      "city_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum cities. Use `null` for an open-ended bound. Scoped to this footprint row — one provider in one country."
      },
      "cloud_footprint_host_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum hosts. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_server_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum servers (distinct IP addresses). Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_shared_server_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum servers shared with other companies. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_provider_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum distinct providers used by the company. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_country_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum countries the company hosts in. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_cross_border_country_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum countries outside the company's home market. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_region_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum cloud regions. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_city_count": {
        "type": "array",
        "items": {
          "type": "integer",
          "nullable": true
        },
        "minItems": 2,
        "maxItems": 2,
        "example": [
          1,
          null
        ],
        "description": "Minimum and maximum cities. Use `null` for an open-ended bound. Counted for the whole company, across every provider and country."
      },
      "cloud_footprint_providers": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "AWS",
          "Cloudflare"
        ],
        "description": "Companies that use any of these providers anywhere. The unprefixed `providers` narrows the rows returned; this narrows the companies."
      },
      "cloud_footprint_primary_provider": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "AWS"
        ],
        "description": "Companies whose single largest provider is one of these."
      }
    },
    "securitySchemes": {
      "pubrio_api_key": {
        "type": "apiKey",
        "name": "pubrio-api-key",
        "description": "A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the [Settings](https://dashboard.pubrio.com/#/settings/) section.",
        "in": "header"
      }
    },
    "responses": {
      "server_error": {
        "description": "Internal server error. An unexpected error occurred on the server. Contact support if the error persists.",
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "error"
              ],
              "type": "object",
              "properties": {
                "error": {
                  "example": "An unexpected error occurred on the server.",
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "rate_limit_error": {
        "description": "Rate limit exceeded. Too many requests were made in a given time period. Retry after the rate limit window resets.",
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "error"
              ],
              "type": "object",
              "properties": {
                "error": {
                  "example": "Request rate limit exceeded. Please wait and try again later.",
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "general_error": {
        "description": "Bad request. The request was malformed or contained invalid parameters. Check the error code and message for details.",
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "code",
                "message",
                "details"
              ],
              "type": "object",
              "properties": {
                "code": {
                  "example": 40001,
                  "type": "integer"
                },
                "message": {
                  "example": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
                  "type": "string"
                },
                "details": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "timeout_error": {
        "description": "Request timeout. The request could not finish in time. Narrow the request and try again.",
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "code",
                "message",
                "details"
              ],
              "type": "object",
              "properties": {
                "code": {
                  "example": 40801,
                  "type": "integer"
                },
                "message": {
                  "example": "Request timeout",
                  "type": "string"
                },
                "details": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "links": {},
    "callbacks": {}
  },
  "security": [
    {
      "pubrio_api_key": []
    }
  ]
}
