API Reference

Social Intel API

Download datasets, access samples, and integrate social data into your pipeline. RESTful, no SDK required.

Base URL

api.socialintel.io

Protocol

HTTPS

Auth

X-API-Key

Formats

CSV/JSON/Parquet

Quickstart

Get a free sample

100 rows, no auth required. Try before you buy.

bash

curl "https://api.socialintel.io/api/datasets/sample/financial-sentiment?format=csv" \
  -o sample.csv

Download full dataset

Add your API key for paid datasets.

bash

curl "https://api.socialintel.io/api/datasets/download/ai-ml-trends?format=json" \
  -H "X-API-Key: sk_live_..." \
  -o data.json

Python

python

import requests

API_KEY = "sk_live_..."
HEADERS = {"X-API-Key": API_KEY}

# Get catalog
catalog = requests.get(f"https://api.socialintel.io/api/datasets/catalog").json()

# Download a dataset
r = requests.get(
    f"https://api.socialintel.io/api/datasets/download/ai-ml-trends",
    params={"format": "json"},
    headers=HEADERS
)
with open("ai-ml-trends.json", "w") as f:
    f.write(r.text)

Endpoints

GET/api/datasets/catalogPublic

Returns all active datasets with live metadata including record counts, prices, and available formats.

Response

json

[
  {
    "slug": "financial-sentiment",
    "name": "Financial Sentiment Dataset",
    "platform": "reddit",
    "record_count": 5200,
    "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. Great for testing.

Parameters

slugpathrequiredDataset slug (see catalog below)

formatquerycsv | json | parquet (default: csv)

Response

json

# Returns file download — 100 rows always

GET/api/datasets/download/{slug} Auth (paid)

Download the full dataset. Free datasets (under 10000 records) need no auth. Paid datasets require X-API-Key header.

Parameters

slugpathrequiredDataset slug

formatquerycsv | json | jsonl | parquet

Response

json

# 200 — file download
# 401 — missing/invalid API key
# 403 — not purchased or plan too low
# 404 — dataset not found

GET/api/datasets/info/{slug}Public

Get detailed metadata for a single dataset including sample rows and enrichment fields.

Parameters

slugpathrequiredDataset slug

Response

json

{
  "slug": "financial-sentiment",
  "name": "Financial Sentiment Dataset",
  "record_count": 5200,
  "price_monthly": 15,
  "formats": ["csv","json","parquet"],
  "enrichment_fields": ["sentiment_score", "emotion_primary", ...],
  "sample_data": [...]
}

POST/api/auth/registerPublic

Create a free account and get your API key.

Parameters

emailbodyrequiredEmail address

passwordbodyrequiredPassword (min 8 characters)

Response

json

{
  "api_key": "sk_live_...",
  "user": { "id": "...", "email": "...", "plan": "free" }
}

POST/api/auth/loginPublic

Parameters

emailbodyrequiredEmail address

passwordbodyrequiredPassword

Response

json

{
  "api_key": "sk_live_...",
  "user": { "id": "...", "email": "...", "plan": "free" }
}

Error Codes

Status

Meaning

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

429

Rate Limited — slow down requests

500

Server Error — contact support

Dataset Catalog

Browse all

Slug

Platform

Records

Price

Loading live catalog…

Need help?

Questions about the API? We respond within 24 hours.

Contact Support Browse Datasets

SocialINTEL

Fetching datasets…

Quickstart

Get a free sample

100 rows, no auth required. Try before you buy.

bash

curl "https://api.socialintel.io/api/datasets/sample/financial-sentiment?format=csv" \
  -o sample.csv

Download full dataset

Add your API key for paid datasets.

bash

curl "https://api.socialintel.io/api/datasets/download/ai-ml-trends?format=json" \
  -H "X-API-Key: sk_live_..." \
  -o data.json

Python

python

import requests

API_KEY = "sk_live_..."
HEADERS = {"X-API-Key": API_KEY}

# Get catalog
catalog = requests.get(f"https://api.socialintel.io/api/datasets/catalog").json()

# Download a dataset
r = requests.get(
    f"https://api.socialintel.io/api/datasets/download/ai-ml-trends",
    params={"format": "json"},
    headers=HEADERS
)
with open("ai-ml-trends.json", "w") as f:
    f.write(r.text)

Endpoints

GET/api/datasets/catalogPublic

Returns all active datasets with live metadata including record counts, prices, and available formats.

Response

json

[
  {
    "slug": "financial-sentiment",
    "name": "Financial Sentiment Dataset",
    "platform": "reddit",
    "record_count": 5200,
    "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. Great for testing.

Parameters

slugpathrequiredDataset slug (see catalog below)

formatquerycsv | json | parquet (default: csv)

Response

json

# Returns file download — 100 rows always

GET/api/datasets/download/{slug} Auth (paid)

Download the full dataset. Free datasets (under 10000 records) need no auth. Paid datasets require X-API-Key header.

Parameters

slugpathrequiredDataset slug

formatquerycsv | json | jsonl | parquet

Response

json

# 200 — file download
# 401 — missing/invalid API key
# 403 — not purchased or plan too low
# 404 — dataset not found

GET/api/datasets/info/{slug}Public

Get detailed metadata for a single dataset including sample rows and enrichment fields.

Parameters

slugpathrequiredDataset slug

Response

json

{
  "slug": "financial-sentiment",
  "name": "Financial Sentiment Dataset",
  "record_count": 5200,
  "price_monthly": 15,
  "formats": ["csv","json","parquet"],
  "enrichment_fields": ["sentiment_score", "emotion_primary", ...],
  "sample_data": [...]
}

POST/api/auth/registerPublic

Create a free account and get your API key.

Parameters

emailbodyrequiredEmail address

passwordbodyrequiredPassword (min 8 characters)

Response

json

{
  "api_key": "sk_live_...",
  "user": { "id": "...", "email": "...", "plan": "free" }
}

POST/api/auth/loginPublic

Parameters

emailbodyrequiredEmail address

passwordbodyrequiredPassword

Response

json

{
  "api_key": "sk_live_...",
  "user": { "id": "...", "email": "...", "plan": "free" }
}

Error Codes

Status

Meaning

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

429

Rate Limited — slow down requests

500

Server Error — contact support