Please Log In

You need to log in to access your API credentials and start using our APIs. Start with your free trial!

Log In & Start Free Trial

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

Try the API Playground

Test the API with our interactive playground to make real requests and see live responses.

Launch Social Profiles Playground

Overview

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.

Header Authentication (Recommended)
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 (string, optional)
Email address to look up
Example: john.doe@example.com
phone (string, optional)
Phone number to look up
Example: +1-555-123-4567
social_media_url (string, optional)
Social media profile URL (LinkedIn, Twitter, etc.)
Example: https://linkedin.com/in/johndoe
callback_url (string, optional)
URL to receive results asynchronously
Example: https://yourapp.com/webhook/social-profiles
Required: At least one of email, phone, or social_media_url must be provided.

Request Example

{ "email": "john.doe@example.com" }

Response Codes

202 Request queued successfully

400 Invalid request parameters

401 Invalid API credentials

429 Rate limit exceeded

Response Example (Queued)

{ "success": true, "data": { "request_id": "abc123def456...", "status": "queued", "message": "Social profiles lookup request queued. Use GET /person/social-profiles?request_id=... to check status." }, "timestamp": "2025-01-15T10:30:00Z" }

GET /person/social-profiles

Check the status of a social profiles lookup request.

GET /person/social-profiles?request_id=

Parameters

request_id (string, required)
The request ID returned from the lookup call
Example: abc123def456...

Request Example

GET /person/social-profiles?request_id=abc123def456...

Response Codes

200 Status retrieved successfully

400 Invalid request parameters

401 Invalid API credentials

404 Request ID not found

Response Example (Completed)

{ "success": true, "data": { "request_id": "abc123def456...", "status": "completed", "social_profiles": { "twitter": { "url": "https://twitter.com/johndoe" }, "linkedin": { "url": "https://www.linkedin.com/in/johndoe" }, "youtube": { "url": "https://youtube.com/@johndoe" } } }, "timestamp": "2025-01-15T10:30:05Z" }

Response Example (Processing)

{ "success": true, "data": { "request_id": "abc123def456...", "status": "processing", "message": "Request is still being processed. Please check again in a few moments." }, "timestamp": "2025-01-15T10:30:02Z" }

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 url field with the profile URL
  • Credits are only charged when at least one social profile URL is found

Success Response

{ "success": true, "data": { "request_id": "abc123...", "status": "completed", "social_profiles": { "twitter": { "url": "https://twitter.com/johndoe" }, "linkedin": { "url": "https://www.linkedin.com/in/johndoe" } } }, "timestamp": "2025-01-15T10:30:00Z" }

Error Response

{ "success": false, "error": { "code": "error_code", "message": "Error message" }, "timestamp": "2025-01-15T10:30:00Z" }

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