Please log in to access your API credentials and start using our APIs. Log In & Start Free Trial
Interactive Playground — test this API with real requests and see live responses. Launch Playground

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.

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 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 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