Get a curated news feed

curl --request GET \
  --url https://api.andiai.com/api/v1/news/{topic} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.andiai.com/api/v1/news/{topic}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.andiai.com/api/v1/news/{topic}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.andiai.com/api/v1/news/{topic}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.andiai.com/api/v1/news/{topic}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "results_type": "<string>",
  "answer": "<string>",
  "type": "<string>",
  "title": "<string>",
  "results": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "metrics": {
    "query": "<string>",
    "intent": "<string>",
    "timestamp": "<string>",
    "duration": 123,
    "queries_executed": 123,
    "api_requests_count": 123,
    "results_returned": 123,
    "total_results_found": 123,
    "cached": true,
    "cache_age_seconds": 123,
    "cost_dollars": 123,
    "response_time_ms": 123
  },
  "correctedQuery": "<string>",
  "related_searches": [
    "<string>"
  ],
  "topics": [
    "<string>"
  ],
  "videos": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "images": [
    {
      "title": "<string>",
      "link": "<string>",
      "image": "<string>",
      "source": "<string>",
      "type": "image",
      "thumbnail": "<string>",
      "width": "<string>",
      "height": "<string>"
    }
  ],
  "news": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "places": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "profiles": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "social": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "academic": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "weather": {
    "location": {
      "name": "<string>",
      "country": "<string>",
      "coordinates": {
        "latitude": 123,
        "longitude": 123
      }
    },
    "temperature": 123,
    "description": "<string>",
    "feelsLike": 123,
    "humidity": 123,
    "windSpeed": 123,
    "windDirection": 123,
    "pressure": 123,
    "icon": "<string>",
    "cloudiness": 123,
    "visibility": 123,
    "timestamp": "<string>"
  },
  "calculation": {
    "expression": "<string>",
    "result": "<string>"
  }
}

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

{
  "error": "Insufficient Credits",
  "message": "Your account has insufficient credits. Please add credits to continue."
}

{
  "error": "Unknown topic",
  "message": "No curated news feed exists for topic 'crypto'.",
  "valid_topics": [
    "technology",
    "business",
    "finance",
    "politics",
    "sports",
    "health",
    "science",
    "world",
    "entertainment",
    "us",
    "europe",
    "uk",
    "asia",
    "middle-east",
    "africa",
    "latin-america",
    "australia",
    "programming",
    "startups",
    "top",
    "hn-frontpage",
    "ai-news",
    "tech-news"
  ]
}

{
  "error": "Too Many Requests",
  "message": "Rate limit of N requests per second exceeded"
}

{
  "error": "Service unavailable",
  "message": "The 'world' news feed is temporarily unavailable. Retry shortly."
}

GET

api

news

{topic}

Get a curated news feed

curl --request GET \
  --url https://api.andiai.com/api/v1/news/{topic} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.andiai.com/api/v1/news/{topic}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.andiai.com/api/v1/news/{topic}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.andiai.com/api/v1/news/{topic}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.andiai.com/api/v1/news/{topic}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "results_type": "<string>",
  "answer": "<string>",
  "type": "<string>",
  "title": "<string>",
  "results": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "metrics": {
    "query": "<string>",
    "intent": "<string>",
    "timestamp": "<string>",
    "duration": 123,
    "queries_executed": 123,
    "api_requests_count": 123,
    "results_returned": 123,
    "total_results_found": 123,
    "cached": true,
    "cache_age_seconds": 123,
    "cost_dollars": 123,
    "response_time_ms": 123
  },
  "correctedQuery": "<string>",
  "related_searches": [
    "<string>"
  ],
  "topics": [
    "<string>"
  ],
  "videos": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "images": [
    {
      "title": "<string>",
      "link": "<string>",
      "image": "<string>",
      "source": "<string>",
      "type": "image",
      "thumbnail": "<string>",
      "width": "<string>",
      "height": "<string>"
    }
  ],
  "news": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "places": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "profiles": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "social": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "academic": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extracts": [
        "<string>"
      ],
      "contentType": "<string>",
      "reader": {},
      "contentSafety": {
        "safeSearchApplied": true
      },
      "bang": "<string>"
    }
  ],
  "weather": {
    "location": {
      "name": "<string>",
      "country": "<string>",
      "coordinates": {
        "latitude": 123,
        "longitude": 123
      }
    },
    "temperature": 123,
    "description": "<string>",
    "feelsLike": 123,
    "humidity": 123,
    "windSpeed": 123,
    "windDirection": 123,
    "pressure": 123,
    "icon": "<string>",
    "cloudiness": 123,
    "visibility": 123,
    "timestamp": "<string>"
  },
  "calculation": {
    "expression": "<string>",
    "result": "<string>"
  }
}

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

{
  "error": "Insufficient Credits",
  "message": "Your account has insufficient credits. Please add credits to continue."
}

{
  "error": "Unknown topic",
  "message": "No curated news feed exists for topic 'crypto'.",
  "valid_topics": [
    "technology",
    "business",
    "finance",
    "politics",
    "sports",
    "health",
    "science",
    "world",
    "entertainment",
    "us",
    "europe",
    "uk",
    "asia",
    "middle-east",
    "africa",
    "latin-america",
    "australia",
    "programming",
    "startups",
    "top",
    "hn-frontpage",
    "ai-news",
    "tech-news"
  ]
}

{
  "error": "Too Many Requests",
  "message": "Rate limit of N requests per second exceeded"
}

{
  "error": "Service unavailable",
  "message": "The 'world' news feed is temporarily unavailable. Retry shortly."
}

Authorizations

x-api-key

string

header

required

API key from the API Console.

Path Parameters

topic

enum<string>

required

Topic slug selecting the feed.

Available options:

technology,

business,

finance,

politics,

sports,

health,

science,

world,

entertainment,

us,

europe,

uk,

asia,

middle-east,

africa,

latin-america,

australia,

programming,

startups,

top,

hn-frontpage,

ai-news,

tech-news

Query Parameters

limit

integer

default:20

Number of results to return.

Required range: 1 <= x <= 50

noCache

boolean

default:false

Bypass the cache and fetch a fresh feed.

Response

Curated news feed

results_type

string

required

The type of results returned (e.g., Search, News, Weather, Calculator). Determines which optional response sections are present.

answer

string

required

A generated answer for the query. May be an empty string when no direct answer is available.

type

string

required

Same as results_type. Indicates the category of results.

title

string

required

A title summarizing the search results.

results

object[]

required

Array of search results.

Show child attributes

metrics

object

required

Search performance metrics. Always included in the response.

Show child attributes

correctedQuery

string

Spell-corrected query. Present when a misspelling in the original query is detected and corrected — any mode can return it; deep and exhaustive modes run the strongest spell correction.

Related search suggestions. Present on some queries.

topics

string[]

Related topics. Present on some queries.

videos

object[]

Video results. Present when the query triggers a video intent.

Show child attributes

images

object[]

Image results. Present when the query triggers an image intent.

Show child attributes

news

object[]

News results. Present when the query triggers a news intent.

Show child attributes

places

object[]

Place/business results. Present for location-related queries.

Show child attributes

profiles

object[]

Profile results. Present for people-related queries.

Show child attributes

Social media results. Present for social-related queries.

Show child attributes

academic

object[]

Academic results. Present for scholarly queries.

Show child attributes

weather

object

Weather data. Present when the query triggers a weather intent.

Show child attributes

calculation

object

Calculation result. Present when the query triggers a calculation intent.

Show child attributes

Overview

Endpoints

Get a curated news feed

Authorizations

Path Parameters

Query Parameters

Response