LLM Research

links. Available results depend on the query, configured providers, and source coverage. A returned citation does not establish that the information is current.

What's inside#

Three complementary research surfaces:

• Web Search (/web_search): Combines link results, synthesis, and optional social research. Inspect the returned sources and available coverage for each query.
• Research Synthesis (/synthesis): Provider-generated research prose with source URLs. Review the cited material before using its claims.
• X/Twitter Sentiment (/x_sentiment): Provider-generated social narrative for a ticker or free-form query. It is not a verified, complete feed of current posts.

Publication dates and freshness#

Search results can have a missing or null published date. Treat their publication time as unknown. The envelope's timestamp records response generation, not source publication, and cannot establish that a result is recent. A successful response or a citation alone does not guarantee real-time information.

date_evidence preserves the provider's date meaning. A date labeled published_or_modified does not prove publication time; last_modified_date and relative-age hints remain distinct from published. Missing dates are never replaced with retrieval time. Inspect the evidence type as well as the value.

Check the linked source and any supplied publication date before making a time-sensitive claim. Responses may be cached; cached describes response reuse, not the freshness of the source material.

Access#

Endpoints#

Examples#

Bash: Multi-provider web search#

The response below illustrates the shape with placeholder text, not a captured result or a financial claim. Its null publication date demonstrates unknown source age; returned fields and provider coverage vary by request.

1curl -H "Authorization: Bearer $TENGU_API_KEY" \2  "https://firm.wealthnow.io/api/v3/research/web_search?query=NVIDIA%20earnings%20Q4%202024&providers=links,synthesis&count=5"3 4# Illustrative response structure, not live evidence:5# {6#   "ok": true,7#   "timestamp": "2024-12-16T14:22:00Z",8#   "query": "NVIDIA earnings Q4 2024",9#   "providers_used": ["links", "synthesis"],10#   "synthesized_answer": "<Provider synthesis; verify claims against the linked source.>",11#   "citations": [12#     {"url": "https://example.com/source", "title": "Example source"}13#   ],14#   "results": [15#     {16#       "title": "Example source",17#       "url": "https://example.com/source",18#       "snippet": "<Excerpt from the source.>",19#       "published": null,20#       "source_provider": "links"21#     }22#   ],23#   "total_results": 1,24#   "total_tokens": 1250,25#   "cached": false,26#   "search_time_ms": 342027# }

Python: Research synthesis with custom system prompt#

1import os, requests2 3r = requests.get(4    "https://firm.wealthnow.io/api/v3/research/synthesis",5    params={6        "query": "What are the key headwinds and tailwinds for Apple in 2025?",7        "system_prompt": "You are a skeptical equity analyst. Cite all sources. Be precise on numbers."8    },9    headers={"Authorization": f"Bearer {os.environ['TENGU_API_KEY']}"},10    timeout=30,11)12r.raise_for_status()13data = r.json()14 15# Extract the research envelope16print(f"Provider: {data['provider']}")17print(f"Answer:\n{data['answer']}")18print(f"Sources: {data['sources']}")19print(f"Citations:\n" + "\n".join(c["title"] for c in data["citations"]))20 21# Each call costs 6 credits; check wallet balance in the dashboard

Related#

• Pricing & credits — credit costs per product and plan details
• API reference — full endpoint specs and response schemas
• News & Sentiment — equity news headlines and sentiment (Starter+, 2 credits)