> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CardGroup cols={2}>
  <Card title="LinkedIn" icon="linkedin" href="/apis/social/linkedin">
    **Endpoints:** 50+

    Company profiles, employee data, job listings, posts, and school information.
  </Card>

  <Card title="YouTube" icon="youtube" href="/apis/social/youtube">
    **Endpoints:** 30+

    Channels, videos, playlists, comments, search, and video transcripts.
  </Card>

  <Card title="TikTok" icon="tiktok" href="/apis/social/tiktok">
    **Endpoints:** 25+

    User profiles, videos, hashtags, sounds, and trending content.
  </Card>

  <Card title="X (Twitter)" icon="x-twitter" href="/apis/social/x">
    **Endpoints:** 40+

    User profiles, tweets, search, timelines, followers, and lists.
  </Card>

  <Card title="Instagram" icon="instagram" href="/apis/social/instagram">
    **Endpoints:** 20+

    Profiles, posts, stories, reels, and hashtag search.
  </Card>

  <Card title="Reddit" icon="reddit" href="/apis/social/reddit">
    **Endpoints:** 15+

    Subreddits, posts, comments, and user profiles.
  </Card>

  <Card title="Facebook" icon="facebook" href="/apis/social/facebook">
    **Endpoints:** 20+

    Pages, posts, groups, and page insights.
  </Card>
</CardGroup>

## 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:

```json theme={null}
{
  "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

<CardGroup cols={2}>
  <Card title="Request Format" icon="code" href="/data-apis/requests">
    Learn about request structure and parameters.
  </Card>

  <Card title="Pagination" icon="list" href="/data-apis/pagination">
    Handle paginated responses.
  </Card>

  <Card title="API Reference" icon="book" href="/apis/overview">
    Browse all available endpoints.
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/concepts/errors">
    Handle errors gracefully.
  </Card>
</CardGroup>