GET
/
api
/
news
/
{market}
curl --request GET \
  --url https://api.data.adj.news/api/news/{market} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "title": "<string>",
      "url": "<string>",
      "publishedDate": "<string>",
      "author": "<string>",
      "domain": "<string>"
    }
  ],
  "meta": {
    "query": "<string>",
    "days": 123,
    "limit": 123,
    "excludeDomains": [
      "<string>"
    ]
  }
}

AI-Powered News Discovery for Prediction Markets

This endpoint leverages advanced neural search technology to retrieve highly relevant news articles related to specific markets or market topics. By analyzing the semantic meaning of your query, it delivers curated news content that could impact market outcomes, helping traders, researchers, and analysts stay informed about events that might influence prediction market results.

How Neural Search Works

Our news discovery system uses sophisticated AI technology to understand the context and meaning behind your market queries:

🧠 Neural Search Process

  1. Query Understanding: Your market query is processed through advanced language models to understand the semantic meaning and context
  2. Exa Neural Search: We use Exa’s state-of-the-art neural search engine to find articles that are conceptually related to your query
  3. Content Filtering: Automatically filters out prediction market platforms to avoid circular references and self-referential content
  4. Relevance Ranking: Results are ranked by semantic similarity and potential market impact
  5. Quality Assurance: Articles are filtered for quality, recency, and relevance

🎯 Why This Matters

Traditional keyword-based search might miss crucial news that uses different terminology. For example:

  • Searching for “presidential election” will also find articles about “White House race,” “commander in chief,” or “POTUS”
  • A query about “AI regulation” will surface news about “artificial intelligence policy,” “machine learning governance,” or “tech oversight”

API Reference

Path Parameters

market
string
required

The market query to search for news. This can be:

  • A complete market question: “Will the White House Press Secretary say Hoax?”
  • A market topic: “presidential election 2024”
  • Keywords: “AI regulation”
  • Market identifiers: “TRUMP2024”

Query Parameters

days
integer
default:7

Number of days to look back for news articles.

  • Range: 1-30 days
  • Default: 7 days
  • Tip: Use longer periods (14-30 days) for less frequent topics
limit
integer
default:10

Maximum number of results to return.

  • Range: 1-50 articles
  • Default: 10 articles
  • Note: Larger limits may increase response time
excludeDomains
string

Comma-separated list of domains to exclude from results.

  • Format: "cnn.com,foxnews.com,reddit.com"
  • Use Case: Filter out specific news sources or social media
  • Default Exclusions: Prediction market platforms (see below)
includeDomains
string

Comma-separated list of domains to prioritize in results.

  • Format: "reuters.com,bloomberg.com,wsj.com"
  • Use Case: Focus on specific trusted news sources
  • Note: This filters results to only include specified domains

Response Format

Successful Response

{
  "data": [
    {
      "title": "White House Press Secretary addresses recent allegations in heated briefing",
      "url": "https://politico.com/news/2025/01/24/press-secretary-briefing-allegations-123456",
      "publishedDate": "2025-01-24T15:30:00Z",
      "author": "Jane Smith",
      "domain": "politico.com",
      "snippet": "During today's press briefing, the White House Press Secretary directly addressed the allegations, calling them 'completely unfounded' and refusing to dignify what she termed as 'political theater' with further comment..."
    },
    {
      "title": "Political analysts weigh in on administration's communication strategy",
      "url": "https://reuters.com/politics/administration-communication-strategy-789012",
      "publishedDate": "2025-01-24T12:15:00Z",
      "author": "Mike Johnson",
      "domain": "reuters.com", 
      "snippet": "Political experts suggest the administration's recent communication approach may signal a shift in strategy as they navigate mounting political pressure..."
    }
  ],
  "meta": {
    "query": "Will the White House Press Secretary say Hoax",
    "days": 7,
    "limit": 10,
    "totalResults": 2,
    "searchTime": "0.85s",
    "excludeDomains": ["kalshi.com", "metaculus.com", "manifold.markets", "polymarket.com"],
    "searchMethod": "neural", // or "fallback" if neural search failed
    "queryProcessed": "White House Press Secretary communication allegations controversy"
  }
}

Response Fields Explained

FieldDescriptionNotes
titleArticle headlineOriginal title from the news source
urlDirect link to articleAlways accessible, not behind paywalls when possible
publishedDatePublication timestampISO 8601 format with timezone
authorArticle authorMay be null for some sources
domainSource domainUseful for filtering and credibility assessment
snippetArticle excerpt100-300 characters of relevant content

Default Domain Exclusions

To provide the most relevant external news and avoid circular references, we automatically exclude prediction market platforms:

Excluded Platforms

  • kalshi.com - Kalshi prediction markets
  • metaculus.com - Metaculus forecasting platform
  • manifold.markets - Manifold Markets
  • polymarket.com - Polymarket
  • predictit.org - PredictIt
  • betfair.com - Betfair prediction markets

Customizing Exclusions

You can override or extend these exclusions:

# Exclude additional domains
curl "https://api.data.adj.news/api/news/AI%20regulation?excludeDomains=twitter.com,reddit.com,cnn.com"

# Include only specific domains (overrides defaults)
curl "https://api.data.adj.news/api/news/presidential%20election?includeDomains=reuters.com,bloomberg.com,wsj.com"

Comprehensive Examples

Basic News Retrieval

# Get recent news about a market topic
curl "https://api.data.adj.news/api/news/presidential%20election%202024"

Advanced Filtering

# Get 20 articles from the past 14 days, excluding social media
curl "https://api.data.adj.news/api/news/AI%20regulation?days=14&limit=20&excludeDomains=twitter.com,reddit.com,facebook.com"
# Get news only from major financial publications
curl "https://api.data.adj.news/api/news/federal%20reserve%20interest%20rates?includeDomains=reuters.com,bloomberg.com,wsj.com,ft.com"

Market-Specific News

# News for a specific market question
curl "https://api.data.adj.news/api/news/Will%20the%20US%20inflation%20rate%20exceed%203%25%20in%202025"

Use Cases & Applications

1. Market Research & Analysis

# Research market fundamentals
curl "https://api.data.adj.news/api/news/US%20inflation%20economic%20indicators?days=30"

Use for: Understanding the underlying factors that might affect market outcomes

2. Event Monitoring

# Monitor ongoing events
curl "https://api.data.adj.news/api/news/Supreme%20Court%20decisions?days=3&limit=15"

Use for: Tracking events in real-time that could trigger market resolutions

3. Sentiment Analysis Pipeline

# Gather articles for sentiment analysis
curl "https://api.data.adj.news/api/news/cryptocurrency%20regulation?days=7&limit=50"

Use for: Building datasets for sentiment analysis and market prediction models

4. Content Aggregation

# Create news feeds for specific topics
curl "https://api.data.adj.news/api/news/climate%20change%20policy?days=7&includeDomains=reuters.com,ap.org,bbc.com"

Use for: Building news dashboards and content aggregation services

5. Research & Journalism

# Deep dive research on specific topics
curl "https://api.data.adj.news/api/news/election%20security%20voting%20technology?days=21&limit=30"

Use for: Investigative research and journalistic background gathering

Advanced Features

Query Optimization Tips

  1. Be Specific: “Federal Reserve interest rate decision” vs “Fed rates”
  2. Use Market Language: Include terms commonly used in your target market
  3. Consider Synonyms: The neural search will find related terms, but specific keywords help
  4. Date Sensitivity: Use longer lookback periods for infrequent topics

Search Fallback System

If neural search encounters issues, the system automatically falls back to text-based search:

{
  "meta": {
    "searchMethod": "fallback",
    "fallbackReason": "Neural search service temporarily unavailable",
    "queryProcessed": "federal reserve interest rates decision"
  }
}

Error Handling

Common Error Responses

Rate Limited

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED", 
    "message": "Too many requests. Please try again later.",
    "details": {
      "reset_time": "2025-01-24T15:35:00Z",
      "requests_remaining": 0
    }
  }
}

Invalid Parameters

{
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "Invalid value for 'days' parameter",
    "details": {
      "parameter": "days",
      "value": 45,
      "allowed_range": "1-30"
    }
  }
}

No Results Found

{
  "data": [],
  "meta": {
    "query": "very specific obscure topic",
    "totalResults": 0,
    "suggestion": "Try broadening your search terms or increasing the days parameter"
  }
}

Troubleshooting

No Results Returned

Problem: Empty results for your query Solutions:

  1. Increase the days parameter (try 14-30 days)
  2. Broaden your search terms
  3. Check if you’re using includeDomains too restrictively
  4. Verify the topic has recent news coverage

Irrelevant Results

Problem: Results don’t seem related to your market Solutions:

  1. Make your query more specific
  2. Use exact market question text
  3. Add context keywords to clarify meaning
  4. Use excludeDomains to filter out noise

Rate Limiting Issues

Problem: 429 errors or rate limiting Solutions:

  1. Implement exponential backoff (wait 1s, 2s, 4s, 8s…)
  2. Cache results to reduce API calls
  3. Consider getting an API key for higher limits
  4. Batch your requests efficiently

Performance & Optimization

Response Times

  • Typical Response: 0.5-2.0 seconds
  • Factors Affecting Speed: Query complexity, number of results, domain filtering
  • Optimization: Use smaller limit values for faster responses

Caching Recommendations

  • Cache Duration: 5-15 minutes for most use cases
  • Cache Key: Include all parameters in your cache key
  • Invalidation: Consider invalidating cache for breaking news topics

Best Practices

  1. Query Construction:

    • Use clear, specific language
    • Include key terms from your market
    • Avoid overly complex queries
  2. Parameter Tuning:

    • Start with default parameters
    • Adjust days based on topic frequency
    • Use limit based on your application needs
  3. Error Handling:

    • Always handle rate limiting gracefully
    • Implement retry logic with exponential backoff
    • Log errors for monitoring and debugging
  4. Integration:

    • Cache results appropriately
    • Consider parallel requests for multiple topics
    • Monitor your usage patterns

Need help? Contact our support team at lucas@adj.news with:

  • Your specific use case
  • Example queries that aren’t working as expected
  • Performance or integration questions

Authorizations

Authorization
string
header
required

Enter your API key as the bearer token

Path Parameters

market
string
required

The market query to search for news

Query Parameters

days
integer
default:7

Number of days to look back for news, deafult is a week

limit
integer
default:5

Maximum number of results to return, default is 5 results

excludeDomains
string

Comma-separated list of domains to exclude

Response

200
application/json

Successful response with news articles

The response is of type object.