Docs menu
CoinGecko API endpoint
CoinGecko News API
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.
GETapiKey2 credits/requestCoinGeckocoingecko.newsResponseDoc
CoinGecko/coingecko/newsEndpoint facts
- Method
- GET
- API path
- /coingecko/news
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- CoinGecko
- Response schema
- #/definitions/coingecko.newsResponseDoc
How this endpoint behaves
Returns news cards from CoinGecko's news page.
Path parameters: none.
Query parameters:
limit: optional article limit. Default20, maximum50.
Notable response behavior:
- Article cards include title, URL, image URL, summary, publisher, published text, and associated coin chips when present.
- Empty card lists without a clear empty-state marker return upstream errors.
Live monitoring
- Monitored request
- GET /coingecko/news?limit=3
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 1.30 s
Sampled response
- Request, 14 Oct 2026
- GET /coingecko/news?limit=20
- Items in articles
- 18
- Fields filled in every checked item
- 4
- Fields empty in some or all items
- 1
| Field | Filled in, of 18 checked | Values in the sample |
|---|---|---|
| title | 18 | median 69 characters |
| url | 18 | news.bitcoin.com and 12 other hosts |
| image_url | 18 | “https://assets.coingecko.com/articles/images/108565859/larg…” and 17 other values |
| published_text | 18 | median 265 characters |
| coins | 14 | median 1 entry |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| limit | integer | No | Rows to return, default 20, max 50 | ||
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/coingecko/news?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"limit": 20,
"source_url": "https://www.coingecko.com/en/news",
"fetched_at": "2026-05-24T00:00:00Z",
"articles": [
{
"title": "Bitcoin rallies as markets recover",
"url": "https://publisher.example/story",
"image_url": "https://assets.example/news.png",
"summary": "A short news summary.",
"publisher": "CoinDesk",
"published_text": "2 hours ago",
"coins": [
{
"id": "bitcoin",
"symbol": "BTC",
"name": "Bitcoin",
"url": "https://www.coingecko.com/en/coins/bitcoin",
"change_percent": 1.2
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.NewsResponse | No | ||||
| data.articles | array | No | News articles listed on CoinGecko. | |||
| data.articles[].coins | array | No | Coins the article is tagged with. | |||
| data.articles[].coins[].change_percent | number | No | 1.2 | Price change shown for the coin next to the article, in percent. | ||
| data.articles[].coins[].id | string | No | bitcoin | CoinGecko coin id. | ||
| data.articles[].coins[].name | string | No | Bitcoin | Name of the coin. | ||
| data.articles[].coins[].symbol | string | No | BTC | Ticker symbol of the coin. | ||
| data.articles[].coins[].url | string | No | https://www.coingecko.com/en/coins/bitcoin | Link to the coin page on CoinGecko. | ||
| data.articles[].image_url | string | No | https://assets.coingecko.com/news/image.jpg | URL of the article image. | ||
| data.articles[].published_text | string | No | 2 hours ago | When the article was published, as CoinGecko words it, for example `2 hours ago`. | ||
| data.articles[].publisher | string | No | CoinDesk | Name of the outlet that published the article. | ||
| data.articles[].summary | string | No | A brief summary of the article. | Short summary of the article. | ||
| data.articles[].title | string | No | Bitcoin rises as crypto markets recover | Headline of the article. | ||
| data.articles[].url | string | No | https://example.com/news/story | Link to the article. | ||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.limit | integer | No | 20 | Maximum number of articles returned. | ||
| data.source_url | string | No | https://www.coingecko.com/en/news | URL the data was read from. | ||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/coingecko/news?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"