Datasets Requests Sources Features Pricing

SocialINTEL

Fetching datasets…

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/JSONL/Parquet

Quickstart

Get a free sample

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

bash

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

Download full dataset

Add your API key for full access.

bash

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

Rate Limits

Global

100/min

Per IP, edge-protected

Free Plan

500/day

~15K/month average

Individual Plan

1,000/day

Per-dataset purchases

Pro Plan

Up to 15K/day

Customizable via Pro Builder

Python

Requires the requests library (pip install requests).

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

Pro plan also includes webhook subscriptions (POST /api/webhooks), custom dataset requests (POST /api/custom-dataset-requests), and log capture endpoints. See the Dashboard for your API key and full endpoint reference.

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,
    "formats": ["csv","json","jsonl","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 | jsonl | parquet (default: csv)

Response

json

# Returns file download — 100 rows always

GET/api/datasets/download/{slug} Auth

Download the full dataset. Free for datasets under 10K rows. Larger datasets require an Individual purchase or Pro plan. Requires X-API-Key or Bearer token.

Parameters

slugpathrequiredDataset slug

formatquerycsv | json | jsonl | parquet

Response

json

# 200 — file download
# 401 — missing/invalid API key
# 403 — not authorized 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

{
  "id": 151,
  "slug": "financial-sentiment",
  "name": "Financial Sentiment Dataset",
  "platform": "Reddit",
  "platforms": ["reddit"],
  "platform_count": 1,
  "description": "Financial sentiment from Reddit",
  "record_count": 5200,
  "price": 0,
  "status": "active",
  "update_frequency": "static",
  "formats": ["csv","json","jsonl","parquet"],
  "fields": ["id","content","sentiment_score",...],
  "license": "social-intel-commercial",
  "sample_url": "/api/datasets/sample/financial-sentiment",
  "download_url": "/api/datasets/download/financial-sentiment"
}

POST/api/auth/registerPublic

Create a free account — returns an access token. Get your API key from the Dashboard.

Parameters

emailbodyrequiredEmail address

passwordbodyrequiredPassword (min 8 characters)

Response

json

{
  "success": true,
  "access_token": "eyJhbGciOi...",
  "token_type": "bearer",
  "user": { "id": "...", "email": "...", "plan": "free" }
}

POST/api/auth/loginPublic

Parameters

emailbodyrequiredEmail address

passwordbodyrequiredPassword

Response

json

{
  "success": true,
  "access_token": "eyJhbGciOi...",
  "token_type": "bearer",
  "user": { "id": "...", "email": "...", "plan": "free" }
}

GET/api/user/favorites Auth

Return list of dataset slugs the current user has favorited.

Response

json

{
  "success": true,
  "favorites": ["financial-sentiment", "ai-ml-trends"]
}

POST/api/user/favorites Auth

Add a dataset to user's favorites.

Parameters

slugbodyrequiredDataset slug to favorite

Response

json

{
  "success": true,
  "favorited": true
}

DELETE/api/user/favorites/{slug} Auth

Remove a dataset from user's favorites.

Response

json

{
  "success": true,
  "removed": true
}

Authentication

GET/api/auth/me Auth

Returns the authenticated user's basic information including ID, email, and plan tier.

Response

json

{
  "success": true,
  "user": {
    "id": "usr_...",
    "email": "user@example.com",
    "plan": "free",
    "email_verified": true
  }
}

POST/api/auth/logout Auth

Invalidate the current session / access token.

Response

json

{
  "success": true,
  "message": "Logged out successfully"
}

POST/api/auth/refresh Auth

Refresh the access token before it expires.

Response

json

{
  "success": true,
  "access_token": "eyJhbGciOi...",
  "token_type": "bearer"
}

POST/api/auth/verify-emailPublic

Verify your email address using the token sent during registration.

Parameters

tokenbodyrequiredVerification token from email

Response

json

{
  "success": true,
  "message": "Email verified successfully"
}

POST/api/auth/forgot-passwordPublic

Request a password reset email.

Parameters

emailbodyrequiredRegistered email address

Response

json

{
  "success": true,
  "message": "If the email exists, a reset link has been sent"
}

User Profile

GET/api/user/me Auth

Full user profile including API call usage, plan details, and account info.

Response

json

{
  "success": true,
  "user": {
    "id": "usr_...",
    "email": "user@example.com",
    "plan": "pro",
    "api_calls_used": 420,
    "api_calls_limit": 15000,
    "created_at": "2026-01-01T00:00:00Z"
  }
}

PUT/api/user/profile Auth

Update display name or avatar URL.

Parameters

namebodyDisplay name

avatar_urlbodyAvatar image URL

Response

json

{
  "success": true,
  "user": { "id": "usr_...", "name": "Jane Doe" }
}

POST/api/user/regenerate-key Auth

Revoke the current API key and issue a new one.

Response

json

{
  "success": true,
  "api_key": "sk_live_..."
}

GET/api/user/downloads Auth

List all dataset downloads made by the authenticated user.

Response

json

{
  "downloads": [
    { "slug": "financial-sentiment", "format": "csv", "downloaded_at": "..." }
  ]
}

API Keys

GET/api/keys Auth

List all API keys for the authenticated user.

Response

json

{
  "keys": [
    { "id": "key_...", "prefix": "sk_live_....", "label": "My Key", "created_at": "...", "last_used": "..." }
  ]
}

POST/api/keys Auth

Create a new API key with an optional label.

Parameters

labelbodyFriendly label for the key

Response

json

{
  "success": true,
  "key": { "id": "key_...", "api_key": "sk_live_...", "label": "My Key", "created_at": "..." }
}

DELETE/api/keys/{key_id} Auth

Revoke an API key immediately. The key will no longer work.

Response

json

{
  "success": true,
  "deleted": true
}

Webhooks

GET/api/webhooks Auth

List all registered webhooks for your account.

Response

json

{
  "webhooks": [
    {
      "id": "wh_...",
      "url": "https://example.com/hook",
      "events": ["dataset.downloaded", "dataset.updated"],
      "active": true
    }
  ]
}

POST/api/webhooks Auth

Parameters

urlbodyrequiredHTTPS endpoint URL

eventsbodyArray of event types to subscribe to (default: all)

Response

json

{
  "success": true,
  "webhook": { "id": "wh_...", "url": "https://example.com/hook", "active": true }
}

GET/api/webhooks/{webhook_id} Auth

Get details for a specific webhook registration.

Response

json

{
  "webhook": {
    "id": "wh_...",
    "url": "https://example.com/hook",
    "events": ["dataset.downloaded"],
    "active": true,
    "created_at": "..."
  }
}

DELETE/api/webhooks/{webhook_id} Auth

Delete a webhook and stop receiving notifications.

Response

json

{
  "success": true,
  "deleted": true
}

POST/api/webhooks/{webhook_id}/test Auth

Send a test payload to a registered webhook URL.

Response

json

{
  "success": true,
  "delivery_id": "del_...",
  "status": "delivered"
}

Custom Datasets

POST/api/custom-dataset-requests Auth

Submit a custom dataset request. Pick platforms, queries, and row count. Priced per row.

Parameters

platformsbodyrequiredArray of platform names (e.g. ["reddit","twitter"])

queriesbodyrequiredArray of search queries

max_rowsbodyrequiredMaximum number of rows to collect

Response

json

{
  "success": true,
  "reference_id": "ref_...",
  "estimated_cost": 14.99,
  "status": "pending"
}

GET/api/custom-dataset-requests/{reference_id}/status Auth

Check the processing status and progress of a custom dataset request.

Parameters

reference_idpathrequiredReference ID returned from request creation

Response

json

{
  "status": "processing",
  "progress": 65,
  "estimated_completion": "2026-01-01T00:00:00Z"
}

Contact & Feedback

POST/api/contactPublic

Send a message to the Social Intel support team. We respond within 24 hours.

Parameters

emailbodyrequiredYour email address

subjectbodyrequiredMessage subject

messagebodyrequiredMessage body

Response

json

{
  "success": true,
  "ticket_id": "...",
  "message": "Ticket created — we'll respond within 24 hours"
}

Error Codes

Status

Meaning

200

OK — request succeeded

400

Bad Request — invalid parameters

401

Unauthorized — missing or invalid API key

403

Forbidden — not authorized 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

5g-and-connectivity-infrastructure-discussion

4chan, 500Px, 8kun +88 more

21.7K

$18

academic-research-integrity-discourse

4chan, 500Px, 8kun +85 more

14.0K

$18

addiction-and-recovery-community-signals

4chan, 8kun, AO3 +77 more

6.4K

Free

advertising-and-media-buying-community

4chan, 500Px, 8kun +87 more

6.2K

Free

ageing-population-and-eldercare-discourse

4chan, 8kun, AO3 +77 more

3.8K

Free

ai-developer-tools-adoption

4chan, 500Px, 8kun +88 more

54.3K

$48

ai-ethics-and-safety-debate

4chan, 500Px, 8kun +92 more

43.9K

$28

ai-in-education-community-debate

4chan, 500Px, 8kun +85 more

—

Free

ai-in-healthcare-professional-discourse

4chan, 500Px, 8kun +85 more

5.1K

Free

ai-job-market-and-skills-demand

4chan, 500Px, 8kun +85 more

2.3K

Free

ai-model-release-sentiment

4chan, 500Px, 8kun +88 more

9.5K

Free

ai-startup-funding-and-news

4chan, 500Px, 8kun +85 more

—

Free

alt-platform-echo-chambers-and-radicalisation

4chan, 8kun, AO3 +77 more

—

Free

augmented-and-virtual-reality-discourse

4chan, 500Px, 8kun +89 more

—

Free

b2b-saas-and-enterprise-software-discourse

4chan, 500Px, 8kun +87 more

—

Free

+ 107 more datasets — see catalog endpoint

Need help?

Questions about the API? We respond within 24 hours.

Contact Support Browse Datasets