> ## 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. # Résumés d'expansion d'entreprise par lot > Résumés d'expansion prêts à afficher pour un lot d'entreprises, préparés pour une comparaison côte à côte sans agrégation côté client. ## OpenAPI ````yaml fr-openapi POST /expansions/companies/summaries 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: /expansions/companies/summaries: post: tags: - Expansion summary: Résumés d'expansion d'entreprise par lot description: >- Résumés d'expansion prêts à afficher pour un lot d'entreprises, préparés pour une comparaison côte à côte sans agrégation côté client. 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: >- Plage de dates ISO `[from, to]` pour la fenêtre de signal/transition. Prime sur `window_days` lorsque les deux sont fournis. window_days: $ref: '#/components/schemas/window_days' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' is_include_metadata: type: boolean description: >- Renvoie la charge utile de détail complète. Le trafic par clé API est allégé par défaut : le bloc `model`, les chiffres de confiance (`stage.confidence` sur Company Expansion Detail, `confidence_score` sur `other_markets[]` et sur `markers[]` de Rankings) et les champs `established_min` / `share_of_detected` / `has_known_office` sont tous omis sauf si ceci est `true`. example: true description: >- Ciblez des entreprises avec un unique tableau `companies` d'identifiants mixtes — `domain_search_id`, domaine d'entreprise, ou URL LinkedIn — mis en correspondance comme une union (non une intersection). Les anciennes clés `domain_search_ids`, `domains`, et `linkedin_urls` restent acceptées pour la rétrocompatibilité. Jusqu'à 25 entreprises résolues par requête. responses: '200': description: >- Tableau de résumés d'expansion par entreprise. Deux scores : `expansion_score` de premier niveau est la posture actuelle globale sur tous les marchés (stable) ; `summary.window_expansion_score` est la même mesure limitée à la fenêtre sélectionnée. Les deux sont sur une échelle de 0 à 100 ici (contrairement au `stage.expansion_score` de 0 à 1 des résultats de recherche). Lorsque votre plan n'inclut pas les comptages d'employés, `firmographics` renvoie `company_size`, `employees_count`, et `company_size_printed` en null et définit `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: Un résumé prêt à afficher par entreprise demandée. 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' components: schemas: expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - b7d92a56-31f8-4c0b-ae43-19c8e5f24b70 description: >- Limite à des entreprises spécifiques via n'importe quelle combinaison de `domain_search_id`, de domaine d'entreprise, ou d'URL de profil de réseau social d'entreprise. Les domaines et URL sont résolus vers leur entreprise la mieux classée. domains: type: array items: type: string example: - pubrio.com description: >- Liste de domaines d'entreprise utilisée pour les opérations de recherche d'entreprises et de personnes. Si nous recevons une URL telle que `www.pubrio.com` ou `https://docs.pubrio.com/`, le système la convertira en `pubrio.com` pour le traitement. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- L'URL complète du profil d'entreprise LinkedIn. L'URL commence par `http` et contient `linkedin.com/company/` window_days: type: integer example: 90 description: >- Facultatif. Taille de la fenêtre glissante, en jours. Utilisée lorsqu'une plage `transitioned_dates` explicite n'est pas fournie ; si les deux sont omis, une fenêtre par défaut est utilisée. expansion_is_include_established: type: boolean example: false description: >- Inclut l'étape `established` (acteurs établis de longue date sans signaux d'expansion actifs). Par défaut à false. 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 ````