Skills/Knowledge & Facts/Search articles

Search articles

0.1 credits / search

Searches the encyclopedia full-text for articles matching a query and returns a ranked list of titles with short excerpts. Supports pagination to browse deeper into results when the first page does not contain the right entry.

Use when

You want to discover which articles exist on a topic, or browse related ones.

Not for

A single overview of one known topic (use the summarize operation).

Cost

0.1 credits / search

What it accepts

Set these inside the intent when you run it.

topicrequired

The search query to find matching articles.

limitoptional

How many results to return, up to 50. Defaults to 10.

What you get back

A list of matching article titles with short text excerpts and source links, plus a pagination offset for the next page.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Knowledge & Facts skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/knowledge/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"search_articles","topic":"climate change effects on coral reefs","limit":"5"}}'

Example requests

  • Find articles about the Byzantine Empire
  • What articles exist on renewable energy?
  • Search for pages related to Olympic Games history