SUsuprsonic
Suprsonic

Deep Research

Changed on

Multi-step deep research: search, scrape, enrich entities, and synthesize into a cited report. Returns a report (title, summary, sections, key findings, confidence) with numbered sources and the people and companies it found, enriched. Use for a question that needs many sources and a synthesized, cited answer. It takes far longer and costs more than search, which suits a quick fact. Cost: standard 10 credits, deep 20 credits, comprehensive 35 credits, charged only when a call succeeds. Options change it: include_analysis true +5, academic in source_types +2, enrich_entities false -3, synthesis false -5.

post/v1/research

Request

Request body

querystring required
depthstring
enrich_entitiesboolean
include_analysisboolean
synthesisboolean
output_schemaobject nullable
source_typesstring[]
domain_whiteliststring[] nullable
domain_blackliststring[] nullable
max_sourcesinteger
freshnessstring

Response

The call's envelope: success, data (the capability's result), metadata, and credits_used (0 when the call did not succeed).

successboolean required
credits_usedinteger

Changes

  • 120f2dd4c855Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 9edc3bfe1b9cRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status