DeepDive API Reference

Interactive testing for AI-powered research and analysis

AI Research Platform

Test DeepDive's advanced AI research capabilities including multi-source analysis, trend identification, and comprehensive report generation with citations.

POST

https://www.searchhive.dev/api/v1/deepdive

AI-Powered Research & Analysis

Conduct comprehensive research with AI analysis, trend identification, and professional report generation

Request Builder

API Key

Using demo key for testing. Replace with your actual API key.

Parameters

research_query

Required

The main research question or topic to investigate. Should be specific and well-defined.

sources

Types of sources to include in the research analysis.

analysis_depth

Depth of AI analysis to perform on the collected data.

max_sources

Maximum number of sources to analyze for the research (5-100).

timeframe

Time period to focus the research on (affects source selection).

language

Primary language for source analysis and response generation.

geographic_focus

Geographic regions to prioritize in the research.

analysis_type

Specific type of analysis to perform on the research data.

entities

Specific entities (companies, people, products) to focus the analysis on.

focus_areas

Specific aspects or topics to emphasize in the analysis.

include_sentiment

Enable include_sentiment

Perform sentiment analysis on sources and entities.

include_trends

Enable include_trends

Identify and analyze trends in the research domain.

confidence_threshold

Minimum confidence score for including insights in results (0.0-1.0).

generate_summary

Enable generate_summary

Generate an executive summary of the research findings.

include_citations

Enable include_citations

Include properly formatted citations for all analyzed sources.

citation_format

Format style for generated citations.

generate_recommendations

Enable generate_recommendations

Generate actionable recommendations based on findings.

export_format

Additional export format for the research report.

visualization_data

Enable visualization_data

Include structured data for creating charts and visualizations.

Code Examples

import requests

response = requests.post(
    "https://www.searchhive.dev/api/v1/deepdive",
    headers={"Authorization": "Bearer " + "demo_sk_deepdive_54321"},
    json={
  "research_query": "AI impact on software development productivity 2025",
  "sources": [
    "academic",
    "news",
    "industry_reports"
  ],
  "analysis_depth": "standard",
  "max_sources": 25,
  "timeframe": "2024-2025",
  "language": "en",
  "geographic_focus": [
    "North America",
    "Europe"
  ],
  "analysis_type": "market_research",
  "entities": [
    "OpenAI",
    "GitHub Copilot",
    "Microsoft"
  ],
  "focus_areas": [
    "productivity",
    "code_quality",
    "developer_experience"
  ],
  "include_sentiment": true,
  "include_trends": true,
  "confidence_threshold": "0.7",
  "generate_summary": true,
  "include_citations": true,
  "citation_format": "apa",
  "generate_recommendations": false,
  "export_format": "",
  "visualization_data": false
}
)

data = response.json()
print(data)

API Response

Click "Test API" to see the response

Response Schema

DeepDive Response Fields

Field	Type	Description
`executive_summary`	string	AI-generated executive summary of all research findings. Example:`"The research indicates a 35% increase in developer productivity when using AI-powered coding assistants..."`
`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:`{"OpenAI": {"sentiment": 0.82, "mentions": 127, "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). AI Development Impact. Tech Journal, 15(3), 123-145.", "url": "..."}]`
`recommendations`	array	AI-generated actionable recommendations (if generate_recommendations=true). Example:`[{"recommendation": "...", "rationale": "...", "priority": "high", "implementation": "..."}]`
`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:`187.6`
`credits_used`	integer	Number of API credits consumed by this research request. Example:`42`
`remaining_credits`	integer	Remaining API credits in your account. Example:`9958`
`request_id`	string	Unique identifier for this research request. Example:`"req_deepdive_987654321"`

AI Research Features

Multi-Source Analysis

• Academic papers

• Industry reports

• News articles

• Financial data

Trend Identification

• Pattern recognition

• Trend direction analysis

• Confidence scoring

• Temporal analysis

Entity Analysis

• Competitive positioning

• Sentiment tracking

• Market share analysis

• Brand perception

Report Generation

• Executive summaries

• Academic citations

• Actionable insights

• Export formats

Analysis Types

Competitive Analysis

Compare entities across multiple dimensions and identify competitive advantages

{ "analysis_type": "competitive_analysis", "entities": ["Company A", "Company B", "Company C"], "focus_areas": ["market_share", "pricing", "features"], "include_sentiment": true }

Market Research

Analyze market conditions, trends, and opportunities in specific industries

{ "analysis_type": "market_research", "sources": ["industry_reports", "financial", "news"], "include_trends": true, "timeframe": "2024-2025" }

Academic Review

Systematic review of academic literature with citation analysis

{ "analysis_type": "academic_review", "sources": ["academic", "patents"], "include_citations": true, "citation_format": "apa" }

Trend Analysis

Identify emerging trends and predict future developments

{ "analysis_type": "trend_analysis", "include_trends": true, "visualization_data": true, "generate_recommendations": true }

Available Source Types

Academic Sources

• Peer-reviewed journals

• Research papers

• Conference proceedings

• Academic databases

High Authority

News & Media

• News articles

• Press releases

• Industry publications

• Expert opinions

Current Events

Industry Reports

• Market research reports

• Financial analysis

• Industry surveys

• White papers

Market Insights

Financial Data

• SEC filings

• Earnings reports

• Financial statements

• Analyst reports

Financial Focus

Social Media

• Social media posts

• User discussions

• Product reviews

• Community feedback

Public Sentiment

Patents & IP

• Patent filings

• Patent analysis

• IP portfolios

• Technology trends

Innovation Focus

Error Codes

200 OK

Research completed successfully

400 Bad Request

Invalid research query or parameters

402 Payment Required

Insufficient credits for research depth

503 Service Unavailable

AI analysis service temporarily unavailable

Credit Consumption

Base Analysis Costs

Quick analysis:

10 credits

Standard analysis:

25 credits

Comprehensive analysis:

50 credits

Per additional source:

+1 credit

Advanced Features

Sentiment analysis:

+5 credits

Trend identification:

+8 credits

Entity analysis:

+3 credits/entity

Report export (PDF/DOCX):

+10 credits