Ayrshare API अवलोकन - Ayrshare API Documentation

Social Media REST API डेवलपर्स को एक एकीकृत इंटरफ़ेस के माध्यम से कई सोशल नेटवर्क्स तक programmatic पहुँच प्रदान करता है। Ayrshare के social API के माध्यम से, आप विभिन्न प्लेटफ़ॉर्म्स पर सोशल मीडिया गतिविधियों का प्रबंधन कर सकते हैं, जिसमें पोस्ट्स बनाना और हटाना, analytics प्राप्त करना, टिप्पणियों और reviews के साथ जुड़ना, direct messages का प्रबंधन करना, Facebook ads बनाना, और अन्य सोशल मीडिया कार्य शामिल हैं। API वर्तमान में 13 प्रमुख सोशल नेटवर्क्स का समर्थन करता है: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (पहले Twitter), और YouTube। इस API के साथ एकीकरण करके, डेवलपर्स एक साथ इन सभी प्लेटफ़ॉर्म्स पर सोशल मीडिया प्रबंधन कार्यों को स्वचालित कर सकते हैं। API calls की request और response डेटा JSON format में हैं, जो अधिकांश प्रोग्रामिंग भाषाओं में आसान पार्सिंग और प्रोसेसिंग की अनुमति देता है। यदि आप Launch, Business, या Enterprise Plan पर हैं, तो Business Plan Overview, Launch Plan Overview, और /profiles API endpoint देखें।

मुख्य कार्यक्षमता

13 सोशल नेटवर्क्स समर्थित।
अपनी अद्वितीय API Key का उपयोग करके सुरक्षित API access।
कनेक्ट किए गए सोशल मीडिया प्लेटफ़ॉर्म्स पर scheduled posting।
पूर्वनिर्धारित schedules के आधार पर स्वचालित posting।
Reels, Stories, और Spotlight सहित छवि और वीडियो सामग्री के लिए समर्थन।
लिंक किए गए सोशल नेटवर्क्स पर पोस्ट्स हटाएँ।
व्यापक पोस्ट engagement analytics (likes, shares, आदि)।
Social account metrics, जिसमें follower count और demographic डेटा शामिल हैं।
टिप्पणी प्रबंधन: पोस्ट टिप्पणियाँ देखें, जोड़ें, और हटाएँ।
पोस्ट्स में सभी या विशिष्ट URLs के लिए वैकल्पिक link shortening।
Unsplash एकीकरण: विशिष्ट छवियाँ जोड़ें या keywords के आधार पर यादृच्छिक रूप से चुनें।
प्रासंगिक keywords का उपयोग करके स्वचालित hashtag generation विकल्प।
Non-Ayrshare पोस्ट्स सहित post history ट्रैकिंग।
Review प्रबंधन: reviews प्राप्त करें, उनका उत्तर दें, और review responses हटाएँ।
स्वचालित सामग्री posting के लिए RSS feed एकीकरण।
Media library: पोस्ट्स में उपयोग के लिए फ़ोटो और वीडियो अपलोड और स्टोर करें।
Social Post Verification System आपके सोशल अकाउंट्स को सुरक्षित रखने के लिए।

Business Plan और Launch Plan

कई उपयोगकर्ताओं और क्लाइंट्स के प्रबंधन के लिए Business Plan और Launch Plan फ़ीचर्स:

उपयोगकर्ताओं को अपने स्वयं के सोशल मीडिया अकाउंट्स को आपके प्लेटफ़ॉर्म से लिंक करने में सक्षम बनाएँ।
त्वरित account linking के लिए OAuth का उपयोग करके सुरक्षित single sign-on।
API के माध्यम से programmatically user profiles बनाएँ और हटाएँ।
उन्नत user analytics तक पहुँच।
रीयल-टाइम updates के लिए Webhook समर्थन।
समर्थित प्लेटफ़ॉर्म्स में Direct message प्रबंधन।
मौजूदा पोस्ट्स से Facebook ads बनाएँ।

Business Plan के बारे में अधिक जानने के लिए हमसे संपर्क करें।

Ads API

Ads API आपको मौजूदा पोस्ट्स से Facebook ads बनाने की अनुमति देता है।

अधिक लोगों तक पहुँचने के लिए पोस्ट्स को बूस्ट करें।
Ads का प्रबंधन और प्रदर्शन ट्रैक करें।
Ad spend का विश्लेषण करें और campaigns को अनुकूलित करें।

Ads API

Ads API देखें

Messages API

प्रमुख सोशल मीडिया चैनलों में उपयोगकर्ताओं को बातचीत में शामिल करने के लिए एक एकीकृत Messaging API: Facebook, Instagram, और X।

Text, image, और video messages भेजना।
पूरी conversation histories प्राप्त करना।
स्वचालित message responses सेट करना।
प्राप्त messages, message reactions, read receipts के लिए webhooks के माध्यम से रीयल-टाइम updates प्राप्त करना।

यह API कई सोशल मीडिया चैनलों के लिए messaging operations को केंद्रीकृत करके user engagement को सरल बनाता है। अधिक जानें…

Messages API

एकीकृत messaging API देखें

Max Pack

Max Pack add-on के साथ और भी अधिक क्षमताएँ प्राप्त करें:

Max Pack

हमारे Max Pack add-on के साथ AI-संचालित सामग्री निर्माण, उन्नत analytics, और विस्तारित प्लेटफ़ॉर्म समर्थन जैसी उन्नत सुविधाओं को अनलॉक करें।

यदि आप Node.js में निर्माण कर रहे हैं, तो X और Facebook पर पोस्ट्स को कनेक्ट और प्रकाशित करने के तरीके पर यह वीडियो देखें।

यदि आप Node.js का उपयोग करते हैं, तो अपने स्वयं के social API integration को बनाने के लिए social API demo code देखें।

Social API Demo

अपने social API integration को शुरू करने के लिए हमारे Node.js डेमो कोड को देखें

Base URL

Ayrshare API के लिए base URL सभी endpoints के लिए समान है। https://api.ayrshare.com/api

Authorization

Ayrshare HTTP header में पास किए गए Authorization token के माध्यम से API requests को प्रमाणित करता है। कृपया सुनिश्चित करें कि API Key के साथ Bearer भेजा जाए। API Key को Ayrshare Dashboard में अपने Primary Profile पर स्विच करके पाया जा सकता है। यदि आप एक Business या Enterprise उपयोगकर्ता हैं, तो आप कई क्लाइंट्स का प्रबंधन करने के लिए Profile Keys के साथ User Profiles बना सकते हैं। Profile Key का उपयोग आपके requests के header में होता है। User Profiles के लिए आपके requests के header में API Key का भी उपयोग किया जाना चाहिए।

Premium plans को अपने requests के header में केवल API Key का उपयोग करना चाहिए। Business और Enterprise plans को User Profile की ओर से बातचीत करते समय अपने requests के header में Profile Key का उपयोग करना चाहिए।

API Key Format

Authorization: Bearer API_KEY जहाँ API_KEY को अपनी Primary Profile API Key से बदलें, जिसे Ayrshare Dashboard में पाया जा सकता है।

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

Ayrshare dashboard में left navigation panel में पाए जाने वाले API Key पृष्ठ के अंतर्गत अपनी गुप्त API Key प्राप्त करें।उदाहरण के लिए, यदि आपकी API Key 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA हैआपके header में शामिल होना चाहिए:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Profile Key Format

Profile Key का उपयोग किसी User Profile की ओर से बातचीत करने के लिए किया जाता है। यह केवल Business या Enterprise plans के लिए उपलब्ध है। Profile-Key: PROFILE_KEY जहाँ PROFILE_KEY को किसी उपयोगकर्ता की Profile Key से बदलें। User Profile की ओर से बातचीत करने के लिए header में Profile Key शामिल करना आवश्यक है। गुम Primary Profile API Key या header में API Key के स्थान पर Profile Key का उपयोग करने पर एक error होगा। API requests के लिए headers को इस तरह से संरचित किया जा सकता है:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

Ayrshare Dashboard में left navigation panel में Profile Key पृष्ठ के अंतर्गत Profile Key खोजें। User Profile पृष्ठ में उस Profile पर स्विच करें जिसका आप उपयोग करना चाहते हैं। इसके अतिरिक्त, Profile Key Create a User Profile endpoint की response में लौटाई जाती है।फिर आप अपने requests के header में Profile Key का उपयोग कर सकते हैं:उदाहरण के लिए, यदि आपकी Profile Key AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA हैआपके header में API और Profile Key दोनों शामिल होने चाहिए:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

X/Twitter BYO Credentials

31 मार्च, 2026 से, Ayrshare के माध्यम से सभी X/Twitter operations के लिए आपके अपने OAuth 1.0a credentials आवश्यक हैं। OAuth के माध्यम से अपने X account को लिंक करने के बाद, X/Twitter को लक्षित करने वाले किसी भी request के लिए अपने Authorization (और वैकल्पिक Profile-Key) headers के साथ ये 2 headers पास करें:

Header	विवरण
`X-Twitter-OAuth1-Api-Key`	आपकी OAuth 1.0a API Key (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	आपकी OAuth 1.0a API Key Secret (Consumer Secret)

ये headers 31 मार्च, 2026 के बाद आवश्यक हैं। मान्य BYO credentials के बिना X/Twitter endpoints के लिए requests अस्वीकार कर दिए जाएँगे।

एक key pair, हर request के लिए उपयोग किया जाता है। आप प्रति Ayrshare account एक X Developer App बनाते हैं और हर X-लक्षित request पर समान X-Twitter-OAuth1-Api-Key और X-Twitter-OAuth1-Api-Secret मानों का उपयोग करते हैं, भले ही request किस sub-profile (Profile-Key) के लिए हो। आप प्रति ग्राहक या प्रति end-user keys उत्पन्न या rotate नहीं करते।

चरण-दर-चरण निर्देशों, कोड उदाहरणों, और समस्या निवारण के लिए X BYO Key Setup Guide देखें। वही दो headers तब लागू होते हैं जब MCP Server के माध्यम से X/Twitter को चलाया जाता है — Connect & Setup देखें।

Content Type

Content Type को हमेशा Content-Type: "application/json" के रूप में सेट किया जाना चाहिए जब तक कि endpoint विशेष रूप से अन्यथा निर्दिष्ट न करे।

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

Compression

Ayrshare सभी API requests के लिए compression का समर्थन करता है। Compression सक्षम करने के लिए, Accept-Encoding header को deflate, gzip, br पर सेट करें।

  Accept-Encoding: "deflate, gzip, br"

यह /history endpoint जैसे बड़े responses को कॉल करने के लिए अनुशंसित है।

केवल 1024 bytes (1KB) से बड़ी responses संकुचित होती हैं।
उपयोग किए जाने वाले compression का क्रम: पहले Brotli (br), फिर gzip, फिर deflate। Brotli सबसे कुशल compression algorithm है।
Response header में उपयोग किए गए content encoding शामिल हैं। उदाहरण के लिए: content-encoding: br यदि Brotli का उपयोग किया गया था।
Compression के बारे में और compression का उपयोग करने के लाभों के बारे में Ayrshare Blog में अधिक जानें।

Content encoding का उपयोग करके response को ठीक से uncompress करना न भूलें।

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

ID प्रकार

कई प्रकार की IDs लौटाई जाती हैं, जिनका उपयोग विभिन्न endpoints में किया जा सकता है:

Ayrshare Post ID

यह ID Ayrshare द्वारा उत्पन्न होती है और /post endpoint से id field में लौटाई जाती है। यह ID सोशल नेटवर्क्स में पोस्ट पर analytics प्राप्त करना, पोस्ट में टिप्पणियाँ जोड़ना, पोस्ट हटाना आदि आसान बनाती है। यह ID आप सबसे अधिक उपयोग करेंगे। प्रत्येक सोशल नेटवर्क पोस्ट्स और टिप्पणियों को अपनी अद्वितीय ID प्रदान करता है। ये IDs /post या /comments endpoints के postIds field में लौटाई जाती हैं। आप इन IDs का उपयोग, या जो आप सीधे सोशल नेटवर्क्स से प्राप्त करते हैं, डेटा प्राप्त करने के लिए कर सकते हैं, जैसे कि analytics social post ID के साथ।

Ayrshare Comment ID

यह ID Ayrshare द्वारा उत्पन्न होती है और /comments endpoint से id field में लौटाई जाती है। यह ID सोशल नेटवर्क्स में टिप्पणी पर analytics प्राप्त करना, टिप्पणी में उत्तर जोड़ना, टिप्पणी हटाना आदि आसान बनाती है। यह ID आप सबसे अधिक उपयोग करेंगे। यह अक्सर तब उपयोग किया जाता है जब आप Ayrshare के माध्यम से प्रकाशित किसी विशेष टिप्पणी पर विवरण प्राप्त करना चाहते हैं। प्रत्येक सोशल नेटवर्क टिप्पणियों को अपनी अद्वितीय ID प्रदान करता है। ये IDs GET /comments endpoint के commentId field में लौटाई जाती हैं। यह अक्सर तब उपयोग किया जाता है जब आप Ayrshare के बाहर प्रकाशित किसी विशेष टिप्पणी पर विवरण प्राप्त करना चाहते हैं।

Error Codes

Errors standard HTTP status codes के साथ लौटेंगे। अधिक जानकारी के लिए:

HTTP Status Codes

HTTP status codes के बारे में और जानें

विस्तृत Errors प्रत्येक प्रकार की कॉल के लिए विशिष्ट REST API response में हैं। अधिक जानकारी के लिए:

Ayrshare Error Codes

Ayrshare-विशिष्ट error codes के बारे में और जानें

Timestamp Format

Ayrshare विभिन्न समय क्षेत्रों में एक सटीक और स्पष्ट समय संदर्भ के लिए Zulu Time, जिसे UTC (Coordinated Universal Time) या ISO 8601 formatted date string के रूप में भी जाना जाता है, का उपयोग करता है। उदाहरण के लिए, YYYY-MM-DDThh:mm:ssZ format का उपयोग करें और 2026-07-08T12:30:00Z के रूप में भेजें। अधिक उदाहरणों के लिए कृपया utctime देखें। आप अपनी पसंद की प्रोग्रामिंग भाषा में UTC format को अपने स्थानीय समय में परिवर्तित कर सकते हैं। उदाहरण के लिए JavaScript में:

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

आप अपने REST API calls का परीक्षण करने के लिए Postman का उपयोग कर सकते हैं।

Postman

हमारे API के साथ Postman का उपयोग कैसे करें, यह जानें

Random Posts, Images, और Videos

परीक्षण करते समय random पोस्ट्स, छवियाँ, या वीडियो कैसे भेजें, इस पर quick start guide देखें।

Packages

RESTful कॉल को आसान बनाने के लिए हमारे पास Node.js और Python दोनों packages, Bubble.io, Airtable, और Make guides उपलब्ध हैं।

Node NPM Package

हमारे NodeJS package का उपयोग करके एकीकृत करें

Python PyPI Package

हमारे Python package का उपयोग करके एकीकृत करें

Airtable Guide

Airtable के साथ Ayrshare का उपयोग करना सीखें

Bubble Plugin & Guide

Bubble.io के साथ Ayrshare का उपयोग करना सीखें

Make Guide

Make के साथ Ayrshare का उपयोग करना सीखें

Notion Guide

Notion के साथ Ayrshare का उपयोग करना सीखें

FlutterFlow Guide

FlutterFlow के साथ Ayrshare का उपयोग करना सीखें

Retool Guide

Retool के साथ Ayrshare का उपयोग करना सीखें

​मुख्य कार्यक्षमता

​Business Plan और Launch Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​Social API का उपयोग कैसे करें देखें

​Social API डेमो

Social API Demo

​Base URL

​Authorization

​API Key Format

​Profile Key Format

​X/Twitter BYO Credentials

​Content Type

​Compression

​ID प्रकार

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​Error Codes

HTTP Status Codes

Ayrshare Error Codes

​Timestamp Format

​Postman

Postman

​Random Posts, Images, और Videos

​Packages

Node NPM Package

Python PyPI Package

Airtable Guide

Bubble Plugin & Guide

Make Guide

Notion Guide

FlutterFlow Guide

Retool Guide

मुख्य कार्यक्षमता

Business Plan और Launch Plan

Ads API

Messages API

Max Pack

Social API का उपयोग कैसे करें देखें

Social API डेमो

Base URL

Authorization

API Key Format

Profile Key Format

X/Twitter BYO Credentials

Content Type

Compression

ID प्रकार

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

Error Codes

Timestamp Format

Postman

Random Posts, Images, और Videos

Packages