Skip to main content
Track news articles, public activity, and market intelligence for your leads.

​
News Monitoring

AdaptEngine monitors news related to your leads and surfaces relevant articles.

​
News Article Structure

interface NewsArticle {
  id: string;
  leadId: string;
  title: string;
  url: string;
  source: string;
  publishedAt: number;
  summary: string | null;
  keywords: string[];
  isFollowed: boolean;
  discoveredAt: number;
}

​
Fetching News

Get news for a lead: 
curl "https://api.adaptengine.com/api/v1/leads/{leadId}/news" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Search Terms

Customize news discovery with search terms: 
# List search terms
curl "https://api.adaptengine.com/api/v1/leads/{leadId}/search-terms" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Add search term
curl -X POST "https://api.adaptengine.com/api/v1/leads/{leadId}/search-terms" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "term": "Acme Construction expansion"
  }'

# Remove search term
curl -X DELETE "https://api.adaptengine.com/api/v1/leads/{leadId}/search-terms/{termId}" \
  -H "Authorization: Bearer YOUR_TOKEN"
Search for public activity and mentions using AI: 
curl -X POST "https://api.adaptengine.com/api/v1/leads/{leadId}/public-activity/search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "recent permits filed"
  }'
Response: 
{
  "ok": true,
  "data": {
    "results": [
      {
        "title": "Building Permit Application",
        "content": "Acme Construction filed permits for...",
        "source": "City Planning Database",
        "url": "https://...",
        "relevance": 92
      }
    ],
    "citations": ["https://..."],
    "searchedAt": 1706623200000
  }
}

​
Search History

View past searches: 
curl "https://api.adaptengine.com/api/v1/leads/{leadId}/public-activity/history" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Following Articles

Follow important articles for tracking: 
# Follow an article
curl -X POST "https://api.adaptengine.com/api/v1/leads/{leadId}/news/{articleId}/follow" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Unfollow
curl -X DELETE "https://api.adaptengine.com/api/v1/leads/{leadId}/news/{articleId}/follow" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Get followed articles
curl "https://api.adaptengine.com/api/v1/leads/{leadId}/news/following" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
News Tabs

The news section provides three views:
All discovered news articles for the lead, sorted by relevance and recency.

​
Newness Indicators

Articles are marked with badges:
BadgeMeaning
newDiscovered since your last view
updatedContent has changed
Mark all as seen: 
curl -X POST "https://api.adaptengine.com/api/v1/leads/{leadId}/news/mark-seen" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
API Endpoints

MethodEndpointDescription
GET/api/v1/leads/{leadId}/newsList news
GET/api/v1/leads/{leadId}/search-termsList search terms
POST/api/v1/leads/{leadId}/search-termsAdd search term
DELETE/api/v1/leads/{leadId}/search-terms/{id}Remove term
POST/api/v1/leads/{leadId}/public-activity/searchSearch activity
GET/api/v1/leads/{leadId}/public-activity/historySearch history
POST/api/v1/leads/{leadId}/news/{id}/followFollow article
DELETE/api/v1/leads/{leadId}/news/{id}/followUnfollow