FetchLayer

https://fetchlayer.dev/documentation
Admin
FetchLayer provides unified REST APIs, SDKs, and MCP integrations to access structured data from...
Tokens:57,783
Snippets:344
Trust Score:5.4
Update:1 month ago
Show doc for...
Tokens:
Raw
### User Posts Response Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/user.json

Example JSON response for a user-posts request.

```json
{
  "blocked": false,
  "listingType": "user-posts",
  "username": "spez",
  "items": [
    {
      "id": "abc",
      "title": "Announcing new features",
      "subreddit": "reddit",
      "score": 5000,
      "commentCount": 800,
      "permalink": "https://www.reddit.com/r/reddit/comments/abc/",
      "createdAt": "2026-08-13T03:00:00.000Z",
      "nsfw": false,
      "spoiler": false,
      "locked": false,
      "stickied": false
    }
  ],
  "itemCount": 1,
  "nextPageUrl": "https://old.reddit.com/user/spez/submitted/?after=t3_abc",
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "old-reddit-html"
}
```

--------------------------------

### Fetch Reviews Request Example

Source: https://fetchlayer.dev/documentation/appstore/openapi.json

Example JSON payload for requesting reviews for a specific app.

```json
{
  "appId": "1234567890",
  "country": "us",
  "pages": 1
}
```

--------------------------------

### Transcript Request Example

Source: https://fetchlayer.dev/documentation/youtube/openapi.json

Example JSON payload for requesting a video transcript with a preferred language.

```json
{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "language": "en"
}
```

--------------------------------

### Search Communities Request Examples

Source: https://fetchlayer.dev/documentation/reddit/endpoints/search-communities

Examples of how to perform a search for subreddits using cURL and the Node.js SDK.

```bash
curl -X POST "https://api.fetchlayer.dev/reddit/search-communities" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"programming","limit":5}'
```

```javascript
import { FetchLayer } from '@fetchlayer/reddit';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.searchCommunities({
  "query": "programming",
  "limit": 5
});
```

--------------------------------

### User Replies Request Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/content.json

Example JSON payload for requesting replies from a specific user handle.

```json
{
  "handle": "sama",
  "count": 3
}
```

--------------------------------

### Followers Response Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/network.json

Example JSON response structure for the /followers endpoint.

```json
{
  "users": [
    {
      "handle": "karpathy",
      "displayName": "Andrej Karpathy",
      "description": "Building @EurekaLabsAI. Previously: Director of AI @Tesla, founding team @OpenAI, CS PhD @Stanford.",
      "isVerified": true,
      "followersCount": 1100000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/karpathy_normal.jpg"
    },
    {
      "handle": "ylecun",
      "displayName": "Yann LeCun",
      "description": "Professor at NYU. Chief AI Scientist at Meta. Turing Award. Researcher in AI, Machine Learning, Robotics, etc.",
      "isVerified": true,
      "followersCount": 850000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/ylecun_normal.jpg"
    }
  ],
  "cursor": "DAABCgABF8zK9v__-Z3"
}
```

--------------------------------

### Subreddit Metadata Request Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/community.json

Example payload for requesting metadata for a specific subreddit.

```json
{
  "subreddit": "programming"
}
```

--------------------------------

### Search Communities Example Response

Source: https://fetchlayer.dev/documentation/reddit/openapi/search.json

Example JSON response for a successful search-communities request.

```json
{
  "blocked": false,
  "listingType": "search-communities",
  "query": "programming",
  "items": [
    {
      "subreddit": "programming",
      "subredditPrefixed": "r/programming",
      "title": "Programming",
      "descriptionText": "Computer Programming",
      "url": "https://www.reddit.com/r/programming/",
      "metaText": "Programming community",
      "nsfw": false
    }
  ],
  "itemCount": 1,
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "old-reddit-html"
}
```

--------------------------------

### API Response Examples

Source: https://fetchlayer.dev/documentation/fetchlayer/endpoints/me-credits

Example JSON responses for successful credit retrieval and authentication errors.

```json
{
  "credits": 12450
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Google Maps reviews response examples

Source: https://fetchlayer.dev/documentation/google-maps/endpoints/reviews

Example JSON responses for successful requests and authentication errors.

```json
{
  "reviews": []
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Followers Request Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/network.json

Example JSON payload for the /followers endpoint request.

```json
{
  "handle": "sama",
  "count": 2
}
```

--------------------------------

### Comment Permalink Response Examples

Source: https://fetchlayer.dev/documentation/reddit/endpoints/comment-permalink

Example JSON responses for successful requests and authentication errors.

```json
{
  "blocked": false,
  "listingType": "comment-permalink",
  "commentId": "xyz123",
  "postId": "abc123",
  "postTitle": "Example post",
  "focalCommentFound": true,
  "focalComment": {
    "id": "xyz123",
    "author": "user1",
    "bodyText": "This is a comment.",
    "score": 100,
    "createdAt": "2026-08-13T03:00:00.000Z",
    "depth": 0,
    "collapsed": false,
    "stickied": false,
    "children": []
  },
  "ancestorComments": [],
  "replyCount": 0,
  "commentPagesRequested": 1,
  "commentPagesScraped": 1,
  "transport": "old-reddit-html"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### User Comments Request Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/user.json

Example JSON request body for retrieving user comments.

```json
{
  "username": "spez",
  "limit": 10
}
```

--------------------------------

### Search Communities Response Examples

Source: https://fetchlayer.dev/documentation/reddit/endpoints/search-communities

Example JSON responses for successful requests and authentication errors.

```json
{
  "blocked": false,
  "listingType": "search-communities",
  "query": "programming",
  "items": [
    {
      "subreddit": "programming",
      "subredditPrefixed": "r/programming",
      "title": "Programming",
      "descriptionText": "Computer Programming",
      "url": "https://www.reddit.com/r/programming/",
      "metaText": "Programming community",
      "nsfw": false
    }
  ],
  "itemCount": 1,
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "old-reddit-html"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Search Users Limit Parameter Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/search.json

Example value for the limit parameter in the search-users request body.

```json
"10"
```

--------------------------------

### Search Comments Request Example

Source: https://fetchlayer.dev/documentation/reddit/openapi.json

Example request body for the search-comments endpoint.

```json
{
                    "query": "mcp",
                    "sort": "top",
                    "time": "all",
                    "limit": 25
                  }
```

--------------------------------

### API Response Examples

Source: https://fetchlayer.dev/documentation/reddit/endpoints/community-details

Sample JSON responses for successful requests and authentication errors.

```json
{
  "blocked": false,
  "subreddit": "programming",
  "subredditPrefixed": "r/programming",
  "title": "Programming",
  "descriptionText": "Computer Programming",
  "memberCount": 35000000,
  "memberCountText": "35M members",
  "activeCount": 45000,
  "activeCountText": "45K weekly contributions",
  "createdAt": "2008-01-25T00:00:00.000Z",
  "nsfw": false,
  "url": "https://www.reddit.com/r/programming/",
  "transport": "new-reddit-html"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### User Profile Example JSON

Source: https://fetchlayer.dev/documentation/reddit/openapi/user.json

Example JSON object representing a Reddit user profile response.

```json
{
  "username": "spez",
  "blocked": false,
  "displayName": "spez",
  "aboutText": "Reddit profile description.",
  "postKarma": 800000,
  "postKarmaText": "800K",
  "commentKarma": 700000,
  "commentKarmaText": "700K",
  "createdAt": "2005-06-23T00:00:00.000Z",
  "ageText": "21 years",
  "isGold": true,
  "trophies": [
    "Verified Email"
  ],
  "url": "https://www.reddit.com/user/spez/",
  "transport": "old-reddit-html"
}
```

--------------------------------

### Transcript Response Examples

Source: https://fetchlayer.dev/documentation/youtube/endpoints/transcript

Example JSON responses for successful transcript retrieval and authentication errors.

```json
{
  "segments": [
    {
      "start": 0,
      "duration": 3.5,
      "text": "We're no strangers to love"
    }
  ],
  "text": "We're no strangers to love..."
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Tweet Detail Response Examples

Source: https://fetchlayer.dev/documentation/twitter/endpoints/tweet-detail

Example JSON responses for successful requests and authentication errors.

```json
{
  "id": "1942939879222220800",
  "text": "Just tried the new GPT-4o vision features on the OpenAI playground — it correctly described a screenshot of our dashboard in one prompt. Incredible.",
  "author": {
    "handle": "devuser",
    "displayName": "Dev User",
    "isVerified": false,
    "followersCount": 3200
  },
  "createdAt": "2026-07-01T18:42:00.000Z",
  "likeCount": 142,
  "retweetCount": 31,
  "replyCount": 23,
  "quoteCount": 4,
  "viewCount": 8200,
  "url": "https://x.com/devuser/status/1942939879222220800",
  "lang": "en",
  "media": []
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Verified Followers Response Example

Source: https://fetchlayer.dev/documentation/twitter/openapi.json

Example JSON response structure for the verified followers endpoint.

```json
{
  "users": [
    {
      "handle": "satyanadella",
      "displayName": "Satya Nadella",
      "description": "Chairman and CEO at Microsoft.",
      "isVerified": true,
      "followersCount": 3200000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/karpathy_normal.jpg"
    },
    {
      "handle": "ylecun",
      "displayName": "Yann LeCun",
      "description": "Professor at NYU. Chief AI Scientist at Meta. Turing Award. Researcher in AI, Machine Learning, Robotics, etc.",
      "isVerified": true,
      "followersCount": 850000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/ylecun_normal.jpg"
    }
  ],
  "cursor": "DAABCgABF8zK9v__-Z3"
}
```

--------------------------------

### App Review Example Payload

Source: https://fetchlayer.dev/documentation/appstore/openapi.json

Example JSON structure for an app review response, including review details and the number of pages fetched for billing purposes.

```json
{
  "reviews": [
    {
      "id": "r123",
      "rating": 5,
      "title": "Great app",
      "body": "Love using this every day!",
      "author": "User123",
      "version": "10.1.0",
      "date": "2026-07-28T12:00:00Z",
      "helpfulCount": 12
    }
  ],
  "pagesFetched": 1
}
```

--------------------------------

### Search Reddit Comments Request Examples

Source: https://fetchlayer.dev/documentation/reddit/endpoints/search-comments

Examples of how to perform a search request using cURL and the official Node.js client.

```bash
curl -X POST "https://api.fetchlayer.dev/reddit/search-comments" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"mcp","sort":"top","time":"all","limit":25}'
```

```javascript
import { FetchLayer } from '@fetchlayer/reddit';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.searchComments({
  "query": "mcp",
  "sort": "top",
  "time": "all",
  "limit": 25
});
```

--------------------------------

### Subreddit Search Request Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/search.json

Example JSON payload for searching subreddits with a specific query and result limit.

```json
{
  "query": "programming",
  "limit": 5
}
```

--------------------------------

### Transcript Response Example

Source: https://fetchlayer.dev/documentation/youtube/openapi.json

Example JSON response containing timestamped segments and the full transcript text.

```json
{
  "segments": [
    {
      "start": 0,
      "duration": 3.5,
      "text": "We're no strangers to love"
    }
  ],
  "text": "We're no strangers to love..."
}
```

--------------------------------

### Following Endpoint Responses

Source: https://fetchlayer.dev/documentation/twitter/endpoints/following

Example JSON responses for successful requests and authentication errors.

```json
{
  "users": [
    {
      "handle": "gdb",
      "displayName": "Greg Brockman",
      "description": "President & Co-Founder @OpenAI.",
      "isVerified": true,
      "followersCount": 1200000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/gdb_normal.jpg"
    },
    {
      "handle": "miramurati",
      "displayName": "Mira Murati",
      "description": "CTO @OpenAI.",
      "isVerified": true,
      "followersCount": 450000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/mira_normal.jpg"
    }
  ],
  "cursor": "DAABCgABF8zK9v__-Z2"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Fetch Community Posts

Source: https://fetchlayer.dev/documentation/reddit/endpoints/community-posts

Examples of how to request community posts using cURL or the Node.js SDK.

```bash
curl -X POST "https://api.fetchlayer.dev/reddit/community-posts" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"subreddit":"programming","sort":"top","limit":10,"time":"week"}'
```

```javascript
import { FetchLayer } from '@fetchlayer/reddit';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.communityPosts({
  "subreddit": "programming",
  "sort": "top",
  "limit": 10,
  "time": "week"
});
```

--------------------------------

### API Response Examples

Source: https://fetchlayer.dev/documentation/playstore/endpoints/reviews

Successful and error response structures for the reviews endpoint.

```json
{
  "appId": "com.spotify.music",
  "reviews": [
    {
      "reviewId": "review-id",
      "rating": 5,
      "reviewer": "Example user",
      "body": "Great app",
      "timestamp": "2026-08-18T10:00:00.000Z",
      "language": "en"
    }
  ],
  "reviewCount": 1,
  "pagesRequested": 1,
  "scrapedAt": "2026-08-18T10:00:01.000Z",
  "analysis": {
    "totalReviews": 1,
    "averageRating": 5,
    "ratingDistribution": {
      "5": 1
    }
  }
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Response Payloads for About Profile

Source: https://fetchlayer.dev/documentation/twitter/endpoints/about-profile

Example JSON responses for successful requests and authentication errors.

```json
{
  "handle": "OpenAI",
  "category": "Technology",
  "isBusiness": true,
  "isGovernment": false,
  "affiliates": []
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Request verified followers

Source: https://fetchlayer.dev/documentation/twitter/endpoints/verified-followers

Examples of how to request verified followers using cURL and the Node.js SDK.

```bash
curl -X POST "https://api.fetchlayer.dev/twitter/verified-followers" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"handle":"openai","count":2}'
```

```javascript
import { FetchLayer } from '@fetchlayer/twitter';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.verifiedFollowers({
  "handle": "openai",
  "count": 2
});
```

--------------------------------

### GET /discover

Source: https://fetchlayer.dev/documentation/reddit/openapi/discover.json

Retrieves a list of Reddit communities organized by topics and sections.

```APIDOC
## GET /discover

### Description
Retrieves a curated list of Reddit communities, categorized by topics and sections, along with metadata such as total item counts and transport information.

### Method
GET

### Endpoint
/discover

### Response
#### Success Response (200)
- **blocked** (boolean) - Indicates if the request was blocked.
- **listingType** (string) - The type of listing (e.g., explore).
- **sections** (array) - List of community sections with headings and items.
- **allItems** (array) - List of all communities.
- **totalItemCount** (number) - Total number of communities in allItems.
- **topics** (array) - Available explore topic filters.
- **scrapedAt** (string) - ISO 8601 timestamp for the scrape.
- **transport** (string) - Reddit page transport used for extraction.

#### Response Example
{
  "blocked": false,
  "listingType": "explore",
  "sections": [
    {
      "heading": "Technology",
      "items": [
        {
          "subreddit": "programming",
          "subredditPrefixed": "r/programming",
          "subredditId": "t5_2fwo",
          "title": "Programming",
          "descriptionText": "Computer Programming",
          "url": "https://www.reddit.com/r/programming/"
        }
      ]
    }
  ],
  "allItems": [],
  "totalItemCount": 1,
  "topics": ["Technology"],
  "transport": "new-reddit-html"
}
```

--------------------------------

### Retrieve User Posts

Source: https://fetchlayer.dev/documentation/reddit/endpoints/user-posts

Examples for requesting user posts using cURL and the Node.js SDK.

```bash
curl -X POST "https://api.fetchlayer.dev/reddit/user-posts" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","limit":10}'
```

```javascript
import { FetchLayer } from '@fetchlayer/reddit';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.userPosts({
  "username": "spez",
  "limit": 10
});
```

--------------------------------

### Search API Responses

Source: https://fetchlayer.dev/documentation/reddit/endpoints/search

Example JSON responses for successful search queries and authentication errors.

```json
{
  "blocked": false,
  "listingType": "search",
  "query": "developer tools",
  "sort": "top",
  "time": "week",
  "subredditFilter": "webdev",
  "items": [
    {
      "id": "abc123",
      "title": "What tools do you swear by?",
      "subreddit": "webdev",
      "author": "devuser",
      "score": 3241,
      "commentCount": 418,
      "url": "https://reddit.com/r/webdev/comments/...",
      "createdAt": "2026-08-13T03:00:00.000Z",
      "nsfw": false,
      "spoiler": false,
      "locked": false,
      "stickied": false
    }
  ],
  "itemCount": 1,
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "old-reddit-html"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### User Profile API Responses

Source: https://fetchlayer.dev/documentation/reddit/endpoints/user-profile

Example JSON responses for successful requests and authentication errors.

```json
{
  "username": "spez",
  "blocked": false,
  "displayName": "spez",
  "aboutText": "Reddit profile description.",
  "postKarma": 800000,
  "postKarmaText": "800K",
  "commentKarma": 700000,
  "commentKarmaText": "700K",
  "createdAt": "2005-06-23T00:00:00.000Z",
  "ageText": "21 years",
  "isGold": true,
  "trophies": [
    "Verified Email"
  ],
  "url": "https://www.reddit.com/user/spez/",
  "transport": "old-reddit-html"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Tweet Replies Example Data

Source: https://fetchlayer.dev/documentation/twitter/openapi.json

Example payload for a list of tweet replies.

```json
"replies": [
  {
    "id": "1942941234567890000",
    "text": "Absolutely. I used it to analyze a full Next.js project structure and it caught a race condition I missed.",
    "author": {
      "handle": "reactdev",
      "displayName": "React Dev",
      "isVerified": false
    },
    "createdAt": "2026-07-01T19:05:00.000Z",
    "likeCount": 28,
    "retweetCount": 2,
    "replyCount": 5
  },
  {
    "id": "1942942345678900000",
    "text": "How does it compare to Claude Computer Use for those kinds of tasks?",
    "author": {
      "handle": "ai_researcher",
      "displayName": "AI Researcher",
      "isVerified": false
    },
    "createdAt": "2026-07-01T19:12:00.000Z",
    "likeCount": 12,
    "retweetCount": 0,
    "replyCount": 8
  }
],
"cursor": "DAABCgABF8zK9v__-W9"
```

--------------------------------

### Fetch App Reviews Request

Source: https://fetchlayer.dev/documentation/appstore/endpoints/reviews

Examples of how to request app reviews using cURL and the FetchLayer Node.js client.

```bash
curl -X POST "https://api.fetchlayer.dev/appstore/reviews" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"appId":"1234567890","country":"us","pages":1}'
```

```javascript
import { FetchLayer } from '@fetchlayer/appstore';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.reviews({
  "appId": "1234567890",
  "country": "us",
  "pages": 1
});
```

--------------------------------

### Tweet Response Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/content.json

Example JSON payload for a successful tweet retrieval response.

```json
{
  "tweets": [
    {
      "id": "1942900000000000000",
      "text": "Introducing GPT-4.1 — our most capable model yet, with improved reasoning, coding, and instruction following. Rolling out to API users starting today.",
      "createdAt": "2026-07-01T14:00:00.000Z",
      "likeCount": 12500,
      "replyCount": 2100,
      "retweetCount": 3400,
      "viewCount": 1200000,
      "url": "https://x.com/OpenAI/status/1942900000000000000"
    },
    {
      "id": "1942800000000000000",
      "text": "Sora is now available to all ChatGPT Plus and Pro subscribers. Create realistic and imaginative videos from text instructions.",
      "createdAt": "2026-06-30T16:00:00.000Z",
      "likeCount": 9800,
      "replyCount": 1600,
      "retweetCount": 2800,
      "viewCount": 950000,
      "url": "https://x.com/OpenAI/status/1942800000000000000"
    }
  ],
  "cursor": "DAABCgABF8zK9v__-X0"
}
```

--------------------------------

### Fetch Reviews Request

Source: https://fetchlayer.dev/documentation/playstore/endpoints/reviews

Example cURL request to retrieve reviews for a specific app package ID.

```bash
curl -X POST "https://api.fetchlayer.dev/playstore/reviews" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"appIdOrUrl":"com.spotify.music","pages":1,"reviewsPerPage":20,"sortBy":"newest"}'
```

--------------------------------

### Fetch User Profile Details

Source: https://fetchlayer.dev/documentation/twitter/endpoints/user-profile-details

Examples for requesting user profile data using cURL and the official Node.js SDK.

```bash
curl -X POST "https://api.fetchlayer.dev/twitter/user-profile-details" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"handle":"openai"}'
```

```javascript
import { FetchLayer } from '@fetchlayer/twitter';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.userProfileDetails({
  "handle": "openai"
});
```

--------------------------------

### Community Listing Response Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/community.json

A sample JSON response structure for a community post listing request.

```json
{
  "blocked": false,
  "listingType": "community-posts",
  "pageTitle": "Programming",
  "requestedUrl": "https://www.reddit.com/r/programming/top/?t=week",
  "fetchUrl": "https://www.reddit.com/r/programming/top/?t=week",
  "finalUrl": "https://www.reddit.com/r/programming/top/?t=week",
  "responseStatus": 200,
  "subreddit": "programming",
  "subredditPrefixed": "r/programming",
  "sort": "top",
  "time": "week",
  "listingTitle": "Programming",
  "items": [
    {
      "id": "xyz",
      "fullname": "t3_xyz"
```

--------------------------------

### Example Response for Reddit Listing

Source: https://fetchlayer.dev/documentation/reddit/openapi/discover.json

A sample JSON response object for a successful subreddit listing request.

```json
{
  "blocked": false,
  "listingType": "leaderboard",
  "items": [
    {
      "subreddit": "programming",
      "subredditPrefixed": "r/programming",
      "title": "Programming",
      "descriptionText": "Computer Programming",
      "url": "https://www.reddit.com/r/programming/",
      "metaText": "Popular community",
      "nsfw": false
    }
  ],
  "itemCount": 1,
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "old-reddit-html"
}
```

--------------------------------

### Fetch Following List Requests

Source: https://fetchlayer.dev/documentation/twitter/endpoints/following

Examples for requesting the following list using cURL and the FetchLayer Node.js client.

```bash
curl -X POST "https://api.fetchlayer.dev/twitter/following" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"handle":"sama","count":3}'
```

```javascript
import { FetchLayer } from '@fetchlayer/twitter';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.following({
  "handle": "sama",
  "count": 3
});
```

--------------------------------

### Tweet Replies Response Examples

Source: https://fetchlayer.dev/documentation/twitter/endpoints/tweet-replies

Example JSON responses for successful requests and authentication errors.

```json
{
  "replies": [
    {
      "id": "1942941234567890000",
      "text": "Absolutely. I used it to analyze a full Next.js project structure and it caught a race condition I missed.",
      "author": {
        "handle": "reactdev",
        "displayName": "React Dev",
        "isVerified": false
      },
      "createdAt": "2026-07-01T19:05:00.000Z",
      "likeCount": 28,
      "retweetCount": 2,
      "replyCount": 5
    },
    {
      "id": "1942942345678900000",
      "text": "How does it compare to Claude Computer Use for those kinds of tasks?",
      "author": {
        "handle": "ai_researcher",
        "displayName": "AI Researcher",
        "isVerified": false
      },
      "createdAt": "2026-07-01T19:12:00.000Z",
      "likeCount": 12,
      "retweetCount": 0,
      "replyCount": 8
    }
  ],
  "cursor": "DAABCgABF8zK9v__-W9"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Search for an app

Source: https://fetchlayer.dev/documentation/appstore/getting-started

Use this request to find app listings by name and country.

```bash
curl -X POST https://api.fetchlayer.dev/appstore/search \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion","country":"us"}'
```

--------------------------------

### Search Reddit Comments Response Examples

Source: https://fetchlayer.dev/documentation/reddit/endpoints/search-comments

Examples of successful and error response payloads from the API.

```json
{
  "blocked": false,
  "listingType": "comment-search",
  "items": [
    {
      "id": "xyz123",
      "bodyText": "MCP has been a game changer for my workflow.",
      "subreddit": "programming",
      "author": "devuser",
      "score": 342,
      "permalink": "https://www.reddit.com/r/programming/comments/.../comment/...",
      "createdAt": "2026-08-13T03:00:00.000Z",
      "stickied": false
    }
  ],
  "itemCount": 1,
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "new-reddit-html"
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### POST /following

Source: https://fetchlayer.dev/documentation/twitter/endpoints/following

Retrieve accounts followed by a user with basic profile metadata per account.

```APIDOC
## POST /following

### Description
Retrieve accounts followed by a user with basic profile metadata per account.

### Method
POST

### Endpoint
https://api.fetchlayer.dev/twitter/following

### Parameters
#### Request Body
- **handle** (string) - Required - Twitter handle without @.
- **count** (number) - Optional - Number of accounts (max 100). (default: 25)
- **cursor** (string) - Optional - Pagination cursor.

### Request Example
{
  "handle": "sama",
  "count": 3
}

### Response
#### Success Response (200)
- **users** (array) - List of followed users.
- **users[].handle** (string) - User handle.
- **users[].displayName** (string) - Display name.
- **users[].description** (string) - Bio text.
- **users[].isVerified** (boolean) - Verification status.
- **users[].followersCount** (number) - Follower count.
- **users[].avatarUrl** (string) - Profile image URL.
- **cursor** (string) - Pagination cursor.

#### Response Example
{
  "users": [
    {
      "handle": "gdb",
      "displayName": "Greg Brockman",
      "description": "President & Co-Founder @OpenAI.",
      "isVerified": true,
      "followersCount": 1200000,
      "avatarUrl": "https://pbs.twimg.com/profile_images/gdb_normal.jpg"
    }
  ],
  "cursor": "DAABCgABF8zK9v__-Z2"
}
```

--------------------------------

### Fetch Tweet Replies Request Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/content.json

Example request body for retrieving replies to a specific tweet.

```json
{
  "tweetId": "1942939879222220800"
}
```

--------------------------------

### YouTube comments API response examples

Source: https://fetchlayer.dev/documentation/youtube/endpoints/comments

Example JSON responses for successful requests and authentication errors.

```json
[
  {
    "username": "@User123",
    "comment": "Great video!",
    "likes": 42,
    "hasReplies": true,
    "date": "1 day ago"
  }
]
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### Example Request for Explore Endpoint

Source: https://fetchlayer.dev/documentation/reddit/openapi/discover.json

A sample JSON request body used to filter subreddits by a specific topic.

```json
{
  "topic": "technology"
}
```

--------------------------------

### Search Comments Request Example

Source: https://fetchlayer.dev/documentation/reddit/openapi/search.json

Example JSON payload for searching comments with specific sorting and time filters.

```json
{
  "query": "mcp",
  "sort": "top",
  "time": "all",
  "limit": 25
}
```

--------------------------------

### Fetch App Reviews Response

Source: https://fetchlayer.dev/documentation/appstore/endpoints/reviews

Example JSON responses for successful review retrieval and authentication errors.

```json
{
  "reviews": [
    {
      "id": "r123",
      "rating": 5,
      "title": "Great app",
      "body": "Love using this every day!",
      "author": "User123",
      "version": "10.1.0",
      "date": "2026-07-28T12:00:00Z",
      "helpfulCount": 12
    }
  ],
  "pagesFetched": 1
}
```

```json
{
  "error": "Invalid API key"
}
```

--------------------------------

### YouTube Comment Response Example

Source: https://fetchlayer.dev/documentation/youtube/openapi.json

Example JSON payload returned by the API for a successful comment retrieval request.

```json
{
  "username": "@User123",
  "comment": "Great video!",
  "likes": 42,
  "hasReplies": true,
  "date": "1 day ago",
  "nestedReplies": [
    {
      "username": "@ReplyUser",
      "comment": "Agreed!",
      "likes": 5,
      "hasReplies": false,
      "date": "1 day ago"
    }
  ]
}
```

--------------------------------

### User Profile Response Example

Source: https://fetchlayer.dev/documentation/twitter/openapi.json

Represents the default JSON structure for a user profile response containing handle, metadata, and pagination cursor.

```json
"default": {
                    "value": {
                      "users": [
                        {
                          "handle": "gdb",
                          "displayName": "Greg Brockman",
                          "description": "President & Co-Founder @OpenAI.",
                          "isVerified": true,
                          "followersCount": 1200000,
                          "avatarUrl": "https://pbs.twimg.com/profile_images/gdb_normal.jpg"
                        },
                        {
                          "handle": "miramurati",
                          "displayName": "Mira Murati",
                          "description": "CTO @OpenAI.",
                          "isVerified": true,
                          "followersCount": 450000,
                          "avatarUrl": "https://pbs.twimg.com/profile_images/mira_normal.jpg"
                        }
                      ],
                      "cursor": "DAABCgABF8zK9v__-Z2"
                    }
                  }
```

--------------------------------

### Twitter API Content Response Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/content.json

Example JSON payload for a Twitter content response containing a list of replies and a pagination cursor.

```json
{
  "replies": [
    {
      "id": "1942950000000000000",
      "text": "We think this is the most important capability for agents. More to share soon.",
      "inReplyToId": "1942900000000000000",
      "author": {
        "handle": "sama",
        "displayName": "Sam Altman"
      },
      "createdAt": "2026-07-01T15:30:00.000Z",
      "likeCount": 4200
    }
  ],
  "cursor": "DAABCgABF8zK9v__-Y1"
}
```

--------------------------------

### GET /reddit/community-posts

Source: https://fetchlayer.dev/documentation/reddit/endpoints/community-posts

Retrieves a list of posts from a specified subreddit.

```APIDOC
## GET /reddit/community-posts

### Description
Retrieves a feed of posts from a specified subreddit using the FetchLayer API.

### Headers
- **Authorization** (string) - Required - Bearer token — your FetchLayer API key.

### Parameters
#### Query Parameters
- **subreddit** (string) - Required - Subreddit name (without r/).
- **sort** (string) - Optional - Feed sort order: hot, new, top, rising, or controversial. (default: hot)
- **limit** (number) - Optional - Maximum number of posts to return. (default: 25)
- **time** (string) - Optional - Time filter for top and controversial sorts: hour, day, week, month, year, or all.
- **pages** (number) - Optional - Maximum number of feed pages to scrape. (default: 1)
```

--------------------------------

### POST /following

Source: https://fetchlayer.dev/documentation/twitter

Retrieves the list of accounts a user is following.

```APIDOC
## POST /following

### Description
Retrieves the list of accounts a user is following.

### Method
POST

### Endpoint
https://api.fetchlayer.dev/twitter/following
```

--------------------------------

### GET /comments

Source: https://fetchlayer.dev/documentation/youtube/openapi.json

Retrieves comment data for a specific YouTube video.

```APIDOC
## GET /comments

### Description
Retrieves comment details for a specified YouTube video URL.

### Method
GET

### Endpoint
/comments

### Parameters
#### Query Parameters
- **videoUrl** (string) - Required - The URL of the YouTube video.
- **commentId** (string) - Optional - The specific comment ID to retrieve.

### Response
#### Success Response (200)
- **username** (string) - Comment author username (with @).
- **comment** (string) - Full comment text.
- **likes** (number) - Number of likes.
- **hasReplies** (boolean) - Whether this comment has nested replies.
- **date** (string) - Relative date string (e.g. "1 day ago").
- **nestedReplies** (object) - Nested reply comments.

#### Response Example
{
  "username": "@User123",
  "comment": "Great video!",
  "likes": 42,
  "hasReplies": true,
  "date": "1 day ago",
  "nestedReplies": [
    {
      "username": "@ReplyUser",
      "comment": "Agreed!",
      "likes": 5,
      "hasReplies": false,
      "date": "1 day ago"
    }
  ]
}

### Error Handling
- **401**: Invalid or missing Bearer token
```

--------------------------------

### GET /user

Source: https://fetchlayer.dev/documentation/reddit/openapi/user.json

Retrieves a list of posts for a given Reddit username.

```APIDOC
## GET /user

### Description
Fetches posts associated with a specific Reddit username. Returns metadata about the request and a list of items.

### Method
GET

### Endpoint
/user

### Parameters
#### Query Parameters
- **username** (string) - Required - The Reddit username to fetch posts for.
- **limit** (number) - Optional - The maximum number of posts to return.
- **after** (string) - Optional - Pagination cursor.

### Request Example
{
  "username": "spez",
  "limit": 10
}

### Response
#### Success Response (200)
- **blocked** (boolean) - Whether Reddit returned a block or verification page.
- **blockReason** (string|null) - Machine-readable block reason.
- **blockedBodyText** (string|null) - Diagnostic block-page text.
- **pageTitle** (string) - Title of the scraped Reddit page.
- **requestedUrl** (string) - Reddit URL requested.
- **fetchUrl** (string) - Normalized Reddit URL.
- **finalUrl** (string) - Final URL after redirects.
- **responseStatus** (number|null) - HTTP status returned by Reddit.
- **listingType** (string) - Always user-posts for a successful response.
- **username** (string) - Requested Reddit username.
- **items** (array) - List of posts.

#### Response Example
{
  "username": "spez",
  "items": [
    {
      "id": "12345",
      "fullname": "t3_12345",
      "subreddit": "reddit",
      "subredditPrefixed": "r/reddit",
      "author": "spez",
      "title": "Example Post",
      "permalink": "/r/reddit/comments/12345/"
    }
  ]
}
```

--------------------------------

### Tweet Object Example

Source: https://fetchlayer.dev/documentation/twitter/openapi/content.json

Represents the structure of a tweet object returned by the API.

```json
{
  "id": "1942939879222220800",
  "text": "Just tried the new GPT-4o vision features on the OpenAI playground — it correctly described a screenshot of our dashboard in one prompt. Incredible.",
  "author": {
    "handle": "devuser",
    "displayName": "Dev User",
    "isVerified": false,
    "followersCount": 3200
  },
  "createdAt": "2026-07-01T18:42:00.000Z",
  "likeCount": 142,
  "retweetCount": 31,
  "replyCount": 23,
  "quoteCount": 4,
  "viewCount": 8200,
  "url": "https://x.com/devuser/status/1942939879222220800",
  "lang": "en",
  "media": []
}
```
Tokens:
Raw