Data APIs Overview

Access social media data across platforms through a unified API.

What Are Data APIs?

Data APIs provide structured access to social media data across multiple platforms. Instead of integrating with each platform separately, you use a single API endpoint pattern to fetch profiles, posts, and analytics from LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook.

Unified Interface

All platform APIs follow the same pattern:

GET https://api.agntdata.dev/v1/data/{source}/{operation}

Examples:

• GET /v1/data/linkedin/get-company-details?username=microsoft
• GET /v1/data/youtube/get-channel-details?username=@mkbhd
• GET /v1/data/x/get-user-details?username=elonmusk

Available Platforms

LinkedIn

Endpoints: 50+

Company profiles, employee data, job listings, posts, and school information.

YouTube

Endpoints: 30+

Channels, videos, playlists, comments, search, and video transcripts.

TikTok

Endpoints: 25+

User profiles, videos, hashtags, sounds, and trending content.

X (Twitter)

Endpoints: 40+

User profiles, tweets, search, timelines, followers, and lists.

Instagram

Endpoints: 20+

Profiles, posts, stories, reels, and hashtag search.

Reddit

Endpoints: 15+

Subreddits, posts, comments, and user profiles.

Facebook

Endpoints: 20+

Pages, posts, groups, and page insights.

Common Operations

Most platforms support these operation types:

Operation	Description	Example
get-*-details	Fetch a single resource	get-company-details
get-*-posts	List posts/content	get-user-posts
search-*	Search for resources	search-companies
get-*-followers	List followers/connections	get-user-followers

Response Format

All responses follow a consistent structure:

{
  "success": true,
  "data": {
    // Platform-specific data
  },
  "meta": {
    "costCents": 1,
    "purchasedBalanceCents": 949,
    "subscriptionRemainingCents": 500,
    "cached": false,
    "latencyMs": 245
  }
}

Data Normalization

While each platform has unique data, agntdata normalizes common fields:

Field	Normalized As
User/profile ID	id
Display name	name
Username/handle	username
Profile image	profileImage
Follower count	followerCount
Post/content date	ISO 8601 timestamp

Platform-specific fields are preserved in their original format.

Proxy Mode

For advanced use cases, you can also access the raw upstream API response:

GET https://api.agntdata.dev/v1/data/{source}/proxy/{endpoint}

This passes through the exact response from the underlying API without normalization.

Credits

Each API call consumes credits based on the endpoint:

Endpoint Type	Credits
Basic profile lookup	1
Detailed profile	2-5
Search/list operations	5-10
Bulk operations	10+

Credit costs are documented in each endpoint’s API reference.

Next Steps

Request Format

Learn about request structure and parameters.

Pagination

Handle paginated responses.

API Reference

Browse all available endpoints.

Error Handling

Handle errors gracefully.