Skip to main content
GET
/
v1
/
search
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/search?q=AI%20chip%20supply%20chain&limit=5"

{
  "data": [
    {
      "unit_id": "clm_01JABCDEF987654321",
      "unit_type": "analysis_claim",
      "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter as supply constraints eased.",
      "signal_id": "sig_01JABCDEF123456789",
      "score": 0.0312
    },
    {
      "unit_id": "ts_01JABCDEF111111111",
      "unit_type": "thesis_sentence",
      "text": "The AI chip supply chain is undergoing a structural shift toward diversified manufacturing.",
      "signal_id": "sig_01JABCDEF222222222",
      "score": 0.0298
    }
  ],
  "query": "AI chip supply chain"
}
​
q
string
Search query text. Required unless similar_to is provided.
​
similar_to
string
Text unit ID to find similar units for. Uses the unit’s stored embedding for pure vector similarity search. Required unless q is provided. Exactly one of q or similar_to must be provided.
​
unit_type
string
Filter by text unit type: thesis_sentence, argument_sentence, summary_sentence, analysis_claim, event_claim.
​
entity
string
Filter results to a specific entity.
​
theme
string
Filter results to a specific theme.
​
recency_boost
number
default:"0.0"
Recency weight (0=none, 1=max). Boosts newer signals in ranking.
​
verification_detail
string
Set to full for complete verification metadata.
​
limit
integer
default:"10"
Max results to return (1–25).
​
data
array
Ranked search results.
​
query
string
The search query that was executed.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/search?q=AI%20chip%20supply%20chain&limit=5"

{
  "data": [
    {
      "unit_id": "clm_01JABCDEF987654321",
      "unit_type": "analysis_claim",
      "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter as supply constraints eased.",
      "signal_id": "sig_01JABCDEF123456789",
      "score": 0.0312
    },
    {
      "unit_id": "ts_01JABCDEF111111111",
      "unit_type": "thesis_sentence",
      "text": "The AI chip supply chain is undergoing a structural shift toward diversified manufacturing.",
      "signal_id": "sig_01JABCDEF222222222",
      "score": 0.0298
    }
  ],
  "query": "AI chip supply chain"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Include in every request as X-API-Key: gld_your_key_here.

Query Parameters

​
q
string | null

Search query text. Required unless similar_to is provided.

Minimum string length: 1
​
similar_to
string | null

Text unit ID to find similar units for. Uses the unit's stored embedding for pure vector similarity search. Required unless q is provided.

​
unit_type
string | null

Filter by text unit type: 'thesis_sentence', 'argument_sentence', 'summary_sentence', 'analysis_claim', 'event_claim'.

​
entity
string | null

Filter results to a specific entity.

​
theme
string | null

Filter results to a specific theme.

​
published_after
string | null

ISO 8601 date — only results published after this date.

​
published_before
string | null

ISO 8601 date — only results published before this date.

​
recency_boost
number
default:0

Recency weight (0=none, 1=max). Boosts newer signals.

Required range: 0 <= x <= 1
​
verification_detail
string | null

Set to 'full' for complete verification metadata.

​
limit
integer
default:10

Max results to return (1–25).

Required range: 1 <= x <= 25

Response

Successful Response

​
data
SearchHit · object[]
required

Ranked search results.

​
query
string
required

The original search query.

Example:

"AI chip supply chain"