---
title: "Smart Search Research"
method: POST
path: "/api/v1/research/smart-search-research"
tags: ["research"]
---

# Smart Search Research

`POST /api/v1/research/smart-search-research`

## 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/research/smart-search-research`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/brandbooster/apis/brandbooster-api/docs/api/v1/research/smart-search-research/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `use_model` boolean
- `plan` boolean: False when the page already parsed the request (smart search)

## Request body

- ResearchDataRequestDTO
  - `countries` string[], nullable
  - `ad_platforms` string[], nullable
  - `ad_display_format` string[], nullable
  - `category` string[], nullable
  - `impression` string[], nullable
  - `ad_stage` integer[], nullable
  - `sort_type` string, nullable
  - `sort_direction` string, nullable
  - `ad_status` string[], nullable
  - `keyword_value` string[], nullable
  - `brand_value` string[], nullable
  - `title_value` string[], nullable
  - `tiktok_reach` string, nullable
  - `language` string[], nullable
  - `family` string[], nullable
  - `is_organic` boolean, nullable
  - `is_partnership` boolean, nullable
  - `focus_area` string[], nullable
  - `campaign_objective` string[], nullable
  - `hook_type` string[], nullable
  - `ad_concept` string[], nullable
  - `talent_presenter_type` string[], nullable
  - `cta_type` string[], nullable
  - `visual_style` string[], nullable
  - `emotional_tone` string[], nullable
  - `personas` string[], nullable
  - `hook_style` string[], nullable
  - `hook_category` string[], nullable
  - `ad_style` string[], nullable
  - `logo_placement` string[], nullable
  - `text_overlay_density` string[], nullable
  - `logo_timing` string[], nullable
  - `claim_type` string[], nullable
  - `proof_element` string[], nullable
  - `disclaimer_present` string[], nullable
  - `social_proof_element` string[], nullable
  - `offer_type` string[], nullable
  - `target_gender` string[], nullable
  - `talent_count` string[], nullable
  - `talent_delivery` string[], nullable
  - `talent_age_band` string[], nullable
  - `talent_gender` string[], nullable
  - `product_visibility` string[], nullable
  - `scene_setting` string[], nullable
  - `audio_style` string[], nullable
  - `pacing_style` string[], nullable
  - `creative_category` string[], nullable
  - `ai_generated` string[], nullable
  - `video_len` integer[], nullable
  - `sub_industries` string[], nullable
  - `date` string[], nullable
  - `brand_page_id` string, nullable
  - `avatar_url` string, nullable
  - `linkedin` boolean, nullable
  - `linkedin_company_name` string, nullable
  - `linkedin_keyword` string, nullable
  - `pinterest` boolean, nullable
  - `pinterest_keyword` string, nullable
  - `tiktok` boolean, nullable
  - `tiktok_keyword` string, nullable
  - `tiktok_ads` boolean, nullable
  - `tiktok_shop` boolean, nullable
  - `advertiser_token` string, nullable
  - `meta` boolean, nullable
  - `facebook_profile` boolean, nullable
  - `google_ads` boolean, nullable
  - `instagram` boolean, nullable
  - `meta_keyword` string, nullable
  - `meta_brand_value` string, nullable
  - `meta_page_id` string, nullable
  - `youtube` boolean, nullable
  - `youtube_keyword` string, nullable
  - `live_scraping_on` boolean, nullable
  - `page` integer
  - `page_size` integer
  - `has_next` boolean
  - `fuzzyPageNum` integer
  - `next_cursor` string, nullable
  - `has_next_page` boolean, nullable
  - `load_more` boolean, nullable
  - `scrapping_keywords` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 62 revisions in range; 1 not diffed.

- **2026-11-11** `94df94cf6519`: 1 info
  - added the new optional `query` request parameter `plan`
- **2026-11-11** `0f2fd9643c45`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/research/smart-search-research/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/6218d3c51599?raw)