Skip to main content
POST
/
v1
/
search
Search
curl --request POST \
  --url https://api.linqalpha.com/v1/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "What are the latest news on AAPL?",
  "stock_ids": [
    "BBG001S5N8V8"
  ],
  "tickers": [
    "AAPL"
  ],
  "external_types": [
    "transcript",
    "filing",
    "news",
    "ir_slide"
  ]
}
'
{
  "chat_message_id": "123e4567-e89b-12d3-a456-426614174000",
  "search_result_count": 38,
  "execution_time_ms": 10355,
  "references": [
    {
      "id": "12",
      "citation_idx": "12",
      "search_type": "rms",
      "chunk_id": "123e4567-e89b-12d3-a456-426614174000",
      "text": "For fiscal year 2024, Tesla expects EBIT to grow between 15% and 20%...",
      "text_type": "paragraph",
      "document_name": "Tesla 10-K 2023",
      "external_url": "https://www.sec.gov/ix?doc=/Archives/edgar/data/1318605/000095017024002308/tsla-20231231.htm",
      "metadata": {
        "source": "filing",
        "ticker": "TSLA",
        "published_at": "2024-02-14"
      },
      "custom_metadata": null
    }
  ]
}

Authorizations

X-API-KEY
string
header
required

Body

application/json
query
string
required

A search query

Example:

"What are the latest updates on AAPL?"

external_types
string[]
required

External document types

Example:
["transcript", "filing", "news", "ir_slide"]
stock_ids
string[]

Bloomberg stock IDs (optional)

Example:
["BBG001S5N8V8"]
tickers
string[]

Ticker symbols (optional)

Example:
["AAPL"]
top_k
number

Specifies the number of top search results to return. If the value exceeds 50, it will be capped at 50 The number of returned results will be less than or equal to the specified top_k value. Results are sorted by relevancy in descending order (from highest to lowest).

Example:

50

upload_period
object

Response

Search response

chat_message_id
string<uuid>
required

Chat message ID

search_result_count
number

Search result count

execution_time_ms
number

Execution time in milliseconds

references
object[]

References