You need to log in to access your API credentials and start using our APIs. Start with your free trial!
Log In & Start Free TrialPerson 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
Try the API Playground
Test the API with our interactive playground to make real requests and see live responses.
Launch Social Profiles PlaygroundOverview
Find all of someone's social media accounts using just their email address or one social profile URL. If you have someone's LinkedIn, this API can find their Twitter, Instagram, YouTube, and other accounts.
What You Get
- LinkedIn: Professional profile URL
- Twitter/X: Twitter handle and profile URL
- Instagram: Instagram profile URL
- YouTube: YouTube channel if they have one
- GitHub: Developer profile URL
- Medium & Substack: Writing/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 Twitter, LinkedIn, YouTube, Instagram, Medium, and Substack. 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 (twitter, linkedin, youtube, instagram, medium, substack) will only appear if a profile URL 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); ?>