BRbrandbooster
remy
remy

Ai Search Endpoint

Changed on

Turn a plain-language creator brief into a scored, ranked creator table.

A sufficiently specific brief returns a job id at once and queues the search — a deep search reads 600 creators through the model, which can outlast the 120s TimeoutMiddleware. Poll the status route. A plainly broad brief (for example, "give me 10 creators") instead returns status=clarification_required, no job id, and up to three structured questions. Submit the combined answers to this same endpoint with the returned search_id as session_id; the backend retains the original request and starts the job once the brief has a useful subject.

session_id may identify an empty chat created by POST /ai-search/sessions; omit it to create and start a new persistent chat in this call. platforms and size come from the UI's own controls and override whatever the brief implied — a deliberate click beats an inference. depth caps how many candidates the scoring pass reads, which is what keeps cost flat as the corpus grows. live_content=true sources fresh creators from influencers.club and returns them in discovered_creators for the user to save; it is off by default because sourcing spends provider credits. Nothing it finds joins the roster on its own — POST /ai-search/{search_id}/save is what keeps a creator.

post/api/v1/remy/ai-search

Request

  • Base URL
    https://api.brandbooster.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.brandbooster.ai/api/v1/remy/ai-search
  • Auth
    HTTP bearer

Request body

querystring required
session_idstring uuid nullable
platformsstring[] nullable
size'under_10k' | '10k_100k' | '100k_500k' | '500k_1m' | '1m_plus'

The UI's Size selector. Values are FOLLOWER_BAND_BOUNDS keys, not tier names — the tier vocabulary (Nano/Micro/Mid/Macro) bands differently and would mis-filter against them.

depth'quick' | 'balanced' | 'deep'

How many candidates the scoring pass reads — the UI's Depth selector.

live_contentboolean
video_analysisboolean

Response

Successful Response

job_idstring nullable
search_idstring required
statusstring required
messagestring nullable
can_skipboolean

Changes

  • f84fc05f417bRevision changes
    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

  • 8e8c18c2dc35Revision changes
    • info

      added the new optional request property