DeepDive Parameters

Complete parameter reference for AI-powered research and analysis

AI Research Platform

DeepDive uses advanced AI to analyze multiple sources, identify patterns, and generate actionable insights. Parameter selection affects analysis quality and processing time.

Core Research Parameters

Essential Research Configuration

Parameter	Type	Required	Description
`research_query`	string	Required	The main research question or topic to investigate. Should be specific and well-defined. Example:`"Impact of remote work on employee productivity in tech companies"`
`sources`	array	Optional	Types of sources to include in the research analysis. Example:`["academic", "news", "industry_reports", "social_media"]`
`analysis_depth`	string	Optional	Depth of AI analysis to perform on the collected data. Example:`"comprehensive", "standard", "quick"`
`max_sources`	integer	Optional	Maximum number of sources to analyze for the research. Example:`25`
`timeframe`	string	Optional	Time period to focus the research on (affects source selection). Example:`"last_year", "2020-2025", "current"`
`language`	string	Optional	Primary language for source analysis and response generation. Example:`"en", "es", "fr", "de"`
`geographic_focus`	array	Optional	Geographic regions to prioritize in the research. Example:`["North America", "Europe", "Asia-Pacific"]`

Analysis Configuration

AI Analysis Settings

Parameter	Type	Required	Description
`analysis_type`	string	Optional	Specific type of analysis to perform on the research data. Example:`"competitive_analysis", "market_research", "academic_review"`
`entities`	array	Optional	Specific entities (companies, people, products) to focus the analysis on. Example:`["Tesla", "Toyota", "Volkswagen"]`
`focus_areas`	array	Optional	Specific aspects or topics to emphasize in the analysis. Example:`["pricing", "market_share", "innovation", "customer_satisfaction"]`
`include_sentiment`	boolean	Optional	Perform sentiment analysis on sources and entities. Example:`true`
`include_trends`	boolean	Optional	Identify and analyze trends in the research domain. Example:`true`
`confidence_threshold`	float	Optional	Minimum confidence score for including insights in results. Example:`0.7`
`cross_reference`	boolean	Optional	Cross-reference findings across multiple sources for validation. Example:`true`

Output Configuration

Response Format & Export Options

Parameter	Type	Required	Description
`generate_summary`	boolean	Optional	Generate an executive summary of the research findings. Example:`true`
`include_citations`	boolean	Optional	Include properly formatted citations for all analyzed sources. Example:`true`
`citation_format`	string	Optional	Format style for generated citations. Example:`"apa", "mla", "chicago", "ieee"`
`generate_recommendations`	boolean	Optional	Generate actionable recommendations based on findings. Example:`true`
`include_methodology`	boolean	Optional	Include detailed methodology explanation in the response. Example:`false`
`export_format`	string	Optional	Additional export format for the research report. Example:`"pdf", "docx", "markdown"`
`visualization_data`	boolean	Optional	Include structured data for creating charts and visualizations. Example:`true`

Available Source Types

Academic Sources

• Peer-reviewed journals

• Research papers

• Conference proceedings

• Academic databases

• Thesis and dissertations

High Authority

News & Media

• News articles

• Press releases

• Industry publications

• Blog posts

• Expert opinions

Current Events

Industry Reports

• Market research reports

• Financial analysis

• Industry surveys

• White papers

• Case studies

Market Insights

Financial Data

• SEC filings

• Earnings reports

• Financial statements

• Analyst reports

• Market data

Financial Focus

Social Media

• Social media posts

• User discussions

• Product reviews

• Community feedback

• Influencer content

Public Sentiment

Patents & IP

• Patent filings

• Patent analysis

• IP portfolios

• Technology trends

• Innovation tracking

Innovation Focus

Credit Consumption

Base Costs

Quick analysis:

10 credits

Standard analysis:

25 credits

Comprehensive analysis:

50 credits

Per additional source:

+1 credit

Feature Costs

Sentiment analysis:

+5 credits

Trend identification:

+8 credits

Entity analysis:

+3 credits/entity

PDF/DOCX export:

+10 credits

Response Format

DeepDive Response Fields

Field	Type	Description
`executive_summary`	string	AI-generated executive summary of all research findings. Example:`"The research indicates a 23% increase in productivity when implementing remote work policies..."`
`key_insights`	array	Array of key insights with confidence scores and supporting evidence. Example:`[{"insight": "...", "confidence": 0.89, "evidence_count": 15, "sources": [...]}]`
`entity_analysis`	object	Detailed analysis for each specified entity (if entities parameter used). Example:`{"Tesla": {"sentiment": 0.72, "mentions": 45, "key_topics": [...]}}`
`trend_analysis`	array	Identified trends with direction, confidence, and timeframe (if include_trends=true). Example:`[{"trend": "...", "direction": "increasing", "confidence": 0.85, "timeframe": "2024-2025"}]`
`sources_analyzed`	array	Complete list of sources with metadata, relevance scores, and analysis notes. Example:`[{"url": "...", "title": "...", "type": "academic", "relevance": 0.92, "date": "2024-12-15"}]`
`citations`	array	Properly formatted citations in the requested citation format. Example:`[{"citation": "Smith, J. (2024). Research Title. Journal Name, 15(3), 123-145.", "url": "..."}]`
`recommendations`	array	AI-generated actionable recommendations (if generate_recommendations=true). Example:`[{"recommendation": "...", "rationale": "...", "priority": "high", "implementation": "..."}]`
`methodology`	object	Detailed explanation of research methodology used (if include_methodology=true). Example:`{"approach": "...", "source_selection": "...", "analysis_methods": [...], "limitations": [...]}`
`visualization_data`	object	Structured data for creating charts and graphs (if visualization_data=true). Example:`{"charts": [...], "tables": [...], "metrics": {...}}`
`export_url`	string	Download URL for exported report (if export_format specified). Example:`"https://cdn.searchhive.com/reports/research_abc123.pdf"`
`processing_time`	float	Total time taken to complete the research analysis in seconds. Example:`127.3`
`credits_used`	integer	Number of API credits consumed by this research request. Example:`45`

Example Requests

Basic Research Request

Simple research with standard analysis depth and common source types:

Basic DeepDive Research

curl -X POST https://www.searchhive.dev/api/v1/deepdive \
  -H "Authorization": "Bearer: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "research_query": "Benefits of electric vehicles for urban transportation",
    "sources": ["academic", "news", "industry_reports"],
    "max_sources": 15,
    "analysis_depth": "standard"
  }'

Comprehensive Analysis Request

Full-featured research with all analysis options and export capabilities:

Comprehensive DeepDive Analysis

Analysis Type Reference

competitive_analysis

Purpose:

Compare entities across multiple dimensions and identify competitive advantages.

Required Parameters:

• entities (array)
• focus_areas (array)

market_research

Purpose:

Analyze market conditions, trends, and opportunities in a specific industry.

Recommended Sources:

• industry_reports
• financial
• news

academic_review

Purpose:

Systematic review of academic literature with citation analysis and research gaps.

Features:

• Citation networks
• Research methodology analysis
• Gap identification

Parameter Best Practices

Optimization Strategies

Research query specificity:

Use specific, focused questions rather than broad topics.

Source selection:

Choose source types that align with your research objectives.

Analysis depth balance:

Use 'quick' for exploratory research, 'comprehensive' for final analysis.

Entity focus:

Limit entities to 5-10 for focused competitive analysis.

Common Issues

Overly broad queries:

Vague research questions produce unfocused results.

Insufficient source diversity:

Single source types can create biased analysis.

Too many entities:

Analyzing 10+ entities dilutes focus and increases costs.

Ignoring timeframe:

Outdated sources can skew analysis for current topics.