> For the complete documentation index, see [llms.txt](https://docs.social.nimbleway.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.social.nimbleway.com/nimble-social-api/social-api-overview.md).

# Social API - Overview

## Overview

The Social API allows users to seamlessly interact with popular social media platforms, including LinkedIn, and Twitter. This API enables users to search for and collect a wide range of data from these platforms, including posts, profiles, comments, hashtags, and more.&#x20;

Additionally, the Social API includes a dedicated Person API for retrieving detailed information from LinkedIn profiles.

The Social API make it easy for users to:

* [x] **Search Social Media Platforms**: Query LinkedIn, and Twitter for relevant posts, profiles, hashtags, and locations.
* [x] **Collect and Structure Profile Information**: Gather data on social media profiles, including bios, follower counts, profile images, and more.
* [x] **Aggregate Comment and Interaction Data**: Collect comments, likes, and shares associated with posts, including user details and interaction timestamps.
* [x] **Dedicated LinkedIn Profile Data**: Through the Person API, access comprehensive data from LinkedIn profiles, including professional history, skills, endorsements, and contact information.

## Features

* [x] **LinkedIn**: Search for profiles, companies, and posts; collect detailed profile information (professional history, skills, endorsements); retrieve posts and articles; access company data.
* [x] **Twitter**: Search for tweets, profiles, and hashtags; collect tweet details (text, images, videos, retweets, likes, replies); gather user profile information; extract hashtag and trending topic data.
* [x] **Person API for LinkedIn**: Access detailed LinkedIn profile information; retrieve professional history, skills, endorsements, education; gather contact information; collect data on connections and network reach.
* [x] **TikTok:** Search for users, posts, and hashtags; collect detailed user profile information (bio, follower metrics, links); retrieve video posts (captions, hashtags, engagement); access trending content and related metadata.
* [x] **Workforce:** Search for employees within a company; collect detailed employee information (roles, seniority, departments, locations); filter by LinkedIn company ID and other criteria; retrieve structured, paginated workforce data.

## Pricing

Nimble API comes with several flexible pricing plans, all of which share the following benefits:

* [x] **Pay per success** -  only successful requests are billed, include platform's 404 - Entity Not Found.
* [x] **Auto-renewal** - plans can optionally renew automatically so your pipelines are never interrupted.
* [x] **Product universality** - all of Nimble's plans enable access to all of our products.

For detailed pricing information, see our [pricing page](https://nimbleway.com/pricing/).

## Getting started <a href="#getting-started" id="getting-started"></a>

To use Nimble API, you'll first need a Nimble account. If you don’t already have an account, our sales team would love to help you get started!

[<img src="/files/9ZihdLE3iMUHcmtBjPoV" alt="" data-size="original">](https://nimbleway.com/contact-general/)

## Need help?

This document provides a detailed walkthrough of the usage and capabilities of the Maps API. If you have any questions that are not answered here, please let us know by dropping us a line on Slack, sending us a message [through our website](https://nimbleway.com/contact-general/), or directly through our email at <support@nimbleway.com>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.social.nimbleway.com/nimble-social-api/social-api-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
