> ## 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. # Statistiques publicitaires de l'entreprise > Insights agrégés de signaux publicitaires pour une entreprise sur une fenêtre de dates : comptages de publicités actives et lancées, répartition par canal et emplacement, exemples de créations, portée d'audience sous forme de répartition par palier, et une série temporelle hebdomadaire. La portée est toujours rapportée sous forme de répartition par palier, jamais comme un chiffre unique cumulé. ## OpenAPI ````yaml fr-openapi POST /companies/advertisements/insights openapi: 3.0.0 info: description: >- L'API Pubrio fournit une intelligence d'expansion de marché — des signaux en temps réel qui indiquent quand une entreprise entre sur un nouveau marché — ainsi que les données d'entreprises et de personnes qui les sous-tendent. Recherchez, consultez et enrichissez des comptes et des contacts, et abonnez-vous à des signaux de mouvement typés et datés sur plus de 200 marchés. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/fr/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/fr/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: >- Informations de profil de l'espace de travail et statistiques d'utilisation - name: Enrichment description: >- Enrichissez les fiches de personnes et d'entreprises avec des données B2B détaillées - name: Lookalike description: Trouvez des entreprises similaires à une entreprise donnée - name: Search description: >- Recherchez des personnes, des entreprises, des offres d'emploi, des actualités et des publicités à l'aide de filtres - name: Lookup description: >- Consultez des informations détaillées sur des personnes, entreprises, offres d'emploi, actualités, publicités et technologies spécifiques - name: LinkedIn description: >- Consultez les données de personnes et d'entreprises via des URL de profil LinkedIn - name: Redeem description: >- Utilisez des crédits pour débloquer les coordonnées de personnes (unitaire et par lot) - name: Channels description: >- Gérez les modèles de canaux de prospection (création, mise à jour, suppression, liste) - name: Monitor description: >- Créez et gérez des moniteurs de données avec webhooks, statistiques et traitement - name: Filters description: >- Récupérez les valeurs de filtre disponibles pour les paramètres de recherche (technologies, localisations, secteurs verticaux, etc.) - name: API Keys description: >- Listez et inspectez les journaux de requêtes API et les statistiques d'utilisation des clés API - name: Insights description: >- Informations agrégées sur les signaux des entreprises (offres d'emploi, actualités, publicités). - name: Export description: Exports de données en masse (soumis à des crédits). - name: Expansion description: >- Intelligence d'expansion de marché des entreprises : signaux, étapes, marchés et exports. externalDocs: description: >- L'API Pubrio permet de rechercher, prévisualiser et enrichir des contacts et des comptes. La base de données Pubrio fournit des données étendues de contacts B2B et de veille commerciale. url: https://docs.pubrio.com paths: /companies/advertisements/insights: post: tags: - Insights summary: Insights publicitaires description: >- Insights agrégés de signaux publicitaires pour une entreprise sur une fenêtre de dates : comptages de publicités actives et lancées, répartition par canal et emplacement, exemples de créations, portée d'audience sous forme de répartition par palier, et une série temporelle hebdomadaire. La portée est toujours rapportée sous forme de répartition par palier, jamais comme un chiffre unique cumulé. 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: >- Inclure les publicités pas encore liées à un profil d'entreprise vérifié. responses: '200': description: Bandes d'insight publicitaire pour l'entreprise et la fenêtre. content: application/json: schema: type: object properties: data: type: object description: >- Bandes d'insight pour l'entreprise et la fenêtre demandées. properties: postings: type: array description: >- Agrégat de volume publicitaire, regroupé par palier de portée, marchés, canal et format. Les clés sont abrégées pour garder la charge utile légère : `r` = slug de palier de portée (correspond à `reach_tiers[].slug`, `null` quand la plateforme ne rapporte aucune portée), `m` = les marchés ISO 3166-1 alpha-2 où les publicités ont été diffusées, `ch` = canal source, `fo` = format publicitaire, `n` = nombre de publicités dans ce groupe. items: type: object reach_tiers: type: array description: >- Le catalogue d'étiquettes de palier de portée, ordonné du plus petit au plus grand. C'est une table de correspondance, pas une répartition — elle ne porte aucun comptage. Associez `postings[].r` à `slug` pour obtenir l'étiquette lisible, et lisez le volume par palier depuis `postings[].n`. La portée publicitaire est une plage textuelle à la source, donc les paliers ne doivent jamais être additionnés en un chiffre de portée unique. items: type: object creatives: type: array description: >- Créations publicitaires récentes, priorisant l'image : les créations avec une vraie image viennent en premier, puis les publicités texte ou vidéo récentes afin que les annonceurs sans image apparaissent quand même. `headline`, `body` et `cta` peuvent chacun être `null`. Tout ce qui est nécessaire pour afficher une galerie de créations se trouve ici — aucun second appel à Advertisement Search n'est nécessaire. 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' components: schemas: domain_search_id: type: string format: uuid description: Un identifiant unique pour l'opération de recherche d'entreprise. date_from: type: string format: date example: '2026-01-01' description: >- Début de la fenêtre de dates (ISO 8601, YYYY-MM-DD). À utiliser conjointement avec `date_to` pour limiter les résultats à une plage spécifique ; omettez les deux pour utiliser la fenêtre par défaut. date_to: type: string format: date example: '2026-03-31' description: >- Fin de la fenêtre de dates (ISO 8601, YYYY-MM-DD). Doit être postérieure ou égale à `date_from`. responses: general_error: description: >- Requête invalide. La requête était mal formée ou contenait des paramètres invalides. Consultez le code d'erreur et le message pour plus de détails. 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 rate_limit_error: description: >- Limite de débit dépassée. Trop de requêtes ont été effectuées au cours d'une période donnée. Réessayez après la réinitialisation de la fenêtre de limitation de débit. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Erreur interne du serveur. Une erreur inattendue s'est produite sur le serveur. Contactez le support si l'erreur persiste. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````