Get News for Markets - Adjacent News API

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

Query Understanding: Your market query is processed through advanced language models to understand the semantic meaning and context
Exa Neural Search: We use Exa’s state-of-the-art neural search engine to find articles that are conceptually related to your query
Content Filtering: Automatically filters out prediction market platforms to avoid circular references and self-referential content
Relevance Ranking: Results are ranked by semantic similarity and potential market impact
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

Field	Description	Notes
`title`	Article headline	Original title from the news source
`url`	Direct link to article	Always accessible, not behind paywalls when possible
`publishedDate`	Publication timestamp	ISO 8601 format with timezone
`author`	Article author	May be null for some sources
`domain`	Source domain	Useful for filtering and credibility assessment
`snippet`	Article excerpt	100-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"

Focused Source Search

# 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

Be Specific: “Federal Reserve interest rate decision” vs “Fed rates”
Use Market Language: Include terms commonly used in your target market
Consider Synonyms: The neural search will find related terms, but specific keywords help
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:

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

Irrelevant Results

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

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

Rate Limiting Issues

Problem: 429 errors or rate limiting Solutions:

Implement exponential backoff (wait 1s, 2s, 4s, 8s…)
Cache results to reduce API calls
Consider getting an API key for higher limits
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

Query Construction:
- Use clear, specific language
- Include key terms from your market
- Avoid overly complex queries
Parameter Tuning:
- Start with default parameters
- Adjust days based on topic frequency
- Use limit based on your application needs
Error Handling:
- Always handle rate limiting gracefully
- Implement retry logic with exponential backoff
- Log errors for monitoring and debugging
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.

Markets API

Search API

News API

Trade API

Indices API

​News Discovery for Prediction Markets

​How Neural Search Works

​🧠 Neural Search Process

​🎯 Why This Matters

​API Reference

​Path Parameters

​Query Parameters

​Response Format

​Successful Response

​Response Fields Explained

​Default Domain Exclusions

​Excluded Platforms

​Customizing Exclusions

​Comprehensive Examples

​Basic News Retrieval

​Advanced Filtering

​Focused Source Search

​Market-Specific News

​Use Cases & Applications

​1. Market Research & Analysis

​2. Event Monitoring

​3. Sentiment Analysis Pipeline

​4. Content Aggregation

​5. Research & Journalism

​Advanced Features

​Query Optimization Tips

​Search Fallback System

​Error Handling

​Common Error Responses

​Rate Limited

​Invalid Parameters

​No Results Found

​Troubleshooting

​No Results Returned

​Irrelevant Results

​Rate Limiting Issues

​Performance & Optimization

​Response Times

​Caching Recommendations

​Best Practices

Authorizations

Path Parameters

Query Parameters

Response

News Discovery for Prediction Markets

How Neural Search Works

🧠 Neural Search Process

🎯 Why This Matters

API Reference

Path Parameters

Query Parameters

Response Format

Successful Response

Response Fields Explained

Default Domain Exclusions

Excluded Platforms

Customizing Exclusions

Comprehensive Examples

Basic News Retrieval

Advanced Filtering

Focused Source Search

Market-Specific News

Use Cases & Applications

1. Market Research & Analysis

2. Event Monitoring

3. Sentiment Analysis Pipeline

4. Content Aggregation

5. Research & Journalism

Advanced Features

Query Optimization Tips

Search Fallback System

Error Handling

Common Error Responses

Rate Limited

Invalid Parameters

No Results Found

Troubleshooting

No Results Returned

Irrelevant Results

Rate Limiting Issues

Performance & Optimization

Response Times

Caching Recommendations

Best Practices