tapline

Use tapline to collect live data from YouTube, Airbnb, GMGN, and GeckoTerminal in Python.

What you can do

One API key and credit balance work across all four services.

Get started

Create a Tapline account and create an API key on the API keys page.

Install the package and save your key in TAPLINE_API_KEY:

pip install tapline
export TAPLINE_API_KEY="your-api-key"

Pass a key from your environment or secret manager as api_key= when you create either the blocking or async client:

import os

from tapline import SyncTaplineClient, TaplineClient

api_key = os.environ["TAPLINE_API_KEY"]
sync_tapline = SyncTaplineClient(api_key=api_key)
async_tapline = TaplineClient(api_key=api_key)

If you omit api_key, both clients read TAPLINE_API_KEY. Python 3.10 or newer is required.

Get a transcript

import os

from tapline import SyncTaplineClient

with SyncTaplineClient(api_key=os.environ["TAPLINE_API_KEY"]) as tapline:
    subtitles = tapline.youtube.subtitles(
        "https://www.youtube.com/watch?v=jNQXAC9IVRw",
        language="en",
        subtitle_format="txt",
    )

print(subtitles.transcript)

See the YouTube guide for search, metadata, channels, playlists, comments, formats, and replay heatmaps.

Search Airbnb listings

from tapline import SyncTaplineClient

with SyncTaplineClient() as tapline:
    places = tapline.airbnb.search_locations(query="London")
    place_id = places.suggestions[0].place_id
    if place_id is None:
        raise RuntimeError("Airbnb returned a location without a place_id")
    results = tapline.airbnb.search(
        place_id=place_id,
        adults=2,
    )

for listing in results.listings:
    print(listing.room_id, listing.name)

Listing IDs can stop resolving when a host removes a property. See the Airbnb guide for prices, availability, details, reviews, and search filters.

Search GMGN token data

from tapline import SyncTaplineClient

with SyncTaplineClient() as tapline:
    results = tapline.gmgn.search("sol", q="bonk")

for token in results.data.coins[:5]:
    print(token.symbol, token.address)

See the GMGN guide for discovery, rankings, security, candles, holders, traders, liquidity, and wallet analytics.

Discover GeckoTerminal pools

from tapline import SyncTaplineClient

with SyncTaplineClient() as tapline:
    pools = tapline.geckoterminal.network_latest_pools("solana")

for pool in pools.data[:5]:
    print(pool.attributes.address, pool.attributes.name)

See the GeckoTerminal guide for pool, token, trend, and developer history data.

Go beyond the free tier

Your free account starts with 500 credits and can use every live endpoint. When you need more credits or higher rate limits, choose a paid plan under Billing. Your API key and code stay the same.

Async client

Every service method has the same name and arguments on TaplineClient; only the call becomes awaitable.

import asyncio

from tapline import TaplineClient


async def main() -> None:
    async with TaplineClient() as tapline:
        metadata = await tapline.youtube.metadata("dQw4w9WgXcQ")
        print(metadata.title)


asyncio.run(main())

Handle errors

Failed requests raise an APIStatusError. Use its status, error code, and request ID to decide what to do or to contact support.

from tapline import APIStatusError, SyncTaplineClient

try:
    with SyncTaplineClient() as tapline:
        tapline.youtube.metadata("not-a-video")
except APIStatusError as error:
    print(error.status_code, error.code, error.request_id)

Authentication, credit, rate-limit, timeout, and connection failures also have their own exception classes. The client retries temporary network and server failures.

Full API reference

Use the Tapline API reference to check inputs, response fields, and the credit cost of each call.

• YouTube
• Airbnb
• GMGN
• GeckoTerminal

License

MIT