---
title: "CoinGecko news cards"
method: GET
path: "/coingecko/news"
tags: ["CoinGecko"]
---

# CoinGecko news cards

`GET /coingecko/news`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/coingecko/news`
- Auth: API key in header `x-api-key`

Returns recent crypto news cards from CoinGecko, up to `limit` articles (default 20, max 50). Each article has its title, URL, image URL, summary, publisher and `published_text`, plus the coins it mentions with their id, name, symbol, URL and `change_percent` when present.

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CoingeckoNewsResponseDoc
  - `code` integer
  - `data` CoingeckoNewsResponse
    - `articles` CoingeckoNewsArticle[]: News articles listed on CoinGecko.
      - `coins` CoingeckoNewsCoin[]: Coins the article is tagged with.
        - `change_percent` number: Price change shown for the coin next to the article, in percent.
        - `id` string: CoinGecko coin id.
        - `name` string: Name of the coin.
        - `symbol` string: Ticker symbol of the coin.
        - `url` string: Link to the coin page on CoinGecko.
      - `image_url` string: URL of the article image.
      - `published_text` string: When the article was published, as CoinGecko words it, for example `2 hours ago`.
      - `publisher` string: Name of the outlet that published the article.
      - `summary` string: Short summary of the article.
      - `title` string: Headline of the article.
      - `url` string: Link to the article.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of articles returned.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)