> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Company Advertisement Insights > 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. ## OpenAPI ````yaml en-openapi POST /companies/advertisements/insights openapi: 3.0.0 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 servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] 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. 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 paths: /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' profile_id: $ref: '#/components/schemas/profile_id' 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. example: data: totals: total: 88 launched: 20 active: 34 markets: 5 channels: 3 weekly_series: - week_start: '2026-02-09' count: 12 postings: - headline: Try our platform format: video started_at: '2026-02-10' placement_mix: - key: facebook count: 22 - key: instagram count: 14 creatives: - headline: Try our platform format: video reach_tiers: - key: 10k-50k count: 9 - key: 50k-100k count: 4 window_days: 90 components: schemas: domain_search_id: type: string format: uuid description: A unique identifier for the company search operation. 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). Must be on or after `date_from`. profile_id: type: integer description: >- Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking. Check out `user details` endpoints under the Profile tab for more information. 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 ````