API – TrendsAPI.io

API Dokumentace

Jednoduché API, silná data

Integrujte Google Trends data do vašich nástrojů během několika minut.

GET


          https://trendsapi.io/api/v1/trending

Parametr	Typ	Povinný	Popis
`api_key`	string	Ano	Váš API klíč (alternativně použijte Authorization: Bearer)
`geo`	string	Ne	Země / region (např. CZ, SK, US, DE) - výchozí CZ
`hours`	integer	Ne	Časový rozsah v hodinách (4, 24, 48, 168) - výchozí 24
`category`	string	Ne	Filtr podle kategorie (Sport, Finance, Entertainment…)
`sort`	string	Ne	Řazení: search-volume, recency, relevance
`format`	string	Ne	Formát výstupu (json, xml) - výchozí json
`limit`	integer	Ne	Počet výsledků (výchozí 25, max 100)

cURL příklad

curl -X GET "https://trendsapi.io/api/v1/trending?geo=CZ&hours=24&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

              
              
              
            
response.json

          {
  "status": "success",
  "data": {
    "geo": "CZ",
    "hours": 24,
    "trending_searches": [
      {
        "query": "olympijské hry",
        "start_timestamp": 1770628800,
        "active": true,
        "search_volume": 20000,
        "increase_percentage": 300,
        "categories": [
          {"id": 17, "name": "Sports"}
        ]
      },
      {
        "query": "bitcoin",
        "start_timestamp": 1770623400,
        "active": true,
        "search_volume": 10000,
        "increase_percentage": 200,
        "categories": [
          {"id": 3, "name": "Business and Finance"}
        ]
      }
    ],
    "total_results": 10,
    "generated_at": "2026-02-09T12:00:00+01:00"
  }
}
        

Statistiky API volání

Získejte informace o svém API klíči, plánu a využití měsíčního limitu.

GET


          https://trendsapi.ioGET /api/v1/stats

                
cURL příklad

            curl -X GET "https://trendsapi.io/api/v1/stats" \
  -H "Authorization: Bearer YOUR_API_KEY"

              
              
              
            
response.json

          {
  "status": "success",
  "api_key": "0f2068aa...",
  "plan": "monthly",
  "subscription_expires_at": "2026-03-09 12:00:00",
  "monthly_limit": 5000,
  "monthly_used": 234,
  "monthly_remaining": 4766,
  "total_calls_all_time": 1523
}
        

Autentizace

API podporuje dva způsoby autentizace:

Bearer Token (doporučeno)

Authorization: Bearer YOUR_API_KEY

Query parametr

?api_key=YOUR_API_KEY

Limity & Chybové kódy

Kód	Popis
`200`	Úspěšný požadavek
`401`	Chybí nebo neplatný API klíč
`403`	Vypršelo předplatné
`429`	Překročen měsíční limit volání
`500`	Interní chyba serveru

Měsíční plán: 100 volání/měsíc
Roční plán: 200 volání/měsíc
Limit se resetuje automaticky každý měsíc od data aktivace předplatného.