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

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/624917d53409/schema)