Skip to main content
GET
/
api
/
v1
/
search
Unified semantic search
curl --request GET \
  --url https://v2.api.adj.news/api/v1/search \
  --header 'Authorization: Bearer <token>'
{
  "query": "<string>",
  "type": "<string>",
  "total_results": 123,
  "results": [
    {
      "entity_type": "<string>",
      "entity_id": "<string>",
      "similarity": 123,
      "name": "<string>",
      "description": "<string>",
      "latest_price": 123,
      "category": "<string>",
      "platform": "<string>"
    }
  ]
}
AI-powered semantic search across markets, events, indices, and reference rates.

​
How It Works

Semantic search finds results based on meaning, not just keywords.
QueryFinds
”Economic downturn”Markets about recession, GDP decline, unemployment
”Climate action”Markets about carbon tax, renewable energy
”Tech regulation”Markets about antitrust, data privacy

​
Query Parameters

​
q
string
required
Your search query in natural language.
​
type
string
Filter by entity type: market, event, index, rate.
​
limit
integer
default:10
Maximum number of results (1-100).
​
min_similarity
number
Minimum similarity threshold (0.0-1.0).
​
max_similarity
number
Maximum similarity threshold (0.0-1.0).

​
Response

{
  "query": "senate colorado",
  "type": "market",
  "total_results": 3,
  "results": [
    {
      "entity_type": "market",
      "entity_id": "SENATECO-26-R",
      "similarity": 0.892,
      "name": "Will the Republican party win the Senate seat in Colorado",
      "description": "This market resolves to Yes if...",
      "latest_price": 5.0,
      "category": "senate",
      "platform": "kalshi"
    }
  ]
}
FieldTypeDescription
querystringOriginal search query
typestringEntity type filter
total_resultsintegerNumber of results
resultsarrayList of matching entities

​
Result Fields

FieldTypeDescription
entity_typestringType (market, event, index, rate)
entity_idstringUnique identifier
similaritynumberSemantic similarity (0.0-1.0)
namestringEntity name/question
descriptionstringEntity description
latest_pricenumberCurrent price
categorystringCategory
platformstringPlatform (for markets)

​
Similarity Interpretation

ScoreInterpretation
0.9-1.0Nearly exact match
0.7-0.9Highly relevant
0.5-0.7Moderately relevant
0.3-0.5Loosely related

​
Examples

# Search markets
curl "https://v2.api.adj.news/api/v1/search?q=senate&type=market&limit=5" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Search all types
curl "https://v2.api.adj.news/api/v1/search?q=republican%20chances%202028" \
  -H "Authorization: Bearer YOUR_TOKEN"

# With similarity threshold
curl "https://v2.api.adj.news/api/v1/search?q=climate%20policy&min_similarity=0.7" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Errors

StatusDescription
400Missing query parameter

Authorizations

​
Authorization
string
header
required

Auth0 JWT Bearer token

Query Parameters

​
q
string
required

Search query

​
type
enum<string>

Filter by entity type

Available options:
market,
event,
index,
rate
​
limit
integer
default:10

Max results

​
min_similarity
number
default:0

Min similarity (0.0-1.0)

​
max_similarity
number
default:1

Max similarity (0.0-1.0)

Response

200 - application/json

Search results

​
query
string
​
type
string | null
​
total_results
integer
​
results
object[]