Get News for Markets
Retrieve news articles related to a specific market
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
- 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
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
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
Maximum number of results to return.
- Range: 1-50 articles
- Default: 10 articles
- Note: Larger limits may increase response time
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)
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
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 marketsmetaculus.com
- Metaculus forecasting platformmanifold.markets
- Manifold Marketspolymarket.com
- Polymarketpredictit.org
- PredictItbetfair.com
- Betfair prediction markets
Customizing Exclusions
You can override or extend these exclusions:
Comprehensive Examples
Basic News Retrieval
Advanced Filtering
Focused Source Search
Market-Specific News
Use Cases & Applications
1. Market Research & Analysis
Use for: Understanding the underlying factors that might affect market outcomes
2. Event Monitoring
Use for: Tracking events in real-time that could trigger market resolutions
3. Sentiment Analysis Pipeline
Use for: Building datasets for sentiment analysis and market prediction models
4. Content Aggregation
Use for: Building news dashboards and content aggregation services
5. Research & Journalism
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:
Error Handling
Common Error Responses
Rate Limited
Invalid Parameters
No Results Found
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
Enter your API key as the bearer token
Path Parameters
The market query to search for news
Query Parameters
Number of days to look back for news, deafult is a week
Maximum number of results to return, default is 5 results
Comma-separated list of domains to exclude
Response
Successful response with news articles
The response is of type object
.