> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Export Account Research Report

> Every buyer and intro path of one account research report, as rows or a CSV file

Every buyer of one account research report, warm and cold, one row per intro path: a warm buyer
once per path, then each cold buyer once with the path columns blank. At most 50,000 rows;
`truncated` and the `X-Export-Truncated` header say when the report had more.

`format=json`, the default, answers the rows, keyed by the CSV's headers, with `total` and
`truncated`. `format=csv` answers the file itself, `clustr-account-research-<date>.csv`, ready to
open in a spreadsheet.

```bash cURL theme={null}
curl "https://api.clustr-ai.com/v2/abs_reports/abs_.../detail/export?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o account-research.csv
```


## OpenAPI

````yaml GET /v2/abs_reports/{abs_report_id}/detail/export
openapi: 3.1.0
info:
  title: Clustr API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros, and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '2.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com
    description: Production
security:
  - BearerAuth: []
paths:
  /v2/abs_reports/{abs_report_id}/detail/export:
    get:
      tags:
        - Account Research
      summary: Export Account Research Report
      description: >
        The report the detail serves, every warm and cold buyer rather than a
        page of

        each, one row per intro path: a warm buyer once per path (once, path
        columns

        blank, when it has none), then each cold buyer. At most 50,000 rows;

        `truncated` (and X-Export-Truncated) says the report had more.


        `format=json` (the default) answers `rows` (each keyed by the CSV's
        headers),

        `total` and `truncated`. `format=csv` answers the file

        (clustr-account-research-<date>.csv): record_type, buyer_name,
        buyer_title,

        buyer_headline, buyer_seniority_level, buyer_location,
        buyer_profile_url,

        buyer_linkedin_id, buyer_intro_count, buyer_in_crm, buyer_crm_provider,

        buyer_crm_lifecycle_stage, buyer_crm_owner,
        buyer_crm_last_activity_date,

        intro_tier, path_type, path_confidence_pct, connector_name,
        connector_job_title,

        connector_company, connector_profile_url, connector_linkedin_id,
        shared_company,

        overlap_in_months, overlap_period, engagement_count, last_activity_date,

        relevance_reason, buyer_best_path_pct, buyer_best_path_strength,

        path_recommendation, path_reason, connector_in_crm,
        connector_crm_provider,

        connector_owner, connector_tags. UTF-8 with a byte order mark; cells
        that

        start with = + - @ get a leading apostrophe.
      operationId: exportAbsReportsDetail
      parameters:
        - name: abs_report_id
          in: path
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/ExportFormat'
      responses:
        '200':
          description: Typed result envelope.
          headers:
            X-Export-Total:
              $ref: '#/components/headers/ExportTotal'
            X-Export-Rows:
              $ref: '#/components/headers/ExportRows'
            X-Export-Truncated:
              $ref: '#/components/headers/ExportTruncated'
            Content-Disposition:
              $ref: '#/components/headers/ExportContentDisposition'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ABSReportExportEnvelope'
              example:
                success: true
                data:
                  rows:
                    - record_type: company
                      buyer_name: Thomas Lefevre
                      buyer_title: Head of Procurement
                      buyer_headline: Head of Procurement at Northwind Logistics
                      buyer_seniority_level: company
                      buyer_location: Lyon, France
                      buyer_profile_url: >-
                        https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      buyer_linkedin_id: thomas-lefevre-4b2a1
                      buyer_intro_count: '3'
                      buyer_in_crm: Thomas Lefevre
                      buyer_crm_provider: hubspot
                      buyer_crm_lifecycle_stage: Negotiation
                      buyer_crm_owner: Alex Martin
                      buyer_crm_last_activity_date: '2026-11-03'
                      intro_tier: Tier 1
                      path_type: colleague
                      path_confidence_pct: '64'
                      connector_name: Sofia Rossi
                      connector_job_title: VP Sales
                      connector_company: Sofia Rossi
                      connector_profile_url: >-
                        https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      connector_linkedin_id: sofia-rossi
                      shared_company: Acme Analytics
                      overlap_in_months: '18'
                      overlap_period: 2019-2022
                      engagement_count: '3'
                      last_activity_date: '2026-11-03'
                      relevance_reason: Leads procurement at a target account
                      buyer_best_path_pct: Thomas Lefevre
                      buyer_best_path_strength: Thomas Lefevre
                      path_recommendation: Ask Sofia for an intro
                      path_reason: Worked together at Acme Analytics
                      connector_in_crm: Sofia Rossi
                      connector_crm_provider: hubspot
                      connector_owner: Alex Martin
                      connector_tags: Champion
                      clustr_buyer_person_id: per_2yc54rt9319363snmzhte7gje4
                      clustr_connector_person_id: per_1sq6cfhtpmxzdx5nwzfv8zbhmr
                  total: 128
                  truncated: false
            text/csv:
              schema:
                type: string
                description: >-
                  With format=csv, the file itself (UTF-8 with a byte order
                  mark).
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    ExportFormat:
      name: format
      in: query
      required: false
      description: |
        The response format. `json` (the default) is the standard
        `{ "success": true, "data": { ... } }` envelope, with `total` and
        `truncated` beside the rows. `csv` is the file itself: `text/csv;
        charset=utf-8`, a UTF-8 byte order mark, `Content-Disposition:
        attachment; filename="clustr-<name>-<YYYY-MM-DD>.csv"`, and a leading
        apostrophe on any cell that starts with = + - @, a tab or a carriage
        return so a spreadsheet never reads it as a formula. Anything else is a
        400. Both formats hold at most 50,000 rows and report the size in the
        X-Export-* headers. A CSV whose export failed partway ends with the line
        `# EXPORT FAILED: this file is incomplete. Download it again.`, and
        the connection is closed.
      schema:
        type: string
        enum:
          - json
          - csv
        default: json
  headers:
    ExportTotal:
      description: Rows that matched the request.
      schema:
        type: integer
        minimum: 0
    ExportRows:
      description: Rows in this response, at most 50,000.
      schema:
        type: integer
        minimum: 0
    ExportTruncated:
      description: |
        true when more rows matched than this response holds (the 50,000-row
        ceiling, or a lower limit the request asked for). The rows are the
        first ones in the export's order; narrow the request to get the rest.
      schema:
        type: boolean
    ExportContentDisposition:
      description: >-
        CSV only. `attachment; filename="clustr-<name>-<YYYY-MM-DD>.csv"`, the
        date in UTC.
      schema:
        type: string
  schemas:
    ABSReportExportEnvelope:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          $ref: '#/components/schemas/ABSReportExportData'
    ABSReportExportData:
      type: object
      required:
        - rows
        - total
        - truncated
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/ABSReportExportRow'
        total:
          type: integer
        truncated:
          type: boolean
          description: True when the report has more rows than the export ceiling.
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    ABSReportExportRow:
      description: >-
        One buyer's intro path, or a cold buyer, as the Account Research CSV's
        row.
      type: object
      required:
        - record_type
        - buyer_name
        - buyer_title
        - buyer_headline
        - buyer_seniority_level
        - buyer_location
        - buyer_profile_url
        - buyer_linkedin_id
        - buyer_intro_count
        - buyer_in_crm
        - buyer_crm_provider
        - buyer_crm_lifecycle_stage
        - buyer_crm_owner
        - buyer_crm_last_activity_date
        - intro_tier
        - path_type
        - path_confidence_pct
        - connector_name
        - connector_job_title
        - connector_company
        - connector_profile_url
        - connector_linkedin_id
        - shared_company
        - overlap_in_months
        - overlap_period
        - engagement_count
        - last_activity_date
        - relevance_reason
        - buyer_best_path_pct
        - buyer_best_path_strength
        - path_recommendation
        - path_reason
        - connector_in_crm
        - connector_crm_provider
        - connector_owner
        - connector_tags
      properties:
        record_type:
          type: string
        buyer_name:
          type: string
        buyer_title:
          type: string
        buyer_headline:
          type: string
        buyer_seniority_level:
          type: string
        buyer_location:
          type: string
        buyer_profile_url:
          type: string
        buyer_linkedin_id:
          type: string
        buyer_intro_count:
          type: string
        buyer_in_crm:
          type: string
        buyer_crm_provider:
          type: string
        buyer_crm_lifecycle_stage:
          type: string
        buyer_crm_owner:
          type: string
        buyer_crm_last_activity_date:
          type: string
        intro_tier:
          type: string
        path_type:
          type: string
        path_confidence_pct:
          type: string
        connector_name:
          type: string
        connector_job_title:
          type: string
        connector_company:
          type: string
        connector_profile_url:
          type: string
        connector_linkedin_id:
          type: string
        shared_company:
          type: string
        overlap_in_months:
          type: string
        overlap_period:
          type: string
        engagement_count:
          type: string
        last_activity_date:
          type: string
        relevance_reason:
          type: string
        buyer_best_path_pct:
          type: string
        buyer_best_path_strength:
          type: string
        path_recommendation:
          type: string
        path_reason:
          type: string
        connector_in_crm:
          type: string
        connector_crm_provider:
          type: string
        connector_owner:
          type: string
        connector_tags:
          type: string
        clustr_buyer_person_id:
          type: string
          description: The Clustr id of `buyer_linkedin_id`, a person (`per_...`).
        clustr_connector_person_id:
          type: string
          description: The Clustr id of `connector_linkedin_id`, a person (`per_...`).
    ErrorInfo:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: >-
            What a client branches on, such as BAD_REQUEST or NOT_FOUND: one of
            the codes listed, the same on every operation. A code is added
            within a major version, never renamed.
          enum:
            - ADMIN_REQUIRED
            - ALREADY_LISTED
            - API_REQUEST_FAILED
            - ATTIO_NOT_CONNECTED
            - ATTIO_WORKSPACE_NOT_FOUND
            - AUTHORIZATION_UNAVAILABLE
            - AUTH_CONTEXT_ERROR
            - AUTH_FAILED
            - AUTH_METHOD_UNSUPPORTED
            - BAD_GATEWAY
            - BAD_REQUEST
            - BIGQUERY_ERROR
            - BODY_TOO_LARGE
            - BULK_PUSH_TOO_LARGE
            - BUYER_TITLES_UNAVAILABLE
            - CANCELLED
            - CANNOT_CHANGE_OWN_ROLE
            - CANNOT_DEACTIVATE_SELF
            - CANNOT_REMOVE_SELF
            - CLEANING_REPORT_FAILED
            - CLEANING_REPORT_UNAVAILABLE
            - CLIENT_CLOSED_REQUEST
            - COMPANY_NOT_FOUND
            - COMPANY_NOT_RESOLVED
            - COMPETITOR_EXISTS
            - COMPETITOR_READ_FAILED
            - COMPETITOR_RUN_FAILED
            - CONFLICT
            - CRM_CAPABILITY_UNSUPPORTED
            - CRM_CREDENTIAL_EXPIRED
            - CRM_DAILY_LIMIT
            - CRM_LISTS_UNSUPPORTED
            - CRM_NOT_ACTIVE
            - CRM_NOT_CONNECTED
            - CRM_RATE_LIMITED
            - CRM_RECONNECT_REQUIRED
            - CRM_ROW
            - CRM_SCHEMA_UNAVAILABLE
            - CRM_SCOPE_MISSING
            - CRM_UNAVAILABLE
            - CRM_VALUES_UNAVAILABLE
            - CRM_WRITE_DISABLED
            - CUSTOMERS_UNAVAILABLE
            - DATABASE_NOT_FOUND
            - DATASET_NOT_FOUND
            - DUPLICATE_ALREADY_RESOLVED
            - DUPLICATE_CHECK_FAILED
            - EMAIL_NOTIFIER_UNAVAILABLE
            - ENTITLEMENT_UNAVAILABLE
            - ESCALATION_EMAIL_DISABLED
            - EXPORT_FAILED
            - EXPORT_IN_FLIGHT
            - EXPORT_UNAVAILABLE
            - FAMILY_CLUSTER
            - FEATURE_NOT_ENABLED
            - FINDING_NOT_APPLICABLE
            - FIRE_FAILED
            - FORBIDDEN
            - FULLENRICH_API_ERROR
            - FULLENRICH_UNEXPECTED_ERROR
            - GATEWAY_TIMEOUT
            - HEADERS_TOO_LARGE
            - HUBSPOT_NOT_CONNECTED
            - HUBSPOT_UPSTREAM_ERROR
            - INSUFFICIENT_CREDITS
            - INSUFFICIENT_PERMISSION
            - INTEGRATION_REAUTH_REQUIRED
            - INTERNAL_ERROR
            - INVALID_BODY
            - INVALID_BOOLEAN
            - INVALID_BUCKET
            - INVALID_COMPANY_NAME
            - INVALID_CREDENTIALS
            - INVALID_CUSTOMER_RULE
            - INVALID_ENDPOINT
            - INVALID_EVENT
            - INVALID_FIELD
            - INVALID_INPUT
            - INVALID_LINKEDIN_URL
            - INVALID_MAPPING
            - INVALID_MATCHING_SETTINGS
            - INVALID_OBJECT_TYPE
            - INVALID_REQUEST
            - INVALID_SCHEDULE
            - INVALID_SETTINGS
            - INVALID_SIGNATURE
            - INVALID_TARGET_LIST
            - INVALID_TENANT_ID
            - INVALID_TOKEN
            - INVALID_URL
            - INVALID_UUID
            - INVALID_WEBSITE_URL
            - JOB_CLIENT_NOT_CONFIGURED
            - JOB_CREATION_FAILED
            - JOB_NOT_FOUND
            - KEY_NOT_REGISTERED
            - LAST_ADMIN
            - LOAD_FAILED
            - MAPPING_NOT_FOUND
            - MATCHING_SETTINGS_CONFLICT
            - MATCHING_VERSION_NOT_FOUND
            - MERGES_DISABLED
            - MERGE_UNRESOLVED
            - MERGE_UNSUPPORTED
            - METHOD_NOT_ALLOWED
            - MISSING_FIELDS
            - MISSING_HEADER
            - MISSING_JOB_ID
            - MISSING_OBJECT_ID
            - MISSING_PORTAL_ID
            - MISSING_TENANT_ID
            - MISSING_USER_ID
            - NOT_APPLIED
            - NOT_AUTO_SAFE
            - NOT_CONFIGURED
            - NOT_CONNECTED
            - NOT_DUPLICATE_CLUSTER
            - NOT_ENABLED
            - NOT_FOUND
            - NOT_RETRYABLE
            - NOT_REVERTABLE
            - NO_ACTIVE_WAREHOUSE
            - NO_BUYER_TITLES
            - NO_CONNECTION
            - NO_LINKEDIN_URL
            - NO_MATCH_KEY
            - NO_ORG
            - NO_PACKAGE
            - NO_SLOT
            - NO_TEAM_FOUND
            - NO_TOKEN
            - NO_WEBSITE
            - ORG_LIMIT_EXCEEDED
            - PANIC_RECOVERED
            - PARSE_ERROR
            - PAYLOAD_TOO_LARGE
            - PAYMENT_REQUIRED
            - PERSON_LEFT
            - PORTAL_TENANT_MISMATCH
            - PRIVATE_CHANNEL_NEEDS_INVITE
            - PROCESSING_ERROR
            - PROFILE_NOT_RESOLVED
            - PROJECT_NOT_FOUND
            - PROPERTY_INSIGHTS_FAILED
            - PROPERTY_INSIGHTS_UNAVAILABLE
            - QUEUE_UNAVAILABLE
            - RATE_LIMITED
            - RATE_LIMITER_INIT_FAILED
            - RATE_LIMIT_EXCEEDED
            - REDIRECT_REFUSED
            - REFRESH_RATE_LIMITED
            - REFRESH_UNAVAILABLE
            - REPORT_ONLY_DUPLICATE
            - REQUEST_FAILED
            - RESEARCH_NOT_STARTED
            - RESOURCE_EXHAUSTED
            - RESPONSE_READ_FAILED
            - REVERT_BATCH_UNAVAILABLE
            - REVERT_CONFLICT
            - REVERT_EXPIRED
            - ROUTE_NOT_FOUND
            - SALESFORCE_NOT_CONNECTED
            - SALESFORCE_ORG_NOT_FOUND
            - SAVE_FAILED
            - SEARCH_FAILED
            - SERVICE_NOT_FOUND
            - SERVICE_UNAVAILABLE
            - SERVICE_UNREACHABLE
            - SETUP_FAILED
            - SETUP_RATE_LIMITED
            - SLACK_REJECTED
            - SNOWFLAKE_ERROR
            - STAFF_REQUIRED
            - SUPABASE_NEEDS_POOLER
            - SYNC_IN_PROGRESS
            - SYNC_PROPERTIES_DISABLED
            - SYNC_STATUS_UNAVAILABLE
            - SYNC_UNAVAILABLE
            - TABLE_SHAPE_MISMATCH
            - TARGET_ACCOUNTS_UNAVAILABLE
            - TARGET_LIST_NOT_BINDABLE
            - TARGET_LIST_NOT_FOUND
            - TASK_CREATION_FAILED
            - TENANT_LOOKUP_FAILED
            - TENANT_MISMATCH
            - TOO_MANY_HEADERS
            - TOO_SOON
            - UNAUTHORIZED
            - UNAVAILABLE
            - UNKNOWN_ERROR
            - UNKNOWN_FEATURE
            - UNKNOWN_PORTAL
            - UNKNOWN_PROVIDER
            - UNPROCESSABLE_ENTITY
            - UNSUPPORTED_FLOW
            - UNSUPPORTED_MEDIA_TYPE
            - UNSUPPORTED_OBJECT_TYPE
            - UNSUPPORTED_PROVIDER
            - UNSUPPORTED_RESOURCE_TYPE
            - UPSTREAM_ERROR
            - UPSTREAM_UNAVAILABLE
            - URL_TOO_LONG
            - USER_NOT_AUTHORIZED
            - VALIDATION_ERROR
            - VALUES_FAILED
            - VALUES_UNAVAILABLE
            - VERIFICATION_UNAVAILABLE
            - WEBHOOK_UNAVAILABLE
        message:
          type: string
          description: The sentence a person reads.
        details:
          type: string
          description: Developer text, returned outside production only.
        request_id:
          type: string
          description: >-
            The request's id, for support. Always set, and the same as the
            X-Request-ID response header.
  responses:
    BadRequest:
      description: Request validation failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthorized:
      description: Missing or invalid auth.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    NotFound:
      description: Resource does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    InternalServerError:
      description: Unexpected server-side failure.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.