Sign in
Audiences

Build audience from search parameters

Triggers the audience building process. This runs a company and prospect search based on the configured search parameters and saves results to the database. The build runs asynchronously - use the get-audience-status endpoint to poll for completion. Status transitions: DRAFT → BUILDING → NORMAL (success) or FAILED (error).

<span>⚡ <strong>Rate limit:</strong> 30 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> Credits are charged after the build completes based on results: 1 credits per company and 1 credits per profile found. <span title="Pricing shown is default pricing. Actual pricing may vary. Your total charge will vary based on the number of companies and profiles in your audience.">ⓘ</span></span>

post/v1/audiences/{audienceId}/build

Path parameters

audienceIdstring required

The unique ID of the audience.

Request body

apiKeystring required

Your Fiber API key

Response

Default Response

advicestring[] nullable

Tips, recommendations, and suggestions for using this API effectively.

Changes

Changed in 1 of the 12 revisions of this API.21

  • 4002aa81d4fb21See the full diff
    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ○

      the response's property default value was removed for the status

      response-property-default-value-removed