Skip to main content

Quickstart

Get your first Instagram data in under a minute.

1. Set your key​

export LISTENX_KEY="lx_live_xxxxxxxxxxxxxxxxxxxx"
export LISTENX_BASE="https://listenx.tagxdata.com"

2. Fetch a post​

curl "$LISTENX_BASE/v1/instagram/post/DcghxSFtjRB" \
  -H "X-API-Key: $LISTENX_KEY"
curl -G "$LISTENX_BASE/v1/instagram/search" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'query=dentist teeth whitening' \
  --data-urlencode 'max_pages=3'

Python​

import requests

BASE = "https://listenx.tagxdata.com"
KEY = "lx_live_xxxxxxxxxxxxxxxxxxxx"
headers = {"X-API-Key": KEY}

# Fetch a post with all engagement metrics
post = requests.get(f"{BASE}/v1/instagram/post/DcghxSFtjRB", headers=headers).json()
print(post["engagement"]["play_count"], "plays")

# Keyword/hashtag search (native Instagram relevance)
resp = requests.get(
    f"{BASE}/v1/instagram/search",
    headers=headers,
    params={"query": "dentist teeth whitening", "max_pages": 3},
).json()
print(resp["returned"], "results")

Check your balance & usage​

curl "$LISTENX_BASE/v1/account/me"      -H "X-API-Key: $LISTENX_KEY"
curl "$LISTENX_BASE/v1/account/pricing" -H "X-API-Key: $LISTENX_KEY"
curl "$LISTENX_BASE/v1/account/usage"   -H "X-API-Key: $LISTENX_KEY"

Every data response also includes a billing block showing exactly what the call cost and your remaining balance.

Interactive docs: a live Swagger UI is available at /swgdocs and OpenAPI JSON at /openapi.json.