मुख्य सामग्री पर जाएं
GET
Primary profile से जुड़े सभी profiles प्राप्त करें। Primary Profile परिणामों में नहीं लौटाया जाता। सुरक्षा के लिए, Profile Keys इस GET कॉल के माध्यम से नहीं लौटाई जाती हैं। अधिक जानकारी के लिए कृपया यहाँ देखें।

Header Parameters

Query Parameters

title
string
URL encoded शीर्षक से जुड़े केवल profile को लौटाएँ।
refId
string
दिए गए refId से जुड़े केवल profile को लौटाएँ। refId profile निर्माण के दौरान या /user endpoint से लौटाया गया था।
hasActiveSocialAccounts
boolean
डिफ़ॉल्ट:false
यदि true तो केवल उन profiles को लौटाएँ जिनके पास कम से कम एक कनेक्टेड social खाता है (activeSocialAccounts की लंबाई शून्य से अधिक)। यदि false तो केवल शून्य कनेक्टेड social खातों वाले profiles को लौटाएँ (activeSocialAccounts की लंबाई शून्य है)।
includesActiveSocialAccounts
array
profiles को फ़िल्टर करें ताकि वे शामिल हों जिनके activeSocialAccounts में includesActiveSocialAccounts सूची में निर्दिष्ट सभी social media प्लेटफ़ॉर्म हैं। Profiles के activeSocialAccounts में includesActiveSocialAccounts में सूचीबद्ध के अलावा अतिरिक्त प्लेटफ़ॉर्म हो सकते हैं और फिर भी filter परिणामों में शामिल किए जाते हैं।मान: bluesky, facebook, gmb, instagram, linkedin, pinterest, reddit, snapchat, telegram, threads, tiktok, twitter, youtube
isByokLinked
boolean
BYOK (Bring Your Own Key) migration स्थिति द्वारा profiles को फ़िल्टर करें। यदि true, तो केवल उन profiles को लौटाएँ जिन्होंने BYOK migration पूरा किया है। यदि false, तो केवल उन profiles को लौटाएँ जिनके पास BYOK-eligible प्लेटफ़ॉर्म कनेक्टेड है लेकिन अभी तक migrate नहीं हुए हैं। BYOK-eligible प्लेटफ़ॉर्म के बिना profiles इस filter के सेट होने पर बाहर रखे जाते हैं। जब omitted होता है, तो BYOK स्थिति की परवाह किए बिना सभी profiles लौटाए जाते हैं। वर्तमान में X/Twitter BYOK पर लागू होता है।
actionLog
boolean
डिफ़ॉल्ट:false
पिछले 60 दिनों के लिए User Profile create और delete action log इतिहास और पिछले 60 दिनों के लिए billing के लिए उपयोग की गई सक्रिय user गणना लौटाएँ। नोट:
  • Action Log: March 2025 से पहले के action log इतिहास के लिए Title और tags नहीं लौटाए जाएँगे।
  • User Profile Report: समय अवधि आपकी billing अवधि के अनुरूप नहीं हो सकती है। उदाहरण के लिए, आपकी billing अवधि महीने की 10 तारीख को शुरू और समाप्त हो सकती है। कृपया billing अवधि और अन्य विवरण के लिए अपने invoices देखें।
आप actionLog को दिनों की संख्या पर सेट करके एक अलग समय अवधि निर्दिष्ट कर सकते हैं। उदाहरण के लिए, actionLog=10 query parameter पिछले 10 दिनों के लिए action log और पिछले 10 दिनों के लिए रिपोर्ट की गई सक्रिय user गणना लौटाएगा। अनुमत समय अवधि 1 दिन से 365 दिन है।
limit
number
डिफ़ॉल्ट:5000
लौटाए गए profiles की संख्या सीमित करें। Default और अधिकतम 5000 है।
cursor
string
यदि लौटाने के लिए अतिरिक्त profiles हैं और hasMore फ़्लैग true है, तो nextCursor प्रतिक्रिया में लौटाया जाएगा। Profiles के अगले सेट को लौटाने के लिए इस cursor को cursor query parameter पर पास करें।
include
string | array
समस्या निवारण के लिए विस्तारित profile डेटा लौटाएँ। refId parameter (एकल profile lookup) आवश्यक है।मान (comma-separated string या array): suspension, socialHealth, linkingErrors, activity, quota, unlinkHistory, actionLog
  • suspension - isSuspended, reason, suspendedAt, unsuspendAt, suspensionCount
  • socialHealth - प्रति-प्लेटफ़ॉर्म: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAt
  • linkingErrors - प्रति-प्लेटफ़ॉर्म: code, message, details, createdAt
  • activity - lastApiCall, lastPost timestamps
  • quota - used, limit
  • unlinkHistory - अंतिम unlink: platform, source (user/system), details, createdAt
  • actionLog - Profile action इतिहास (create/update/delete)