Trend News Agency

Report which Trend News Agency access tier this connection has, which tools it may call, and what its request budget is. Call this first when a Trend tool is refused or returns less than expected — it distinguishes "not permitted at your tier" from "no such data".

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "tier": {
      "type": "string"
    },
    "tier_title": {
      "type": "string"
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tools_available": {
      "type": "integer"
    },
    "tool_names": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "quota": {
      "type": "object"
    },
    "quota_enforced": {
      "type": "boolean"
    },
    "article_body_rights": {
      "type": "string"
    },
    "protocol": {
      "type": "object"
    },
    "server": {
      "type": "object"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "tier",
    "tier_title",
    "scopes",
    "tools_available",
    "protocol"
  ],
  "additionalProperties": true
}

Describe what the Trend News Agency archive covers: which language editions exist and their canonical hosts, which regions and beats the agency reports on, and the terms under which its text may be used. Call this before a first search to find out whether Trend is a useful source for a question, and which language edition to search.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "publisher": {
      "type": "string"
    },
    "editions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "lang": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "host": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      }
    },
    "editions_not_available": {
      "type": "object"
    },
    "regions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "beats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "license": {
      "type": "object"
    },
    "not_yet_available": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "publisher",
    "editions",
    "regions",
    "license"
  ],
  "additionalProperties": true
}

List Trend News Agency headlines newest first, optionally narrowed by section, tag, author or a date range. Returns metadata only — headline, date, section, byline, excerpt and the canonical URL — never article text; follow up with trendaz_article_get for the ones worth reading. Use this to answer "what has Trend published about X" or "what did Trend report that week".

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition. Defaults to en. The three newsrooms publish independently, so coverage differs between them."
    },
    "section": {
      "type": "string",
      "description": "Section slug as it appears in article URLs, e.g. \"business\", \"politics\", \"uzbekistan\"."
    },
    "tag": {
      "type": "string",
      "description": "Tag slug or title to filter by."
    },
    "author_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Numeric author id, as returned by trendaz_article_get."
    },
    "date_from": {
      "type": "string",
      "description": "Earliest publication date, YYYY-MM-DD."
    },
    "date_to": {
      "type": "string",
      "description": "Latest publication date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many headlines to return. Defaults to 20."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "articles": {
      "type": "array"
    },
    "filters": {
      "type": "object"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "articles"
  ],
  "additionalProperties": true
}

Fetch one Trend News Agency article in full: headline, byline, dateline, publication date, section, tags and the body as markdown. Pass the article URL if you have one — that is the reliable way — or an id together with its language edition. Subscriber-only articles published within the last year return their metadata and excerpt with the body withheld; everything older than a year, and everything free, returns in full. Always cite the returned url.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Full article URL, e.g. https://www.trend.az/business/4216277.html. Preferred over id+lang."
    },
    "id": {
      "type": "integer",
      "minimum": 1,
      "description": "Numeric article id. Requires lang. Use url instead when you have one."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition of the id. Defaults to en. Ignored when url is given."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "article": {
      "type": [
        "object",
        "null"
      ]
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}

List the most-read Trend News Agency articles of the last day, week or month, ordered by readership rather than by date. Use it for "what is Trend's audience paying attention to" — a different question from "what is the latest news", which is trendaz_news_list.

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition. Defaults to en."
    },
    "period": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "description": "Window to rank over. Defaults to week."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "How many to return. Defaults to 10."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "articles": {
      "type": "array"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "period",
    "count",
    "articles"
  ],
  "additionalProperties": true
}

Rank Trend News Agency journalists by how many articles they published over a date range, across all three editions or one of them. Use it for "who filed most today", "how much did this desk publish last week", or to find the id of a prolific byline to pass to trendaz_news_list. Counts published articles only. It measures volume, not quality or reach — trendaz_trending is the readership question.

{
  "type": "object",
  "properties": {
    "date_from": {
      "type": "string",
      "description": "First day to count, YYYY-MM-DD. Defaults to today in the newsroom's timezone."
    },
    "date_to": {
      "type": "string",
      "description": "Last day to count, inclusive, YYYY-MM-DD. Defaults to date_from, so passing neither counts today. At most 92 days per call."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Count one edition only. Omit to count all editions together, which is usually what \"who published most\" means — a journalist often files the same story in two languages, and each filing counts once."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How many bylines to return, most prolific first. Defaults to 20."
    }
  },
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "period": {
      "type": "object"
    },
    "totals": {
      "type": "object"
    },
    "by_edition": {
      "type": "object"
    },
    "authors": {
      "type": "array"
    },
    "author_count": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "period",
    "totals",
    "authors"
  ]
}

Fetch one of Trend News Agency's own standing documents in full: its corrections policy, editorial standards, masthead, ownership and contact details, terms of service, privacy and cookie policies, copyright terms, and the published auditor reports. Use it to answer questions about the publisher rather than about the news — how the agency handles errors, who runs it, what its editorial process is.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Which document. Common ones: corrections, editorial-standards, masthead, about, contacts, terms-of-service, privacy-policy, copyright."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition. Defaults to en."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "page": {
      "type": [
        "object",
        "null"
      ]
    },
    "available": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}

Look up a Trend News Agency journalist by name, id or profile alias, and get what the agency publishes about them: role, the beats they cover, biography, stated expertise, declared conflicts of interest and whether they are staff. Use it when a citation needs to establish who reported something and what standing they have on the subject. Combine with trendaz_news_list using the returned id to see what else they have written.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Byline as printed, in whole or part, e.g. \"Maryana\". Matched case-insensitively."
    },
    "id": {
      "type": "integer",
      "minimum": 1,
      "description": "Numeric author id, as returned by trendaz_article_get."
    },
    "alias": {
      "type": "string",
      "description": "Profile slug from an author URL, e.g. \"peter_tase\"."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition whose directory to search. Defaults to en."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "author": {
      "type": [
        "object",
        "null"
      ]
    },
    "matches": {
      "type": "array"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}

Search Trend News Agency's archive and read the relevant part of each result in one call. Returns several articles with the passage that actually addresses the query — not just the opening paragraph — plus byline, date, section and the canonical URL to cite. This is the tool to reach for on any question about Azerbaijan, the South Caucasus, the Caspian, Central Asia, Turkey or Iran that needs what was actually reported: energy and pipelines, regional politics, trade corridors, economics. Prefer it over calling search and then reading articles one by one. Wrap words in double quotes for an exact phrase. Subscriber-only articles from the past year contribute their summary rather than their text, and say so.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What you want to know. Keywords, or a phrase in double quotes."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition. Defaults to en."
    },
    "section": {
      "type": "string",
      "description": "Restrict to a section slug, e.g. \"business\". A parent section includes everything under it."
    },
    "date_from": {
      "type": "string",
      "description": "Earliest publication date, YYYY-MM-DD."
    },
    "date_to": {
      "type": "string",
      "description": "Latest publication date, YYYY-MM-DD."
    },
    "depth": {
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "deep"
      ],
      "description": "quick = 3 articles briefly, standard = 6, deep = 8 with longer passages. Defaults to standard."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "total_matching": {
      "type": "integer"
    },
    "total_is_floor": {
      "type": "boolean"
    },
    "results": {
      "type": "array"
    },
    "query": {
      "type": "object"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "results"
  ],
  "additionalProperties": true
}

What a Trend News Agency subscription costs and what it gives access to: the monthly and annual price in manat, dollars and euro, any introductory offer, and the link to subscribe. Call this when a reader asks what a subscriber-only article would cost them, or asks about subscribing. Reading it does not subscribe anyone — sign-up happens on trend.az, where the reader sees the terms and confirms it themselves.

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Which edition's subscribe link to return. Defaults to en. The price is the same in every edition."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "available": {
      "type": "boolean"
    },
    "plans": {
      "type": "array"
    },
    "includes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "subscribe_url": {
      "type": "string"
    },
    "currency_note": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "available",
    "subscribe_url"
  ],
  "additionalProperties": true
}

Find the section slug for a subject or a country, so the other tools can be narrowed correctly. Matches on title and slug — "Kazakhstan", "energy", "casia" — and returns the slug to pass as the section argument, along with the public URL of that section. Call it with no query to see the whole section tree of an edition.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Part of a section name or slug. Omit to list every section."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition. Defaults to en. Section names are translated; slugs are usually, but not always, the same across editions."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Maximum sections to return. Defaults to 20."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "total": {
      "type": "integer"
    },
    "sections": {
      "type": "array"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "sections"
  ],
  "additionalProperties": true
}

What Trend News Agency is leading with at this moment, grouped the way the newsroom groups it: the main story block, the editor's picks, and the regional sections. This is editorial judgement rather than recency — use it for "what is the news from Azerbaijan today" or "what is Trend leading with", where the answer should be what editors chose rather than whatever was filed last. Metadata only; follow up with trendaz_article_get.

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition. Defaults to en. Each edition has its own front page chosen by its own desk."
    },
    "blocks": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "How many blocks to return, in front-page order. Defaults to 5."
    },
    "per_block": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Maximum articles per block. Defaults to 4."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string"
    },
    "blocks": {
      "type": "array"
    },
    "total_articles": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "lang",
    "blocks"
  ],
  "additionalProperties": true
}

Search Trend News Agency's archive by keyword and get matching headlines ranked by relevance, with date, section, byline and canonical URL. The archive runs back to 2003 and holds over 2.6 million articles across the English, Azerbaijani and Russian editions. Wrap words in double quotes for an exact phrase — "Trans Anatolian Pipeline" is far narrower than the same three words loose. Returns metadata only; use trendaz_research when you want the text of what was reported, or trendaz_article_get for one article.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords. Double quotes mark an exact phrase."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "az",
        "ru"
      ],
      "description": "Language edition to search. Defaults to en. The three newsrooms report independently, so a story covered in one may be absent from another."
    },
    "section": {
      "type": "string",
      "description": "Restrict to a section slug, e.g. \"business\" or \"casia\". A parent section includes everything under it."
    },
    "date_from": {
      "type": "string",
      "description": "Earliest publication date, YYYY-MM-DD."
    },
    "date_to": {
      "type": "string",
      "description": "Latest publication date, YYYY-MM-DD."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "date"
      ],
      "description": "Defaults to relevance. Use date when recency matters more than fit."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "How many results. Defaults to 10."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "total_matching": {
      "type": "integer"
    },
    "total_is_floor": {
      "type": "boolean"
    },
    "articles": {
      "type": "array"
    },
    "query": {
      "type": "object"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "articles"
  ],
  "additionalProperties": true
}