BRbrandbooster
research

Smart Search Research

Changed on

Discover keyword search ranked by what is in the Ad (hook, transcript, analysis, tags). Anything it does not cover (brand search, Live Search, the scrape follow-up) and any failure runs today's /get-data-from-research flow instead.

post/api/v1/research/smart-search-research

Request

Query parameters

use_modelboolean
planboolean

False when the page already parsed the request (smart search)

Request body

countriesstring[] nullable
ad_platformsstring[] nullable
ad_display_formatstring[] nullable
categorystring[] nullable
impressionstring[] nullable
ad_stageinteger[] nullable
sort_typestring nullable
sort_directionstring nullable
ad_statusstring[] nullable
keyword_valuestring[] nullable
brand_valuestring[] nullable
title_valuestring[] nullable
tiktok_reachstring nullable
languagestring[] nullable
familystring[] nullable
is_organicboolean nullable
is_partnershipboolean nullable
focus_areastring[] nullable
campaign_objectivestring[] nullable
hook_typestring[] nullable
ad_conceptstring[] nullable
talent_presenter_typestring[] nullable
cta_typestring[] nullable
visual_stylestring[] nullable
emotional_tonestring[] nullable
personasstring[] nullable
hook_stylestring[] nullable
hook_categorystring[] nullable
ad_stylestring[] nullable
logo_placementstring[] nullable
text_overlay_densitystring[] nullable
logo_timingstring[] nullable
claim_typestring[] nullable
proof_elementstring[] nullable
disclaimer_presentstring[] nullable
social_proof_elementstring[] nullable
offer_typestring[] nullable
target_genderstring[] nullable
talent_countstring[] nullable
talent_deliverystring[] nullable
talent_age_bandstring[] nullable
talent_genderstring[] nullable
product_visibilitystring[] nullable
scene_settingstring[] nullable
audio_stylestring[] nullable
pacing_stylestring[] nullable
creative_categorystring[] nullable
ai_generatedstring[] nullable
video_leninteger[] nullable
sub_industriesstring[] nullable
datestring[] nullable
brand_page_idstring nullable
avatar_urlstring nullable
linkedinboolean nullable
linkedin_company_namestring nullable
linkedin_keywordstring nullable
pinterestboolean nullable
pinterest_keywordstring nullable
tiktokboolean nullable
tiktok_keywordstring nullable
tiktok_adsboolean nullable
tiktok_shopboolean nullable
advertiser_tokenstring nullable
metaboolean nullable
facebook_profileboolean nullable
google_adsboolean nullable
instagramboolean nullable
meta_keywordstring nullable
meta_brand_valuestring nullable
meta_page_idstring nullable
youtubeboolean nullable
youtube_keywordstring nullable
live_scraping_onboolean nullable
pageinteger
page_sizeinteger
has_nextboolean
fuzzyPageNuminteger
next_cursorstring nullable
has_next_pageboolean nullable
load_moreboolean nullable
scrapping_keywordsstring[] nullable

Response

Successful Response

unknown required

Changes