Website traffic-rank API

Top website / web traffic leaderboard via the Trends API live feeds. Competitive intel as JSON.

Key: trendsapi.ai/#get-key. HTTP contract: trendsapi-ai/trendsapi.

JS: web-traffic-api.

Authentication

pip install web-traffic-api
export TRENDSAPI_KEY=your_key

Python 3.9+. The wrapper re-exports TrendsAPI, AsyncTrendsAPI, and TrendsAPIError from the official client.

from web_traffic_api import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

get_top_websites() presets type: "Top Websites". Official full client (every source, no preset): trendsapi.

Methods

source is lowercase (google search). type is exact (Top Websites). Mixing them is a 400.

from web_traffic_api import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

sites = client.get_top_websites(limit=25)
print(sites.data[0])                    # [1, "google.com"]

sites = client.get_top_websites(limit=25)

Python: hot.data. JS: hot.data. Optional offset= and category= (Amazon Best Sellers by Category, Top Websites only).

Async

import asyncio
from web_traffic_api import AsyncTrendsAPI

async def main():
    client = AsyncTrendsAPI()
    return await client.get_top_websites(limit=25)

asyncio.run(main())

Each 200 is one billed request.

Call (curl)

curl -sS -X POST https://api.trendsapi.ai/api \
  -H "Authorization: Bearer $TRENDSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_top_trends","type":"Top Websites","limit":25}'

Source notes

• There is no source: web traffic (that string is 400).
• Parsed data is [rank, hostname] pairs.
• This is third-party rank estimation, not Google Analytics.

Errors

The HTTP body field is a JSON string. SDKs decode it. Raw curl must parse body a second time.

Site: https://trendsapi.ai/trends/web-traffic. GitHub: trendsapi-ai/web-traffic-api.

License

MIT. See LICENSE.