---
title: "Get Data From Research"
method: POST
path: "/api/v1/research/get-data-from-research"
tags: ["research"]
---

# Get Data From Research

`POST /api/v1/research/get-data-from-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/get-data-from-research`
- Auth: HTTP bearer

## 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

> 36 revisions in range; 1 not diffed.

- **2026-10-22** `6841ed70c8d1`: 1 info
  - added the new optional request property `ai_generated`
- **2026-10-13** `c7202552278d`: 1 info
  - added the new optional request property `tiktok_shop`

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/research/get-data-from-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/f84fc05f417b?raw)