Social Intel API
Download datasets, access samples, and integrate social data into your workflow.
Base URLhttps://api.socialintel.io
Quickstart
Start downloading data in under 2 minutes.
1
Register & get your API key
Create a free account at socialintel.io/register. Your API key is in your dashboard.
bash
export SOCIALINTEL_API_KEY="your_api_key_here"
2
Download a free sample (no auth)
Try any dataset before buying.
bash
curl "https://api.socialintel.io/api/datasets/sample/financial-sentiment?format=csv" \
-o financial-sentiment-sample.csv
3
Download a free full dataset (no auth)
Datasets under 1000 records are completely free.
bash
curl "https://api.socialintel.io/api/datasets/download/gaming-streams?format=csv" \
-o gaming-streams-full.csv
4
Download a paid dataset (requires API key)
bash
curl "https://api.socialintel.io/api/datasets/download/financial-sentiment?format=csv" \
-H "X-API-Key: $SOCIALINTEL_API_KEY" \
-o financial-sentiment-full.csv
5
Python example
python
import requests
API_KEY = "your_api_key_here"
BASE_URL = "https://api.socialintel.io"
headers = {"X-API-Key": API_KEY}
# List all datasets
catalog = requests.get(BASE_URL + "/api/datasets/catalog").json()
for d in catalog:
price = "FREE" if d["price_monthly"] == 0 else "$" + str(d["price_monthly"])
print(d["name"] + " — " + str(d["record_count"]) + " records — " + price)
# Download a free dataset (no auth)
r = requests.get(
BASE_URL + "/api/datasets/download/gaming-streams",
params={"format": "csv"},
)
with open("gaming-streams-full.csv", "wb") as f:
f.write(r.content)
# Download a paid dataset (auth required)
r = requests.get(
BASE_URL + "/api/datasets/download/financial-sentiment",
headers=headers,
params={"format": "csv"},
)
with open("financial-sentiment-full.csv", "wb") as f:
f.write(r.content) Authentication
Pass your API key in the X-API-Key header. Sample endpoints and free dataset downloads are public.
bash
# Free sample — no auth
curl "https://api.socialintel.io/api/datasets/sample/financial-sentiment?format=csv"
# Free full dataset — no auth (under 1000 records)
curl "https://api.socialintel.io/api/datasets/download/gaming-streams?format=csv"
# Paid dataset — auth required
curl -H "X-API-Key: your_api_key_here" \
"https://api.socialintel.io/api/datasets/download/financial-sentiment?format=csv"
API Endpoints
GET/api/datasets/catalogPublic
Returns all active datasets with live metadata including current record count and price.
Response
json
[
{
"slug": "financial-sentiment",
"name": "Financial Sentiment Dataset",
"platform": "reddit",
"record_count": 5000,
"price_monthly": 15,
"formats": ["csv","json","parquet"],
"status": "active"
}
]GET/api/datasets/sample/{slug}Public
Download a 100-row preview of any dataset. No authentication required.
Parameters
slugpathrequiredDataset slug (see table below)
formatquerycsv · json (default: csv)
Response
json
# Returns file download — always 100 rows
GET/api/datasets/download/{slug} Auth for paid Download the full dataset. Datasets under 1000 records are free — no auth. Paid datasets require a valid API key and prior purchase or Pro plan.
Parameters
slugpathrequiredDataset slug
formatquerycsv · json · parquet (default: csv)
Response
json
# 200 — file download
# 401 — API key missing or invalid
# 403 — dataset not purchased or plan too low
GET/api/datasets/info/{slug}Public
Returns full metadata for a single dataset including sample data rows.
Parameters
slugpathrequiredDataset slug
Response
json
{
"slug": "financial-sentiment",
"name": "Financial Sentiment Dataset",
"record_count": 5000,
"price": 15,
"formats": ["csv","json","parquet"],
"sample_data": [...]
}GET/api/auth/me Auth required Returns the authenticated user's profile and plan.
Response
json
{
"id": "usr_abc123",
"email": "you@example.com",
"plan": "free"
}POST/api/auth/registerPublic
Create a new account and receive an API key.
Parameters
emailbodyrequiredEmail address
passwordbodyrequiredPassword (min 8 chars)
full_namebodyDisplay name
Response
json
{
"api_key": "sk_live_...",
"user": { "id": "...", "email": "...", "plan": "free" }
}POST/api/auth/loginPublic
Log in and retrieve your API key.
Parameters
emailbodyrequiredEmail address
passwordbodyrequiredPassword
Response
json
{
"api_key": "sk_live_...",
"user": { "id": "...", "email": "...", "plan": "free" }
}POST/api/payments/checkout Auth required Create a NOWPayments crypto invoice for a dataset or Pro plan.
Parameters
dataset_slugbodyDataset slug — omit for Pro plan purchases
planbody"pro_monthly" or "pro_yearly"
Response
json
{
"invoice_url": "...",
"invoice_id": "...",
"pay_address": "...",
"pay_amount": "...",
"pay_currency": "..."
} Available Datasets
Live data from the catalog API. Use these slugs in your requests.
Error Codes
All errors return JSON with a detail field.
200
OK — request succeeded
400
Bad Request — invalid parameters
401
Unauthorized — missing or invalid API key
403
Forbidden — dataset not purchased or plan too low
404
Not Found — dataset slug does not exist
422
Unprocessable — validation error (see detail field)
429
Rate Limited — slow down requests
500
Server Error — contact support
Need Help?
Questions about the API or your integration? We respond within 24 hours.
