Person Social Profiles API
Look up social media profiles for individuals using email addresses, phone numbers, or social media URLs
API Endpoint
https://api.nyne.ai/person/social-profiles
Overview
Find all of someone's social media accounts using just their email address or one social profile URL. If you have one of their profiles, this API can find their accounts across other platforms.
What You Get
- Professional network profiles
- Microblogging and social profiles
- Photo and video sharing profiles
- Video platform channels
- Developer platform profiles
- Publishing and newsletter profiles
How It Works
Input: Provide an email address, phone number, or any social media profile URL
Output: A list of all social media profiles associated with that person
Authentication
All API requests require authentication using your API key and secret. You can authenticate using either HTTP headers (recommended) or query parameters.
X-API-Key: your_api_key_here
X-API-Secret: your_api_secret_here
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
API credits are consumed for social profiles lookup requests:
- Social Profiles Lookup: 5 credits per successful request
Credit Efficiency
Credits are only charged when at least one social profile URL is found. If no profiles are discovered, no credits are charged.
POST /person/social-profiles
Look up social media profiles for a person using email, phone, or social media URL.
POST /person/social-profiles
Parameters
Email address to look up
Example: john.doe@example.com
Phone number to look up
Example: +1-555-123-4567
Social media profile URL (LinkedIn, Twitter, etc.)
Example: https://linkedin.com/in/johndoe
URL to receive results asynchronously
Example: https://yourapp.com/webhook/social-profiles
Request Example
Response Codes
202 Request queued successfully
400 Invalid request parameters
401 Invalid API credentials
429 Rate limit exceeded
Response Example (Queued)
GET /person/social-profiles
Check the status of a social profiles lookup request.
GET /person/social-profiles?request_id=
Parameters
The request ID returned from the lookup call
Example: abc123def456...
Request Example
Response Codes
200 Status retrieved successfully
400 Invalid request parameters
401 Invalid API credentials
404 Request ID not found
Response Example (Completed)
Response Example (Processing)
Response Format
All API responses follow a consistent JSON format:
Social Profiles Structure
Important: The API searches for profiles across all supported social platforms. Only profiles that are found will be included in the response. If no profiles are found, the social_profiles object will be empty.
- Each platform key will only appear in the response if a matching profile was found
- Each platform object contains a
urlfield with the profile URL - Credits are only charged when at least one social profile URL is found
Success Response
Error Response
Error Codes
| HTTP Code | Error Code | Description |
|---|---|---|
| 400 | missing_parameters | At least one of email, phone, or social_media_url is required |
| 400 | invalid_email | Invalid email format |
| 400 | invalid_phone | Invalid phone number format |
| 400 | invalid_url | Invalid social media URL format |
| 401 | invalid_credentials | API key or secret is incorrect |
| 404 | request_not_found | Request ID not found (for status checks) |
| 429 | rate_limit_exceeded | Rate limit exceeded |
| 500 | internal_error | Internal server error |
curl -X POST https://api.nyne.ai/person/social-profiles \ -H "X-API-Key: your_api_key_here" \ -H "X-API-Secret: your_api_secret_here" \ -H "Content-Type: application/json" \ -d '{ "email": "john.doe@example.com" }'import requests import json url = "https://api.nyne.ai/person/social-profiles" headers = { "X-API-Key": "your_api_key_here", "X-API-Secret": "your_api_secret_here", "Content-Type": "application/json" } data = { "email": "john.doe@example.com" } response = requests.post(url, headers=headers, json=data) result = response.json() print(json.dumps(result, indent=2))const url = "https://api.nyne.ai/person/social-profiles"; const headers = { "X-API-Key": "your_api_key_here", "X-API-Secret": "your_api_secret_here", "Content-Type": "application/json" }; const data = { email: "john.doe@example.com" }; fetch(url, { method: "POST", headers: headers, body: JSON.stringify(data) }) .then(response => response.json()) .then(result => console.log(result)) .catch(error => console.error("Error:", error));<?php $url = "https://api.nyne.ai/person/social-profiles"; $headers = [ "X-API-Key: your_api_key_here", "X-API-Secret: your_api_secret_here", "Content-Type: application/json" ]; $data = [ "email" => "john.doe@example.com" ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $result = json_decode($response, true); curl_close($ch); echo json_encode($result, JSON_PRETTY_PRINT); ?>