Guides
Quickstart
Make your first search request and print fields you can use immediately.
This guide makes one request to content search and prints fields you can render in a product: title, source, publication date, URL, and key points.
1. Search
const response = await fetch("https://api.omnist.ai/v1/content/search", {
method: "POST",
headers: {
"content-type": "application/json",
"x-api-key": "om_sk_...",
},
body: JSON.stringify({
query: "semiconductor export controls",
media_types: ["news", "wire", "podcast"],
limit: 5,
}),
});
const data = await response.json();
console.log(data.results.map((result) => ({
score: result.score,
id: result.content_item.id,
title: result.content_item.title,
source: result.content_item.source?.name,
published_date: result.content_item.published_date,
url: result.content_item.canonical_url,
key_points: result.content_item.key_points,
})));import requests
response = requests.post(
"https://api.omnist.ai/v1/content/search",
headers={
"content-type": "application/json",
"x-api-key": "om_sk_...",
},
json={
"query": "semiconductor export controls",
"media_types": ["news", "wire", "podcast"],
"limit": 5,
},
)
data = response.json()
print([
{
"score": result["score"],
"id": result["content_item"]["id"],
"title": result["content_item"].get("title"),
"source": (result["content_item"].get("source") or {}).get("name"),
"published_date": result["content_item"].get("published_date"),
"url": result["content_item"].get("canonical_url"),
"key_points": result["content_item"].get("key_points"),
}
for result in data["results"]
])2. Read the response
Each result includes a score and a content_item. Use the score for ordering or display hints; use the content item for rendering.
{
"score": 0.92,
"content_item": {
"id": "content_...",
"media_type": "news",
"published_date": "2026-05-07T14:03:00Z",
"title": "Example article title",
"canonical_url": "https://example.com/article",
"source": {
"name": "Example News",
"domain": "example.com"
},
"key_points": [
"The article's first important point.",
"Another concise point extracted from the content."
],
"linked_entities": [
{
"entity_id": "ent_...",
"name": "Example Company",
"type": "company"
}
],
"article_id": "article_...",
"language": "en",
"image": "https://example.com/image.jpg"
}
}