Person Newsfeed API
Get someone's recent social media posts across major platforms
API Endpoint
https://api.nyne.ai/person/newsfeed
What This API Does
Provide any social media profile URL and get back that person's recent posts, updates, and activity. See what they've been sharing, what topics they're discussing, and how their audience is engaging.
Getting Started
Just provide a social media profile URL and receive their recent posts with engagement metrics like likes, comments, and shares.
Quick Example
Authentication
All API requests require authentication using your API key. Include your API key in the Authorization header:
You can obtain your API key from your account dashboard.
Rate Limits
API usage is controlled by rate limiting mechanisms to ensure fair usage and system stability:
- Per Minute: 60 requests
- Per Hour: 1000 requests
- Monthly: Varies by plan
Credit Usage
Credits scale with the number of posts returned: 2 credits per 10 posts (rounded up).
| Posts Returned | Credits Charged |
|---|---|
| 1 - 10 | 2 |
| 11 - 20 | 4 |
| 21 - 50 | 10 |
| 51 - 100 | 20 |
| 101 - 1000 | up to 200 |
Credit Efficiency
Credits are based on actual posts returned, not the requested limit. If no posts are found, no credits are charged. Your account is pre-checked for the worst-case cost before processing begins.
POST /person/newsfeed
Fetch newsfeed data from a social media profile.
POST /person/newsfeed
Parameters
Social media profile URL to fetch newsfeed from
Example: https://linkedin.com/in/username
URL to receive results asynchronously
Example: https://yourapp.com/webhook/newsfeed
Maximum number of the most recent posts to return. Posts are ordered newest first. Min: 1, Max: 1000. Default: 10.
Credit cost scales with results: 2 credits per 10 posts returned (rounded up).
Example: 25
Only return posts published on or after this date. Format: YYYY-MM-DD.
Posts without a parseable date are always included.
Example: 2025-01-01
Supported Platforms
- LinkedIn: Professional posts, articles, and activity
- Twitter/X: Tweets and retweets
- Instagram: Posts and stories (public profiles only)
- GitHub: Repository activity and commits
- Facebook: Public posts and activity
Example Request
Example Response (Callback)
Example Response (Immediate)
GET /person/newsfeed
Check the status of a newsfeed request and retrieve results.
GET /person/newsfeed
Parameters
The request ID returned from the POST request
Example: abc123def456
Example Request
Example Response
Usage Statistics
Usage statistics are now available through the unified usage API at /usage. This endpoint provides comprehensive usage information including credits used, monthly allocation, and breakdown by API type.
Unified Usage API
For detailed usage statistics, please use:
This endpoint shows all your API usage in one place, including newsfeed requests with proper credit counting.
Response Format
All API responses follow a consistent JSON format:
Success Response
Error Response
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
missing_credentials |
401 | API key is missing from request |
invalid_credentials |
401 | API key is invalid or expired |
ip_not_allowed |
403 | Your IP address is not allowed |
subscription_required |
403 | Your subscription does not include newsfeed access |
missing_parameters |
400 | Required parameters are missing |
invalid_url |
400 | Invalid or unsupported social media URL |
invalid_callback_url |
400 | Invalid callback URL format |
invalid_parameter |
400 | Invalid parameter value (e.g., limit out of 1-1000 range, invalid YYYY-MM-DD date format) |
insufficient_credits |
403 | Not enough credits for the requested limit |
rate_limit_exceeded |
429 | Rate limit exceeded |
monthly_limit_exceeded |
429 | Monthly request limit exceeded |
missing_request_id |
400 | Request ID is required for status checks |
request_not_found |
404 | Request ID not found |
internal_error |
500 | Internal server error |
Callbacks
For asynchronous processing, provide a callback_url in your request. We'll send a POST request to your URL when processing is complete.
Callback Request Format
Callback Requirements
- Your endpoint must respond with HTTP 200 OK
- Response time should be under 30 seconds
- We'll retry failed callbacks up to 5 times with exponential backoff
- Include proper error handling in your endpoint
Important Notes
Use Enrichment API for Complete Data
This newsfeed API provides only social media posts and activity. For comprehensive person data including contact information, company details, and newsfeed combined, use the Person Enrichment API instead.
Credit Usage
Newsfeed requests are charged 2 credits per 10 posts returned (rounded up). Use the limit parameter to control how many posts to fetch and the posts_after parameter to filter by date. Default: 10 posts = 2 credits.