JSONPlaceholder API Data Extractor

Extract structured sample data from JSONPlaceholder REST API automatically. Perfect for developers, testers, and educators.

What it does

Retrieves and structures sample data from all JSONPlaceholder endpoints:

• Automated data extraction from 6 endpoints (posts, comments, albums, photos, todos, users)
• Data validation and cleaning for consistent output
• Flexible filtering by user ID or endpoint
• Multiple export formats (JSON, CSV, Excel)

How to use

1. Input: Select which endpoints to extract and configure options
2. Run: Execute the Actor
3. Output: Download data from Dataset in your preferred format

Quick example

Input configuration:

{
  "endpoints": ["posts", "users"],
  "maxItemsPerEndpoint": 10,
  "includeDataValidation": true
}

Output: 20 structured records (10 posts + 10 users) in the Dataset, ready to download as JSON, CSV, or Excel.

Output: 20 structured records (10 posts + 10 users) in the Dataset, ready to download as JSON, CSV, or Excel.

Available endpoints

Endpoint	Items	Description
posts	100	Blog posts with titles and body content
comments	500	User comments on posts
albums	100	Photo albums
photos	5,000	Individual photos with URLs and thumbnails
todos	200	Task items with completion status
users	10	Complete user profiles with contact information

Required fields

• endpoints - Array of endpoints to extract (e.g., ["posts", "users"])

Optional fields

• filterByUserId - Filter data for specific user (1-10)
• maxItemsPerEndpoint - Limit items per endpoint (0 = unlimited, default)
• includeDataValidation - Clean and validate data (default: true)
• includeMetadata - Add extraction timestamps (default: false)
• combineResults - Merge all data with type field (default: false)

Use cases

Frontend testing

{
  "endpoints": ["users", "posts"],
  "maxItemsPerEndpoint": 5
}

Single user data

{
  "endpoints": ["posts", "comments", "todos"],
  "filterByUserId": 1,
  "combineResults": true
}

Educational datasets

{
  "endpoints": ["posts", "comments"],
  "maxItemsPerEndpoint": 10,
  "includeMetadata": true
}

Output format

Posts example:

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident",
  "body": "quia et suscipit..."
}

Users example:

{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "Sincere@april.biz",
  "phone": "1-770-736-8031 x56442",
  "website": "hildegard.org"
}

With metadata (when enabled):

{
  "id": 1,
  "title": "Sample Post",
  "body": "Post content...",
  "_metadata": {
    "extractedAt": "2025-12-28T10:30:00.000Z",
    "dataType": "posts",
    "source": "jsonplaceholder.typicode.com"
  }
}

Features

• ✅ Fast execution - Completes in seconds
• ✅ Data validation - Automatic cleaning and normalization
• ✅ Retry logic - Handles temporary API failures
• ✅ Multiple formats - Export as JSON, CSV, or Excel
• ✅ No authentication - No API keys required
• ✅ Educational - Perfect for learning API integration

Local development

# Install dependencies
npm install

# Run the Actor
apify run

Edit storage/key_value_stores/default/INPUT.json to test different configurations.

Resources

• JSONPlaceholder API
• Apify Documentation
• Actor SDK Reference

---

Built for the Apify 1 Million Challenge | Made with ❤️ for developers