superagnt-com superagnt Lead APIs: Companies — Enrich API

openapi: 3.2.0
info:
  title: 'superagnt Lead APIs: Companies — Enrich API'
  description: Unified API for social media data. Access LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook through a single API key.
  version: 1.0.0
  contact:
    name: superagnt
    url: https://superagnt.com
servers:
- url: https://api.superagnt.com
  description: superagnt API
security:
- ApiKeyAuth: []
tags:
- name: 'superagnt Lead APIs: Companies — Enrich'
  description: Enrich companies with firmographic data.
paths:
  /v1/data/agnt/companies/enrich:
    post:
      operationId: companies_enrich
      summary: Enrich a company
      description: 'Enrich a company with normalized firmographic fields (industry, headcount, HQ, founded year, technologies, funding, …). REQUIRES a `identifiers` object containing one or more of: `domain`, `name` (or `company_name`), `linkedin_url` (or `company_linkedin_url`). `domain` is the strongest signal — prefer it when available. Optional `fields[]` narrows the waterfall. Field-aware waterfall same as `/people/enrich`.'
      tags:
      - 'superagnt Lead APIs: Companies — Enrich'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompaniesEnrichRequest'
            example:
              identifiers:
                domain: stripe.com
      responses:
        '200':
          description: Company enrichment result.
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                    enum:
                    - true
                  data:
                    $ref: '#/components/schemas/CompaniesEnrichResponse'
                  meta:
                    $ref: '#/components/schemas/AgntMeta'
        '400':
          description: Validation error.
        '402':
          description: Insufficient credits.
      security:
      - ApiKeyAuth: []
  /v1/data/agnt/companies/bulk-enrich:
    post:
      operationId: companies_bulk_enrich
      summary: Bulk enrich companies
      description: 'Enrich up to 100 companies in one call. Each input must include at least one of: `domain`, `name` (or `company_name`), `linkedin_url` (top-level on the input object — NOT nested under `identifiers` like the single-record endpoint). `domain` is the strongest signal. Each input runs the same field-aware waterfall as `/companies/enrich`. Use `max_cost_cents_per_record` to cap per-record spend.'
      tags:
      - 'superagnt Lead APIs: Companies — Enrich'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompaniesBulkEnrichRequest'
            example:
              inputs:
              - identifier: row-1
                domain: stripe.com
              - identifier: row-2
                domain: openai.com
      responses:
        '200':
          description: Bulk enrichment results.
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                    enum:
                    - true
                  data:
                    $ref: '#/components/schemas/CompaniesBulkEnrichResponse'
                  meta:
                    $ref: '#/components/schemas/AgntMeta'
        '400':
          description: Validation error.
        '402':
          description: Insufficient credits.
      security:
      - ApiKeyAuth: []
components:
  schemas:
    CompaniesBulkEnrichResponse:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    AgntMeta:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    CompaniesEnrichRequest:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    CompaniesEnrichResponse:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    CompaniesBulkEnrichRequest:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...'