Audiences

Build audience from search parameters

Changed on

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

Request

  • Base URL
    https://api.fiber.ai
  • URL
    https://api.fiber.ai/v1/audiences/{audienceId}/build
  • Auth
    none declared

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

  • 4002aa81d4fbRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • info

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

  • f14ac2efab0cRevision changes
    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status