{ "action": "ads", "status": "error", "code": 400, "message": "The ad is not found or not authorized."}
احصل على أداء إعلاناتك على Instagram مباشرةً، بصف واحد لكل يوم، لحملاتك أو مجموعات إعلاناتك أو إعلاناتك.
اختر المقاييس التي تريدها، وقسّمها حسب العمر أو الجنس أو الدولة أو موضع الظهور، وتصفّح النطاقات الزمنية الطويلة صفحةً تلو الأخرى.
تُقرأ الأرقام من Meta لحظة استدعائك، وليس من نسخة تُحدَّث كل ليلة.
استخدم السجل للاطلاع على سجل الإنفاق اليومي. واستخدم الرؤى لإعداد التقارير والتحليل.
جميع القيم النقدية بعملة حساب الإعلانات، وتُعاد في الحقل currency في كل صف.
يجب أن تكون الحملات قد أُنشئت عبر Ayrshare لهذا الملف الشخصي، ويجب أن تكون مجموعات الإعلانات ضمن حملة كهذه. يُرفض الإعلان الذي أُنشئ عبر
Ayrshare لملف شخصي آخر. أما معرّفات الإعلانات الأخرى فتُقرأ باستخدام حساب Meta المرتبط بهذا الملف الشخصي،
لذا لا تُعيد Meta إلا الإعلانات التي يستطيع ذلك الحساب رؤيتها.
يغطي الطلب الواحد حساب إعلانات واحدًا. تُعيد المعرّفات التابعة لعدة حسابات إعلانات الرمز 101، وكذلك
عدة معرّفات إعلانات لا يملك Ayrshare سجلًا لها. اطلب هذه المعرّفات واحدًا تلو الآخر.
معاملات الترويسة
معاملات الاستعلام
string
مطلوب
ما يُبلغ عنه كل صف: campaign أو adSet أو ad.
string
معرّفات الحملات أو مجموعات الإعلانات أو الإعلانات مفصولة بفواصل، بحد أقصى 50. مطلوب مع level=campaign وlevel=adSet.مع level=ad، يمكنك حذف ids وإرسال accountId بدلًا منه. يُعدّ هذا تقريرًا عن الإعلانات
التي أنشأتها عبر Ayrshare لهذا الملف الشخصي في حساب الإعلانات ذلك، وليس عن كل إعلان فيه. ويعمل
ذلك مع ما يصل إلى 50 إعلانًا من هذا النوع. لأكثر من ذلك، أرسل معرّفاتها، أو أعدّ التقرير حسب الحملة. وإذا لم يُعثر على أي إعلان، يكون
التقرير فارغًا.
string
معرّف حساب الإعلانات، مع البادئة act_ أو بدونها (1234567890 أو act_1234567890).مطلوب مع level=ad عند حذف ids.
string
المقاييس المطلوب إرجاعها مفصولة بفواصل. احذفه للحصول عليها جميعًا. راجع المقاييس.
string
التقسيمات مفصولة بفواصل: age وgender وcountry وplacement. يصبح لكل يوم عندئذٍ صف واحد لكل
قيمة، أو لكل تركيبة مع age,gender. أرسل تقسيمًا واحدًا في كل مرة، أو age,gender؛ إذ ترفض Meta
التركيبات الأخرى (مثل age,country)، لذا تُعيد الرمز 101.
string
افتراضي:"قبل 30 يومًا"
اليوم الأول، بصيغة YYYY-MM-DD. يمكن أن يعود إلى ما يصل إلى 37 شهرًا مضت.
string
افتراضي:"اليوم"
اليوم الأخير، بصيغة YYYY-MM-DD.
string
قيمة meta.pagination.next من الاستجابة السابقة، للحصول على الصفحة التالية.
المقاييس
المقياس
النوع
المعنى
spend
number
المبلغ المُنفَق
impressions
number
عدد مرات عرض الإعلان
reach
number
الأشخاص الذين شاهدوا الإعلان مرة واحدة على الأقل
clicks
number
النقرات
cpm
number أو null
التكلفة لكل 1,000 ظهور
cpc
number أو null
التكلفة لكل نقرة. null في يوم بلا نقرات
ctr
number أو null
نسبة النقر إلى الظهور، بالنسبة المئوية
actions
array
كل نوع إجراء أحصته Meta، مع عدده
conversionValue
number
القيمة الإجمالية لعمليات الشراء
يُبلغ Instagram عن كل مقياس في هذا الجدول. باستثناء واحد: لا تُبلغ Meta عن reach في تقرير يتضمن
breakdowns ويبدأ قبل أكثر من 13 شهرًا، لذا يُحذف reach من تلك الصفوف. وعلى الشبكات التي لا تُبلغ عن مقياس ما، يُحذف ذلك المقياس
من الصفوف بدلًا من إرجاعه بالقيمة 0، ويُعيد طلبه الرمز 101.
تحتسب Meta بعض الإجراءات ضمن أكثر من نوع، لذا لا تجمع قيم actions معًا. على
سبيل المثال، يتضمن omni_purchase بالفعل purchase. أما conversionValue فيحتسب كل عملية شراء مرة واحدة.
ترقيم الصفحات
تُعيد كل استجابة ما يصل إلى 500 صف. إذا كان هناك المزيد، تكون قيمة meta.pagination.hasMore هي true وتُعيَّن قيمة meta.pagination.next. أرسل الطلب نفسه
مرة أخرى مع تعيين next إلى تلك القيمة للحصول على الصفحة التالية. في الصفحة الأخيرة، تكون قيمة hasMore هي false ولا توجد next. تعمل قيمة next
فقط مع المعلمات التي جاءت منها: مع معلمات مختلفة يُعيد الطلب code: 101.
الأخطاء
الرمز
متى
101
معامل مفقود أو غير صحيح، أو تقسيم أو مقياس غير مدعوم، أو كون startDate أقدم من 37 شهرًا، أو إرسال أكثر من 50 معرّفًا، أو انتماء المعرّفات إلى أكثر من حساب إعلانات واحد، أو رفض Meta لتركيبة التقسيمات
400
حملة أو مجموعة إعلانات أو إعلان لا يخصّك، أو accountId ليس حساب الإعلانات المسجّل لدى Ayrshare للمعرّفات التي أرسلتها. بالنسبة لمجموعة الإعلانات، يجب أيضًا أن يكون accountId هو حساب الإعلانات الذي تُبلغ عنه Meta لها. بالنسبة للإعلان الذي لا يملك Ayrshare سجلًا له، لا يُتحقق من accountId ويُقرأ الإعلان بمفرده
370
تعذّر على Meta إرجاع الرؤى. حاول مرة أخرى
curl \-H "Authorization: Bearer API_KEY" \-X GET "https://api.ayrshare.com/api/ads/instagram/insights?level=campaign&ids=120200000000000001&startDate=2026-09-01&endDate=2026-09-02"
{ "action": "ads", "status": "error", "code": 400, "message": "The ad is not found or not authorized."}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ayrshare Docs","colors":{"primary":"#2266C2","light":"#4985D8","dark":"#1A4E9A"},"logo":{"light":"https://mintcdn.com/ayrshare-docs/7bWzjvNjeuvs-M3N/images/logos/ayrshare-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=7bWzjvNjeuvs-M3N\u0026q=85\u0026s=8d23367f493d06599eecbbfa2b6325cf","dark":"https://mintcdn.com/ayrshare-docs/7bWzjvNjeuvs-M3N/images/logos/ayrshare-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=7bWzjvNjeuvs-M3N\u0026q=85\u0026s=77590acef2781d2fec9a1b14b6e09b73","href":"https://www.ayrshare.com/docs"},"favicon":"https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/logos/icon-docs.png?fit=max\u0026auto=format\u0026n=dKBti0xVDJrOZ19f\u0026q=85\u0026s=9704762afaad78a9cfdd90a20cb1d253","api":{"playground":{"display":"simple"},"examples":{"languages":["bash","javascript","python","php","go","java"]},"mdx":{"auth":{"method":"bearer"},"server":"https://api.ayrshare.com/api"}},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://www.ayrshare.com/blog","label":"Blog"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.ayrshare.com"}},"footer":{"socials":{"github":"https://github.com/ayrshare","x":"https://x.com/ayrshare","bluesky":"https://bsky.app/profile/ayrshare.com","facebook":"https://www.facebook.com/Ayrshare","linkedin":"https://www.linkedin.com/company/ayrshare","youtube":"https://www.youtube.com/@ayrshare"}},"seo":{"indexing":"navigable"},"styling":{"codeblocks":"system","latex":true},"integrations":{"gtm":{"tagId":"GTM-P23WG8W"},"plausible":{"domain":"docs.ayrshare.com"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","cursor","vscode"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"cn","hidden":true,"href":"cn/introduction"},{"language":"zh","hidden":true,"href":"zh/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"},{"language":"fr","href":"fr/introduction"},{"language":"de","href":"de/introduction"},{"language":"vi","href":"vi/introduction"},{"language":"ja","href":"ja/introduction"},{"language":"uk","href":"uk/introduction"},{"language":"hi","href":"hi/introduction"},{"language":"ar","href":"ar/introduction"},{"language":"zh-Hans","href":"zh-Hans/introduction"},{"language":"zh-Hant","href":"zh-Hant/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ayrshare-docs","hasAudioNarration":false,"actualSubdomain":"ayrshare-docs","customDomains":["www.ayrshare.com"],"gitSource":{"type":"github","owner":"ayrshare","repo":"ayrshare_3","deployBranch":"docs-prod","contentDirectory":"apps/mintlify","isPrivate":true,"mountPath":"","label":"","_id":"6aec8a4b6de9d64b11a45855"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00708ecba301bc9879ce2a","clientVersion":"0.0.4263","searchFilterCounts":[{"language":"en","tag":"Documentation","count":248},{"language":"ar","tag":"Documentation","count":248},{"language":"de","tag":"Documentation","count":248},{"language":"es","tag":"Documentation","count":248},{"language":"fr","tag":"Documentation","count":248},{"language":"hi","tag":"Documentation","count":248},{"language":"ja","tag":"Documentation","count":248},{"language":"pt-BR","tag":"Documentation","count":248},{"language":"uk","tag":"Documentation","count":248},{"language":"vi","tag":"Documentation","count":248},{"language":"zh-Hans","tag":"Documentation","count":248},{"language":"zh-Hant","tag":"Documentation","count":248},{"language":"en","tag":"API Endpoints","count":170},{"language":"ar","tag":"API Endpoints","count":170},{"language":"de","tag":"API Endpoints","count":170},{"language":"es","tag":"API Endpoints","count":170},{"language":"fr","tag":"API Endpoints","count":170},{"language":"hi","tag":"API Endpoints","count":170},{"language":"ja","tag":"API Endpoints","count":170},{"language":"pt-BR","tag":"API Endpoints","count":170},{"language":"uk","tag":"API Endpoints","count":170},{"language":"vi","tag":"API Endpoints","count":170},{"language":"zh-Hans","tag":"API Endpoints","count":170},{"language":"zh-Hant","tag":"API Endpoints","count":170},{"language":"en","tag":"Help Center","count":126},{"language":"ar","tag":"Help Center","count":126},{"language":"de","tag":"Help Center","count":126},{"language":"es","tag":"Help Center","count":126},{"language":"fr","tag":"Help Center","count":126},{"language":"hi","tag":"Help Center","count":126},{"language":"ja","tag":"Help Center","count":126},{"language":"pt-BR","tag":"Help Center","count":126},{"language":"uk","tag":"Help Center","count":126},{"language":"vi","tag":"Help Center","count":126},{"language":"zh-Hans","tag":"Help Center","count":126},{"language":"zh-Hant","tag":"Help Center","count":126},{"language":"en","tag":"Additional","count":40},{"language":"en","tag":"Technical Support","count":40},{"language":"ar","tag":"Additional","count":40},{"language":"ar","tag":"Technical Support","count":40},{"language":"de","tag":"Additional","count":40},{"language":"de","tag":"Technical Support","count":40},{"language":"es","tag":"Additional","count":40},{"language":"es","tag":"Technical Support","count":40},{"language":"fr","tag":"Additional","count":40},{"language":"fr","tag":"Technical Support","count":40},{"language":"hi","tag":"Additional","count":40},{"language":"hi","tag":"Technical Support","count":40},{"language":"ja","tag":"Additional","count":40},{"language":"ja","tag":"Technical Support","count":40},{"language":"pt-BR","tag":"Additional","count":40},{"language":"pt-BR","tag":"Technical Support","count":40},{"language":"uk","tag":"Additional","count":40},{"language":"uk","tag":"Technical Support","count":40},{"language":"vi","tag":"Additional","count":40},{"language":"vi","tag":"Technical Support","count":40},{"language":"zh-Hans","tag":"Additional","count":40},{"language":"zh-Hans","tag":"Technical Support","count":40},{"language":"zh-Hant","tag":"Additional","count":40},{"language":"zh-Hant","tag":"Technical Support","count":40},{"language":"en","tag":"Ads","count":30},{"language":"ar","tag":"Ads","count":30},{"language":"de","tag":"Ads","count":30},{"language":"es","tag":"Ads","count":30},{"language":"fr","tag":"Ads","count":30},{"language":"hi","tag":"Ads","count":30},{"language":"ja","tag":"Ads","count":30},{"language":"pt-BR","tag":"Ads","count":30},{"language":"uk","tag":"Ads","count":30},{"language":"vi","tag":"Ads","count":30},{"language":"zh-Hans","tag":"Ads","count":30},{"language":"zh-Hant","tag":"Ads","count":30},{"language":"en","tag":"Post","count":22},{"language":"ar","tag":"Post","count":22},{"language":"de","tag":"Post","count":22},{"language":"es","tag":"Post","count":22},{"language":"fr","tag":"Post","count":22},{"language":"hi","tag":"Post","count":22},{"language":"ja","tag":"Post","count":22},{"language":"pt-BR","tag":"Post","count":22},{"language":"uk","tag":"Post","count":22},{"language":"vi","tag":"Post","count":22},{"language":"zh-Hans","tag":"Post","count":22},{"language":"zh-Hant","tag":"Post","count":22},{"language":"en","tag":"Dashboard","count":21},{"language":"ar","tag":"Dashboard","count":21},{"language":"de","tag":"Dashboard","count":21},{"language":"es","tag":"Dashboard","count":21},{"language":"fr","tag":"Dashboard","count":21},{"language":"hi","tag":"Dashboard","count":21},{"language":"ja","tag":"Dashboard","count":21},{"language":"pt-BR","tag":"Dashboard","count":21},{"language":"uk","tag":"Dashboard","count":21},{"language":"vi","tag":"Dashboard","count":21},{"language":"zh-Hans","tag":"Dashboard","count":21},{"language":"zh-Hant","tag":"Dashboard","count":21},{"language":"en","tag":"Product","count":16},{"language":"ar","tag":"Product","count":16},{"language":"de","tag":"Product","count":16},{"language":"es","tag":"Product","count":16},{"language":"fr","tag":"Product","count":16},{"language":"hi","tag":"Product","count":16},{"language":"ja","tag":"Product","count":16},{"language":"pt-BR","tag":"Product","count":16},{"language":"uk","tag":"Product","count":16},{"language":"vi","tag":"Product","count":16},{"language":"zh-Hans","tag":"Product","count":16},{"language":"zh-Hant","tag":"Product","count":16},{"language":"en","tag":"Connect Social Accounts","count":15},{"language":"ar","tag":"Connect Social Accounts","count":15},{"language":"de","tag":"Connect Social Accounts","count":15},{"language":"es","tag":"Connect Social Accounts","count":15},{"language":"fr","tag":"Connect Social Accounts","count":15},{"language":"hi","tag":"Connect Social Accounts","count":15},{"language":"ja","tag":"Connect Social Accounts","count":15},{"language":"pt-BR","tag":"Connect Social Accounts","count":15},{"language":"uk","tag":"Connect Social Accounts","count":15},{"language":"vi","tag":"Connect Social Accounts","count":15},{"language":"zh-Hans","tag":"Connect Social Accounts","count":15},{"language":"zh-Hant","tag":"Connect Social Accounts","count":15}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".center{display:block;margin-left:auto;margin-right:auto;max-width:100%;height:auto}.welcome-banner{margin-left:auto;margin-right:auto;max-width:100%;height:auto;border-radius:12px}.custom-bullets{padding-left:0}.custom-bullets li{position:relative;padding-left:1.5em;margin-bottom:0.75em;list-style-type:none;line-height:1.4}.custom-bullets li::before{content:\"\\2022\";color:#2266c2;position:absolute;left:0.5em;top:0}.custom-bullets li:last-child{margin-bottom:0}.custom-bullets li>*{margin-top:0;margin-bottom:0}ul ul{margin-left:20px}.custom-bullets li::after,.custom-bullets li::before{border:none!important;background:none!important}.button{background-color:#2266c2;color:#fff;padding:16px 24px;border-radius:8px;border:none;transition-duration:0.2s;margin-top:100px}.button:hover{background-color:#133e76;color:white}.button2{background-color:#fff;color:#2266c2;padding:16px 24px;border-radius:8px;border:1px solid #2266c2;transition-duration:0.2s}.button2:hover{background-color:#133e76;color:white}.video-container{width:100%;max-width:560px;margin:0 auto}.video-container iframe{width:100%;height:auto;aspect-ratio:16 / 9}.plan-tag-light{font-family:\"JetBrains Mono\", monospace;display:inline-block;padding:2px 6px;border-radius:4px;font-size:12px;color:#ffffff;background-color:#16171b;margin-right:10px}.plan-tag-dark{font-family:\"JetBrains Mono\", monospace;display:inline-block;padding:2px 6px;border-radius:4px;font-size:12px;color:#3f4144;background-color:#b7b9bb;margin-right:10px}@media (min-width: 768px){.video-container{display:flex;justify-content:center;align-items:center}}code{font-size:0.96em;line-height:1.7em}"}]}
{"page":{"pagePath":"ar/apis/ads/instagram/get-ad-insights","slug":"/ar/apis/ads/instagram/get-ad-insights","pageMetadata":{"title":"الرؤى","description":"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.","api":"GET /ads/instagram/insights","href":"/ar/apis/ads/instagram/get-ad-insights"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const PlansAvailable=({plans=[],maxPackRequired})=>{const{Note}=_provideComponents()||{};if(!Note)_missingMdxReference(`Note`,true);let displayPlans=plans;if(plans\u0026\u0026plans.length===1){const lowerCasePlan=plans[0].toLowerCase();if(lowerCasePlan===`business`){displayPlans=[`Launch`,`Business`,`Enterprise`]}else if(lowerCasePlan===`premium`){displayPlans=[`Premium`,`Launch`,`Business`,`Enterprise`]}}return _jsxs(Note,{children:[`Available on `,displayPlans.length===1?`the `:``,displayPlans.join(`, `).replace(/\\b\\w/g,l=>l.toUpperCase()),` `,displayPlans.length>1?`plans`:`plan`,`.`,maxPackRequired\u0026\u0026_jsx(`span`,{onClick:()=>window.open(`https://www.ayrshare.com/docs/additional/maxpack`,`_self`),className:`mint-flex mint-items-center mint-mt-2 mint-cursor-pointer`,children:_jsx(`span`,{className:`mint-px-1.5 mint-py-0.5 mint-rounded mint-text-sm`,style:{backgroundColor:`#C264B6`,color:`white`,fontSize:`12px`},children:`Max Pack required`})})]})};const HeaderAPI=({noProfileKey,profileKeyRequired})=>{const _components={a:`a`,..._provideComponents()},{ParamField}=_components;if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsxs(ParamField,{header:`Authorization`,type:`string`,required:true,children:[_jsx(_components.a,{href:`/apis/overview#authorization`,children:`API Key`}),` of the Primary Profile.`,_jsx(`br`,{}),_jsx(`br`,{}),`Format: `,_jsx(`code`,{children:`Authorization: Bearer API_KEY`})]}),!noProfileKey\u0026\u0026(profileKeyRequired?_jsxs(ParamField,{header:`Profile-Key`,type:`string`,required:true,children:[_jsx(_components.a,{href:`/apis/overview#profile-key-format`,children:`Profile Key`}),` of a User Profile.`,_jsx(`br`,{}),_jsx(`br`,{}),`Format: `,_jsx(`code`,{children:`Profile-Key: PROFILE_KEY`})]}):_jsxs(ParamField,{header:`Profile-Key`,type:`string`,children:[_jsx(_components.a,{href:`/apis/overview#profile-key-format`,children:`Profile Key`}),` of a User Profile.`,_jsx(`br`,{}),_jsx(`br`,{}),`Format: `,_jsx(`code`,{children:`Profile-Key: PROFILE_KEY`})]}))]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,ParamField,Table,_MdxComponentBoundary}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_MdxComponentBoundary,{name:`PlansAvailable`,children:_jsx(PlansAvailable,{plans:[`premium`],maxPackRequired:false})}),`\n`,_jsx(_components.p,{children:`احصل على أداء إعلاناتك على Instagram مباشرةً، بصف واحد لكل يوم، لحملاتك أو مجموعات إعلاناتك أو إعلاناتك.\nاختر المقاييس التي تريدها، وقسّمها حسب العمر أو الجنس أو الدولة أو موضع الظهور، وتصفّح النطاقات الزمنية الطويلة صفحةً تلو الأخرى.`}),`\n`,_jsxs(`ul`,{className:`custom-bullets`,children:[_jsx(`li`,{children:`تُقرأ الأرقام من Meta لحظة استدعائك، وليس من نسخة تُحدَّث كل ليلة.`}),_jsx(`li`,{children:_jsxs(_components.p,{children:[`استخدم `,_jsx(_components.a,{href:`/apis/ads/instagram/get-ad-history`,children:`السجل`}),` للاطلاع على سجل الإنفاق اليومي. واستخدم الرؤى لإعداد التقارير والتحليل.`]})}),_jsxs(`li`,{children:[`جميع القيم النقدية بعملة حساب الإعلانات، وتُعاد في الحقل `,_jsx(_components.code,{children:`currency`}),` في كل صف.`]}),_jsx(`li`,{children:_jsx(_components.p,{children:`يجب أن تكون الحملات قد أُنشئت عبر Ayrshare لهذا الملف الشخصي، ويجب أن تكون مجموعات الإعلانات ضمن حملة كهذه. يُرفض الإعلان الذي أُنشئ عبر\nAyrshare لملف شخصي آخر. أما معرّفات الإعلانات الأخرى فتُقرأ باستخدام حساب Meta المرتبط بهذا الملف الشخصي،\nلذا لا تُعيد Meta إلا الإعلانات التي يستطيع ذلك الحساب رؤيتها.`})}),_jsx(`li`,{children:_jsxs(_components.p,{children:[`يغطي الطلب الواحد حساب إعلانات واحدًا. تُعيد المعرّفات التابعة لعدة حسابات إعلانات الرمز `,_jsx(_components.code,{children:`101`}),`، وكذلك\nعدة معرّفات إعلانات لا يملك Ayrshare سجلًا لها. اطلب هذه المعرّفات واحدًا تلو الآخر.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`معاملات-الترويسة`,children:`معاملات الترويسة`}),`\n`,_jsx(_MdxComponentBoundary,{name:`HeaderAPI`,children:_jsx(HeaderAPI,{})}),`\n`,_jsx(Heading,{level:`2`,id:`معاملات-الاستعلام`,children:`معاملات الاستعلام`}),`\n`,_jsx(ParamField,{query:`level`,type:`string`,required:true,id:`param-level`,children:_jsxs(_components.p,{children:[`ما يُبلغ عنه كل صف: `,_jsx(_components.code,{children:`campaign`}),` أو `,_jsx(_components.code,{children:`adSet`}),` أو `,_jsx(_components.code,{children:`ad`}),`.`]})}),`\n`,_jsxs(ParamField,{query:`ids`,type:`string`,id:`param-ids`,children:[_jsxs(_components.p,{children:[`معرّفات الحملات أو مجموعات الإعلانات أو الإعلانات مفصولة بفواصل، بحد أقصى 50. مطلوب مع `,_jsx(_components.code,{children:`level=campaign`}),` و`,_jsx(_components.code,{children:`level=adSet`}),`.`]}),_jsxs(_components.p,{children:[`مع `,_jsx(_components.code,{children:`level=ad`}),`، يمكنك حذف `,_jsx(_components.code,{children:`ids`}),` وإرسال `,_jsx(_components.code,{children:`accountId`}),` بدلًا منه. يُعدّ هذا تقريرًا عن الإعلانات\nالتي أنشأتها عبر Ayrshare لهذا الملف الشخصي في حساب الإعلانات ذلك، وليس عن كل إعلان فيه. ويعمل\nذلك مع ما يصل إلى 50 إعلانًا من هذا النوع. لأكثر من ذلك، أرسل معرّفاتها، أو أعدّ التقرير حسب الحملة. وإذا لم يُعثر على أي إعلان، يكون\nالتقرير فارغًا.`]})]}),`\n`,_jsxs(ParamField,{query:`accountId`,type:`string`,id:`param-account-id`,children:[_jsxs(_components.p,{children:[`معرّف حساب الإعلانات، مع البادئة `,_jsx(_components.code,{children:`act_`}),` أو بدونها (`,_jsx(_components.code,{children:`1234567890`}),` أو `,_jsx(_components.code,{children:`act_1234567890`}),`).`]}),_jsxs(_components.p,{children:[`مطلوب مع `,_jsx(_components.code,{children:`level=ad`}),` عند حذف `,_jsx(_components.code,{children:`ids`}),`.`]})]}),`\n`,_jsx(ParamField,{query:`metrics`,type:`string`,id:`param-metrics`,children:_jsxs(_components.p,{children:[`المقاييس المطلوب إرجاعها مفصولة بفواصل. احذفه للحصول عليها جميعًا. راجع `,_jsx(_components.a,{href:`#metrics`,children:`المقاييس`}),`.`]})}),`\n`,_jsx(ParamField,{query:`breakdowns`,type:`string`,id:`param-breakdowns`,children:_jsxs(_components.p,{children:[`التقسيمات مفصولة بفواصل: `,_jsx(_components.code,{children:`age`}),` و`,_jsx(_components.code,{children:`gender`}),` و`,_jsx(_components.code,{children:`country`}),` و`,_jsx(_components.code,{children:`placement`}),`. يصبح لكل يوم عندئذٍ صف واحد لكل\nقيمة، أو لكل تركيبة مع `,_jsx(_components.code,{children:`age,gender`}),`. أرسل تقسيمًا واحدًا في كل مرة، أو `,_jsx(_components.code,{children:`age,gender`}),`؛ إذ ترفض Meta\nالتركيبات الأخرى (مثل `,_jsx(_components.code,{children:`age,country`}),`)، لذا تُعيد الرمز `,_jsx(_components.code,{children:`101`}),`.`]})}),`\n`,_jsx(ParamField,{query:`startDate`,type:`string`,default:`قبل 30 يومًا`,id:`param-start-date`,children:_jsxs(_components.p,{children:[`اليوم الأول، بصيغة `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. يمكن أن يعود إلى ما يصل إلى 37 شهرًا مضت.`]})}),`\n`,_jsx(ParamField,{query:`endDate`,type:`string`,default:`اليوم`,id:`param-end-date`,children:_jsxs(_components.p,{children:[`اليوم الأخير، بصيغة `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`.`]})}),`\n`,_jsx(ParamField,{query:`next`,type:`string`,id:`param-next`,children:_jsxs(_components.p,{children:[`قيمة `,_jsx(_components.code,{children:`meta.pagination.next`}),` من الاستجابة السابقة، للحصول على الصفحة التالية.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`metrics`,children:`المقاييس`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`المقياس`}),_jsx(_components.th,{children:`النوع`}),_jsx(_components.th,{children:`المعنى`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`spend`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`المبلغ المُنفَق`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`impressions`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`عدد مرات عرض الإعلان`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reach`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`الأشخاص الذين شاهدوا الإعلان مرة واحدة على الأقل`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`clicks`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`النقرات`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cpm`})}),_jsxs(_components.td,{children:[`number أو `,_jsx(_components.code,{children:`null`})]}),_jsx(_components.td,{children:`التكلفة لكل 1,000 ظهور`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cpc`})}),_jsxs(_components.td,{children:[`number أو `,_jsx(_components.code,{children:`null`})]}),_jsxs(_components.td,{children:[`التكلفة لكل نقرة. `,_jsx(_components.code,{children:`null`}),` في يوم بلا نقرات`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ctr`})}),_jsxs(_components.td,{children:[`number أو `,_jsx(_components.code,{children:`null`})]}),_jsx(_components.td,{children:`نسبة النقر إلى الظهور، بالنسبة المئوية`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`actions`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`كل نوع إجراء أحصته Meta، مع عدده`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`conversionValue`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`القيمة الإجمالية لعمليات الشراء`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`يُبلغ Instagram عن كل مقياس في هذا الجدول. باستثناء واحد: لا تُبلغ Meta عن `,_jsx(_components.code,{children:`reach`}),` في تقرير يتضمن\n`,_jsx(_components.code,{children:`breakdowns`}),` ويبدأ قبل أكثر من 13 شهرًا، لذا يُحذف `,_jsx(_components.code,{children:`reach`}),` من تلك الصفوف. وعلى الشبكات التي لا تُبلغ عن مقياس ما، يُحذف ذلك المقياس\nمن الصفوف بدلًا من إرجاعه بالقيمة `,_jsx(_components.code,{children:`0`}),`، ويُعيد طلبه الرمز `,_jsx(_components.code,{children:`101`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`تحتسب Meta بعض الإجراءات ضمن أكثر من نوع، لذا لا تجمع قيم `,_jsx(_components.code,{children:`actions`}),` معًا. على\nسبيل المثال، يتضمن `,_jsx(_components.code,{children:`omni_purchase`}),` بالفعل `,_jsx(_components.code,{children:`purchase`}),`. أما `,_jsx(_components.code,{children:`conversionValue`}),` فيحتسب كل عملية شراء مرة واحدة.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`paging`,children:`ترقيم الصفحات`}),`\n`,_jsxs(_components.p,{children:[`تُعيد كل استجابة ما يصل إلى 500 صف. إذا كان هناك المزيد، تكون قيمة `,_jsx(_components.code,{children:`meta.pagination.hasMore`}),` هي `,_jsx(_components.code,{children:`true`}),` وتُعيَّن قيمة `,_jsx(_components.code,{children:`meta.pagination.next`}),`. أرسل الطلب نفسه\nمرة أخرى مع تعيين `,_jsx(_components.code,{children:`next`}),` إلى تلك القيمة للحصول على الصفحة التالية. في الصفحة الأخيرة، تكون قيمة `,_jsx(_components.code,{children:`hasMore`}),` هي `,_jsx(_components.code,{children:`false`}),` ولا توجد `,_jsx(_components.code,{children:`next`}),`. تعمل قيمة `,_jsx(_components.code,{children:`next`}),`\nفقط مع المعلمات التي جاءت منها: مع معلمات مختلفة يُعيد الطلب `,_jsx(_components.code,{children:`code: 101`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`الأخطاء`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`الرمز`}),_jsx(_components.th,{children:`متى`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`101`})}),_jsxs(_components.td,{children:[`معامل مفقود أو غير صحيح، أو تقسيم أو مقياس غير مدعوم، أو كون `,_jsx(_components.code,{children:`startDate`}),` أقدم من 37 شهرًا، أو إرسال أكثر من 50 معرّفًا، أو انتماء المعرّفات إلى أكثر من حساب إعلانات واحد، أو رفض Meta لتركيبة التقسيمات`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`حملة أو مجموعة إعلانات أو إعلان لا يخصّك، أو `,_jsx(_components.code,{children:`accountId`}),` ليس حساب الإعلانات المسجّل لدى Ayrshare للمعرّفات التي أرسلتها. بالنسبة لمجموعة الإعلانات، يجب أيضًا أن يكون `,_jsx(_components.code,{children:`accountId`}),` هو حساب الإعلانات الذي تُبلغ عنه Meta لها. بالنسبة للإعلان الذي لا يملك Ayrshare سجلًا له، لا يُتحقق من `,_jsx(_components.code,{children:`accountId`}),` ويُقرأ الإعلان بمفرده`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`370`})}),_jsx(_components.td,{children:`تعذّر على Meta إرجاع الرؤى. حاول مرة أخرى`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{PlansAvailable,HeaderAPI,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"الرؤى","description":"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.","api":"GET /ads/instagram/insights","href":"/ar/apis/ads/instagram/get-ad-insights"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const PlansAvailable=()=>null;const HeaderAPI=()=>null;function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,RequestExample,ResponseExample,Table,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missingMdxReference(`Table`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_MdxComponentBoundary,{name:`PlansAvailable`,children:_jsx(PlansAvailable,{plans:[`premium`],maxPackRequired:false})}),`\n`,_jsx(_components.p,{children:`احصل على أداء إعلاناتك على Instagram مباشرةً، بصف واحد لكل يوم، لحملاتك أو مجموعات إعلاناتك أو إعلاناتك.\nاختر المقاييس التي تريدها، وقسّمها حسب العمر أو الجنس أو الدولة أو موضع الظهور، وتصفّح النطاقات الزمنية الطويلة صفحةً تلو الأخرى.`}),`\n`,_jsxs(`ul`,{className:`custom-bullets`,children:[_jsx(`li`,{children:`تُقرأ الأرقام من Meta لحظة استدعائك، وليس من نسخة تُحدَّث كل ليلة.`}),_jsx(`li`,{children:_jsxs(_components.p,{children:[`استخدم `,_jsx(_components.a,{href:`/apis/ads/instagram/get-ad-history`,children:`السجل`}),` للاطلاع على سجل الإنفاق اليومي. واستخدم الرؤى لإعداد التقارير والتحليل.`]})}),_jsxs(`li`,{children:[`جميع القيم النقدية بعملة حساب الإعلانات، وتُعاد في الحقل `,_jsx(_components.code,{children:`currency`}),` في كل صف.`]}),_jsx(`li`,{children:_jsx(_components.p,{children:`يجب أن تكون الحملات قد أُنشئت عبر Ayrshare لهذا الملف الشخصي، ويجب أن تكون مجموعات الإعلانات ضمن حملة كهذه. يُرفض الإعلان الذي أُنشئ عبر\nAyrshare لملف شخصي آخر. أما معرّفات الإعلانات الأخرى فتُقرأ باستخدام حساب Meta المرتبط بهذا الملف الشخصي،\nلذا لا تُعيد Meta إلا الإعلانات التي يستطيع ذلك الحساب رؤيتها.`})}),_jsx(`li`,{children:_jsxs(_components.p,{children:[`يغطي الطلب الواحد حساب إعلانات واحدًا. تُعيد المعرّفات التابعة لعدة حسابات إعلانات الرمز `,_jsx(_components.code,{children:`101`}),`، وكذلك\nعدة معرّفات إعلانات لا يملك Ayrshare سجلًا لها. اطلب هذه المعرّفات واحدًا تلو الآخر.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`معاملات-الترويسة`,children:`معاملات الترويسة`}),`\n`,_jsx(_MdxComponentBoundary,{name:`HeaderAPI`,children:_jsx(HeaderAPI,{})}),`\n`,_jsx(Heading,{level:`2`,id:`معاملات-الاستعلام`,children:`معاملات الاستعلام`}),`\n`,_jsx(ParamField,{query:`level`,type:`string`,required:true,id:`param-level`,children:_jsxs(_components.p,{children:[`ما يُبلغ عنه كل صف: `,_jsx(_components.code,{children:`campaign`}),` أو `,_jsx(_components.code,{children:`adSet`}),` أو `,_jsx(_components.code,{children:`ad`}),`.`]})}),`\n`,_jsxs(ParamField,{query:`ids`,type:`string`,id:`param-ids`,children:[_jsxs(_components.p,{children:[`معرّفات الحملات أو مجموعات الإعلانات أو الإعلانات مفصولة بفواصل، بحد أقصى 50. مطلوب مع `,_jsx(_components.code,{children:`level=campaign`}),` و`,_jsx(_components.code,{children:`level=adSet`}),`.`]}),_jsxs(_components.p,{children:[`مع `,_jsx(_components.code,{children:`level=ad`}),`، يمكنك حذف `,_jsx(_components.code,{children:`ids`}),` وإرسال `,_jsx(_components.code,{children:`accountId`}),` بدلًا منه. يُعدّ هذا تقريرًا عن الإعلانات\nالتي أنشأتها عبر Ayrshare لهذا الملف الشخصي في حساب الإعلانات ذلك، وليس عن كل إعلان فيه. ويعمل\nذلك مع ما يصل إلى 50 إعلانًا من هذا النوع. لأكثر من ذلك، أرسل معرّفاتها، أو أعدّ التقرير حسب الحملة. وإذا لم يُعثر على أي إعلان، يكون\nالتقرير فارغًا.`]})]}),`\n`,_jsxs(ParamField,{query:`accountId`,type:`string`,id:`param-account-id`,children:[_jsxs(_components.p,{children:[`معرّف حساب الإعلانات، مع البادئة `,_jsx(_components.code,{children:`act_`}),` أو بدونها (`,_jsx(_components.code,{children:`1234567890`}),` أو `,_jsx(_components.code,{children:`act_1234567890`}),`).`]}),_jsxs(_components.p,{children:[`مطلوب مع `,_jsx(_components.code,{children:`level=ad`}),` عند حذف `,_jsx(_components.code,{children:`ids`}),`.`]})]}),`\n`,_jsx(ParamField,{query:`metrics`,type:`string`,id:`param-metrics`,children:_jsxs(_components.p,{children:[`المقاييس المطلوب إرجاعها مفصولة بفواصل. احذفه للحصول عليها جميعًا. راجع `,_jsx(_components.a,{href:`#metrics`,children:`المقاييس`}),`.`]})}),`\n`,_jsx(ParamField,{query:`breakdowns`,type:`string`,id:`param-breakdowns`,children:_jsxs(_components.p,{children:[`التقسيمات مفصولة بفواصل: `,_jsx(_components.code,{children:`age`}),` و`,_jsx(_components.code,{children:`gender`}),` و`,_jsx(_components.code,{children:`country`}),` و`,_jsx(_components.code,{children:`placement`}),`. يصبح لكل يوم عندئذٍ صف واحد لكل\nقيمة، أو لكل تركيبة مع `,_jsx(_components.code,{children:`age,gender`}),`. أرسل تقسيمًا واحدًا في كل مرة، أو `,_jsx(_components.code,{children:`age,gender`}),`؛ إذ ترفض Meta\nالتركيبات الأخرى (مثل `,_jsx(_components.code,{children:`age,country`}),`)، لذا تُعيد الرمز `,_jsx(_components.code,{children:`101`}),`.`]})}),`\n`,_jsx(ParamField,{query:`startDate`,type:`string`,default:`قبل 30 يومًا`,id:`param-start-date`,children:_jsxs(_components.p,{children:[`اليوم الأول، بصيغة `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. يمكن أن يعود إلى ما يصل إلى 37 شهرًا مضت.`]})}),`\n`,_jsx(ParamField,{query:`endDate`,type:`string`,default:`اليوم`,id:`param-end-date`,children:_jsxs(_components.p,{children:[`اليوم الأخير، بصيغة `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`.`]})}),`\n`,_jsx(ParamField,{query:`next`,type:`string`,id:`param-next`,children:_jsxs(_components.p,{children:[`قيمة `,_jsx(_components.code,{children:`meta.pagination.next`}),` من الاستجابة السابقة، للحصول على الصفحة التالية.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`metrics`,children:`المقاييس`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`المقياس`}),_jsx(_components.th,{children:`النوع`}),_jsx(_components.th,{children:`المعنى`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`spend`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`المبلغ المُنفَق`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`impressions`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`عدد مرات عرض الإعلان`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reach`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`الأشخاص الذين شاهدوا الإعلان مرة واحدة على الأقل`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`clicks`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`النقرات`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cpm`})}),_jsxs(_components.td,{children:[`number أو `,_jsx(_components.code,{children:`null`})]}),_jsx(_components.td,{children:`التكلفة لكل 1,000 ظهور`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cpc`})}),_jsxs(_components.td,{children:[`number أو `,_jsx(_components.code,{children:`null`})]}),_jsxs(_components.td,{children:[`التكلفة لكل نقرة. `,_jsx(_components.code,{children:`null`}),` في يوم بلا نقرات`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ctr`})}),_jsxs(_components.td,{children:[`number أو `,_jsx(_components.code,{children:`null`})]}),_jsx(_components.td,{children:`نسبة النقر إلى الظهور، بالنسبة المئوية`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`actions`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`كل نوع إجراء أحصته Meta، مع عدده`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`conversionValue`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`القيمة الإجمالية لعمليات الشراء`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`يُبلغ Instagram عن كل مقياس في هذا الجدول. باستثناء واحد: لا تُبلغ Meta عن `,_jsx(_components.code,{children:`reach`}),` في تقرير يتضمن\n`,_jsx(_components.code,{children:`breakdowns`}),` ويبدأ قبل أكثر من 13 شهرًا، لذا يُحذف `,_jsx(_components.code,{children:`reach`}),` من تلك الصفوف. وعلى الشبكات التي لا تُبلغ عن مقياس ما، يُحذف ذلك المقياس\nمن الصفوف بدلًا من إرجاعه بالقيمة `,_jsx(_components.code,{children:`0`}),`، ويُعيد طلبه الرمز `,_jsx(_components.code,{children:`101`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`تحتسب Meta بعض الإجراءات ضمن أكثر من نوع، لذا لا تجمع قيم `,_jsx(_components.code,{children:`actions`}),` معًا. على\nسبيل المثال، يتضمن `,_jsx(_components.code,{children:`omni_purchase`}),` بالفعل `,_jsx(_components.code,{children:`purchase`}),`. أما `,_jsx(_components.code,{children:`conversionValue`}),` فيحتسب كل عملية شراء مرة واحدة.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`paging`,children:`ترقيم الصفحات`}),`\n`,_jsxs(_components.p,{children:[`تُعيد كل استجابة ما يصل إلى 500 صف. إذا كان هناك المزيد، تكون قيمة `,_jsx(_components.code,{children:`meta.pagination.hasMore`}),` هي `,_jsx(_components.code,{children:`true`}),` وتُعيَّن قيمة `,_jsx(_components.code,{children:`meta.pagination.next`}),`. أرسل الطلب نفسه\nمرة أخرى مع تعيين `,_jsx(_components.code,{children:`next`}),` إلى تلك القيمة للحصول على الصفحة التالية. في الصفحة الأخيرة، تكون قيمة `,_jsx(_components.code,{children:`hasMore`}),` هي `,_jsx(_components.code,{children:`false`}),` ولا توجد `,_jsx(_components.code,{children:`next`}),`. تعمل قيمة `,_jsx(_components.code,{children:`next`}),`\nفقط مع المعلمات التي جاءت منها: مع معلمات مختلفة يُعيد الطلب `,_jsx(_components.code,{children:`code: 101`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`الأخطاء`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`الرمز`}),_jsx(_components.th,{children:`متى`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`101`})}),_jsxs(_components.td,{children:[`معامل مفقود أو غير صحيح، أو تقسيم أو مقياس غير مدعوم، أو كون `,_jsx(_components.code,{children:`startDate`}),` أقدم من 37 شهرًا، أو إرسال أكثر من 50 معرّفًا، أو انتماء المعرّفات إلى أكثر من حساب إعلانات واحد، أو رفض Meta لتركيبة التقسيمات`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`حملة أو مجموعة إعلانات أو إعلان لا يخصّك، أو `,_jsx(_components.code,{children:`accountId`}),` ليس حساب الإعلانات المسجّل لدى Ayrshare للمعرّفات التي أرسلتها. بالنسبة لمجموعة الإعلانات، يجب أيضًا أن يكون `,_jsx(_components.code,{children:`accountId`}),` هو حساب الإعلانات الذي تُبلغ عنه Meta لها. بالنسبة للإعلان الذي لا يملك Ayrshare سجلًا له، لا يُتحقق من `,_jsx(_components.code,{children:`accountId`}),` ويُقرأ الإعلان بمفرده`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`370`})}),_jsx(_components.td,{children:`تعذّر على Meta إرجاع الرؤى. حاول مرة أخرى`})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`-H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`-X `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.ayrshare.com/api/ads/instagram/insights?level=campaign\u0026ids=120200000000000001\u0026startDate=2026-09-01\u0026endDate=2026-09-02\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`15`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URLSearchParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` level:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"campaign\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ids:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"120200000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` startDate:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` endDate:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"2026-09-02\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`https://api.ayrshare.com/api/ads/instagram/insights?\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`params`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"GET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`})`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`then`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`((`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`())`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`then`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`((`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`))`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`13`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Bearer API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`params `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'level'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'campaign'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'ids'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'120200000000000001'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'startDate'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'2026-09-01'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'endDate'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'2026-09-02'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`r `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.ayrshare.com/api/ads/instagram/insights'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`params)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(r.json())`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200: Success`,numberOfLines:`29`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`29`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"platform\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"instagram\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"level\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"campaign\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"startDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-02\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"insights\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"level\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"campaign\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"120200000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"spend\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12.34`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"impressions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reach\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"clicks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`80`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cpm\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3.085`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cpc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.15425`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ctr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"actions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"link_click\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`75`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"omni_purchase\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conversionValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`89.97`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"hasMore\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`200: Breakdowns`,numberOfLines:`31`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`31`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"platform\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"instagram\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"level\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ad\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"startDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"insights\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"level\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ad\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"120210000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"age\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"25-34\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"gender\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"female\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EUR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"spend\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"impressions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`300`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"level\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ad\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"120210000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"age\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"25-34\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"gender\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"male\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EUR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"spend\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"impressions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"hasMore\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400: Not Yours`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"action\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ads\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The ad is not found or not authorized.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{PlansAvailable,HeaderAPI,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"الرؤى","description":"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.","api":"GET /ads/instagram/insights","href":"/ar/apis/ads/instagram/get-ad-insights"}}}},"mdxExtracts":{"tableOfContents":[{"title":"معاملات الترويسة","slug":"معاملات-الترويسة","depth":2,"children":[]},{"title":"معاملات الاستعلام","slug":"معاملات-الاستعلام","depth":2,"children":[]},{"title":"المقاييس","slug":"metrics","depth":2,"children":[]},{"title":"ترقيم الصفحات","slug":"paging","depth":2,"children":[]},{"title":"الأخطاء","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">-H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Authorization: Bearer API_KEY\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">-X \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">GET\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.ayrshare.com/api/ads/instagram/insights?level=campaign\u0026#x26;ids=120200000000000001\u0026#x26;startDate=2026-09-01\u0026#x26;endDate=2026-09-02\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"15\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> API_KEY\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"API_KEY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> URLSearchParams\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> level:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"campaign\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> ids:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"120200000000000001\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> startDate:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> endDate:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"2026-09-02\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`https://api.ayrshare.com/api/ads/instagram/insights?\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">params\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"GET\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">Authorization:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> `Bearer \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">API_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">})\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> .\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">then\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">((\u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">res\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">=>\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> res\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">())\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> .\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">then\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">((\u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">=>\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">))\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> .\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">catch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">error\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">headers \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Authorization'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Bearer API_KEY'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">params \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'level'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'campaign'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'ids'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'120200000000000001'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'startDate'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'2026-09-01'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'endDate'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'2026-09-02'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">r \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api.ayrshare.com/api/ads/instagram/insights'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">headers, \u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">params)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(r.json())\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200: Success","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"29\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"platform\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"instagram\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"level\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"campaign\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"startDate\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"endDate\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-02\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"insights\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"level\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"campaign\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"120200000000000001\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"spend\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12.34\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"impressions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">4000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"reach\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"clicks\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">80\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cpm\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3.085\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cpc\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.15425\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"ctr\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"actions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"link_click\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"value\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">75\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"omni_purchase\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"value\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"conversionValue\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">89.97\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"meta\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"pagination\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"hasMore\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"200: Breakdowns","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"31\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"platform\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"instagram\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"level\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ad\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"startDate\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"endDate\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"insights\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"level\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ad\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"120210000000000001\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"age\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"25-34\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"gender\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"female\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"EUR\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"spend\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1.5\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"impressions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">300\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"level\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ad\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"120210000000000001\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"age\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"25-34\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"gender\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"male\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"EUR\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"spend\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"impressions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">200\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"meta\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"pagination\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"hasMore\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400: Not Yours","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"6\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"action\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ads\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">400\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"The ad is not found or not authorized.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"الرؤى","path":"/ads/instagram/insights","servers":[{"url":"https://api.ayrshare.com/api"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{"level":{"schema":[{"type":"string","description":"ما يُبلغ عنه كل صف: `campaign` أو `adSet` أو `ad` .","required":true}]},"ids":{"schema":[{"type":"string","description":"معرّفات الحملات أو مجموعات الإعلانات أو الإعلانات مفصولة بفواصل، بحد أقصى 50. مطلوب مع `level=campaign` و `level=adSet` . مع `level=ad` ، يمكنك حذف `ids` وإرسال `accountId` بدلًا منه. يُعدّ هذا تقريرًا عن الإعلانات التي أنشأتها عبر Ayrshare لهذا الملف الشخصي في حساب الإعلانات ذلك، وليس عن كل إعلان فيه. ويعمل ذلك مع ما يصل إلى 50 إعلانًا من هذا النوع. لأكثر من ذلك، أرسل معرّفاتها، أو أعدّ التقرير حسب الحملة. وإذا لم يُعثر على أي إعلان، يكون التقرير فارغًا."}]},"accountId":{"schema":[{"type":"string","description":"معرّف حساب الإعلانات، مع البادئة `act_` أو بدونها ( `1234567890` أو `act_1234567890` ). مطلوب مع `level=ad` عند حذف `ids` ."}]},"metrics":{"schema":[{"type":"string","description":"المقاييس المطلوب إرجاعها مفصولة بفواصل. احذفه للحصول عليها جميعًا. راجع المقاييس ."}]},"breakdowns":{"schema":[{"type":"string","description":"التقسيمات مفصولة بفواصل: `age` و `gender` و `country` و `placement` . يصبح لكل يوم عندئذٍ صف واحد لكل قيمة، أو لكل تركيبة مع `age,gender` . أرسل تقسيمًا واحدًا في كل مرة، أو `age,gender` ؛ إذ ترفض Meta التركيبات الأخرى (مثل `age,country` )، لذا تُعيد الرمز `101` ."}]},"startDate":{"schema":[{"type":"string","description":"اليوم الأول، بصيغة `YYYY-MM-DD` . يمكن أن يعود إلى ما يصل إلى 37 شهرًا مضت."}]},"endDate":{"schema":[{"type":"string","description":"اليوم الأخير، بصيغة `YYYY-MM-DD` ."}]},"next":{"schema":[{"type":"string","description":"قيمة `meta.pagination.next` من الاستجابة السابقة، للحصول على الصفحة التالية."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{},"deprecated":false}},"jsLinks":["/docs/_mintlify/custom/ayrshare-docs/80ea29d8530ebaa2/script.js","/docs/_mintlify/custom/ayrshare-docs/3e93073b19ca64e9/tools/maintainScroll.js"],"dynamicCss":".mint-mt-2 {\n margin-top: 0.5rem\n}\n.mint-flex {\n display: flex\n}\n.mint-cursor-pointer {\n cursor: pointer\n}\n.mint-items-center {\n align-items: center\n}\n.mint-rounded {\n border-radius: 0.25rem\n}\n.mint-px-1\\.5 {\n padding-left: 0.375rem;\n padding-right: 0.375rem\n}\n.mint-py-0\\.5 {\n padding-top: 0.125rem;\n padding-bottom: 0.125rem\n}\n.mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}","subdomain":"ayrshare-docs","siteName":"Ayrshare Docs","title":"الرؤى - Ayrshare Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/apis/ads/instagram/get-ad-insights","matchLevel":1},"es":{"href":"/es/apis/ads/instagram/get-ad-insights","matchLevel":1},"cn":{"href":"/cn/apis/ads/instagram/get-ad-insights","matchLevel":1,"hidden":true},"zh":{"href":"/zh/apis/ads/instagram/get-ad-insights","matchLevel":1,"hidden":true},"pt-BR":{"href":"/pt-BR/apis/ads/instagram/get-ad-insights","matchLevel":1},"fr":{"href":"/fr/apis/ads/instagram/get-ad-insights","matchLevel":1},"de":{"href":"/de/apis/ads/instagram/get-ad-insights","matchLevel":1},"vi":{"href":"/vi/apis/ads/instagram/get-ad-insights","matchLevel":1},"ja":{"href":"/ja/apis/ads/instagram/get-ad-insights","matchLevel":1},"uk":{"href":"/uk/apis/ads/instagram/get-ad-insights","matchLevel":1},"hi":{"href":"/hi/apis/ads/instagram/get-ad-insights","matchLevel":1},"ar":{"href":"/ar/apis/ads/instagram/get-ad-insights","matchLevel":0},"zh-Hans":{"href":"/zh-Hans/apis/ads/instagram/get-ad-insights","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/apis/ads/instagram/get-ad-insights","matchLevel":1}}},"lastModified":"2026-11-13T12:47:01.181Z","originalFileLocation":"ar/apis/ads/instagram/get-ad-insights.mdx","locale":"ar"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ayrshare Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"الرؤى - Ayrshare Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ayrshare Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ayrshare-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Instagram+Ads\u0026amp;title=%D8%A7%D9%84%D8%B1%D8%A4%D9%89\u0026amp;description=%D8%A7%D8%B3%D8%AD%D8%A8+%D9%85%D9%82%D8%A7%D9%8A%D9%8A%D8%B3+%D9%8A%D9%88%D9%85%D9%8A%D8%A9+%D9%85%D8%A8%D8%A7%D8%B4%D8%B1%D8%A9+%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA+Instagram+%D9%84%D9%84%D8%AD%D9%85%D9%84%D8%A7%D8%AA+%D8%A3%D9%88+%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA+%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA+%D8%A3%D9%88+%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA%D8%8C+%D9%85%D9%82%D8%B3%D9%91%D9%85%D8%A9+%D8%AD%D8%B3%D8%A8+%D8%A7%D9%84%D8%B9%D9%85%D8%B1+%D8%A3%D9%88+%D8%A7%D9%84%D8%AC%D9%86%D8%B3+%D8%A3%D9%88+%D8%A7%D9%84%D8%A8%D9%84%D8%AF+%D8%A3%D9%88+%D9%85%D9%88%D8%B6%D8%B9+%D8%A7%D9%84%D8%B9%D8%B1%D8%B6.\u0026amp;theme=722a7095c53b95fd5a0669f2\u0026amp;signature=d3bea99b8c2b0638830107d446437032a16ae74471fea1dae4b82005ac7f2023\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"الرؤى - Ayrshare Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ayrshare-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Instagram+Ads\u0026amp;title=%D8%A7%D9%84%D8%B1%D8%A4%D9%89\u0026amp;description=%D8%A7%D8%B3%D8%AD%D8%A8+%D9%85%D9%82%D8%A7%D9%8A%D9%8A%D8%B3+%D9%8A%D9%88%D9%85%D9%8A%D8%A9+%D9%85%D8%A8%D8%A7%D8%B4%D8%B1%D8%A9+%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA+Instagram+%D9%84%D9%84%D8%AD%D9%85%D9%84%D8%A7%D8%AA+%D8%A3%D9%88+%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA+%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA+%D8%A3%D9%88+%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA%D8%8C+%D9%85%D9%82%D8%B3%D9%91%D9%85%D8%A9+%D8%AD%D8%B3%D8%A8+%D8%A7%D9%84%D8%B9%D9%85%D8%B1+%D8%A3%D9%88+%D8%A7%D9%84%D8%AC%D9%86%D8%B3+%D8%A3%D9%88+%D8%A7%D9%84%D8%A8%D9%84%D8%AF+%D8%A3%D9%88+%D9%85%D9%88%D8%B6%D8%B9+%D8%A7%D9%84%D8%B9%D8%B1%D8%B6.\u0026amp;theme=722a7095c53b95fd5a0669f2\u0026amp;signature=d3bea99b8c2b0638830107d446437032a16ae74471fea1dae4b82005ac7f2023\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/ayrshare-docs/tc_XJFteIEk_1d3D/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ayrshare Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2266C2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ar/apis/ads/instagram/get-ad-insights.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://www.ayrshare.com/docs/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://www.ayrshare.com/docs/es/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://www.ayrshare.com/docs/pt-BR/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://www.ayrshare.com/docs/fr/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://www.ayrshare.com/docs/de/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://www.ayrshare.com/docs/vi/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://www.ayrshare.com/docs/ja/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"uk\" href=\"https://www.ayrshare.com/docs/uk/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://www.ayrshare.com/docs/hi/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hans\" href=\"https://www.ayrshare.com/docs/zh-Hans/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://www.ayrshare.com/docs/zh-Hant/apis/ads/instagram/get-ad-insights\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://www.ayrshare.com/docs/apis/ads/instagram/get-ad-insights\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ayrshare.com/#organization\",\"name\":\"Ayrshare Docs\",\"url\":\"https://www.ayrshare.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ayrshare-docs/7bWzjvNjeuvs-M3N/images/logos/ayrshare-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=7bWzjvNjeuvs-M3N\u0026q=85\u0026s=8d23367f493d06599eecbbfa2b6325cf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.ayrshare.com/docs#website\",\"name\":\"Ayrshare Docs\",\"url\":\"https://www.ayrshare.com/docs\",\"publisher\":{\"@id\":\"https://www.ayrshare.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights#webpage\",\"url\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights\",\"name\":\"الرؤى\",\"description\":\"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.\",\"dateModified\":\"2026-11-13T12:47:01.181Z\",\"isPartOf\":{\"@id\":\"https://www.ayrshare.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://www.ayrshare.com/docs/ar/apis/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ads\",\"item\":\"https://www.ayrshare.com/docs/ar/apis/ads/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Instagram Ads\",\"item\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-accounts\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"الرؤى\",\"item\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights#apireference\",\"headline\":\"الرؤى\",\"name\":\"الرؤى\",\"description\":\"اسحب مقاييس يومية مباشرة لإعلانات Instagram للحملات أو مجموعات الإعلانات أو الإعلانات، مقسّمة حسب العمر أو الجنس أو البلد أو موضع العرض.\",\"url\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights\",\"mainEntityOfPage\":{\"@id\":\"https://www.ayrshare.com/docs/ar/apis/ads/instagram/get-ad-insights#webpage\"},\"dateModified\":\"2026-11-13T12:47:01.181Z\",\"publisher\":{\"@id\":\"https://www.ayrshare.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.ayrshare.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ayrshare Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ayrshare Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/ar/apis/ads/instagram/get-ad-insights.md","siteName":"Ayrshare Docs","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/apis/ads/instagram/get-ad-insights"}]},{"language":"es","pages":[{"title":"es","href":"/es/apis/ads/instagram/get-ad-insights"}]},{"language":"cn","hidden":true,"pages":[{"title":"cn","href":"/cn/apis/ads/instagram/get-ad-insights","hidden":true}]},{"language":"zh","hidden":true,"pages":[{"title":"zh","href":"/zh/apis/ads/instagram/get-ad-insights","hidden":true}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/apis/ads/instagram/get-ad-insights"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/apis/ads/instagram/get-ad-insights"}]},{"language":"de","pages":[{"title":"de","href":"/de/apis/ads/instagram/get-ad-insights"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/apis/ads/instagram/get-ad-insights"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/apis/ads/instagram/get-ad-insights"}]},{"language":"uk","pages":[{"title":"uk","href":"/uk/apis/ads/instagram/get-ad-insights"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/apis/ads/instagram/get-ad-insights"}]},{"language":"ar","anchors":[{"anchor":"Documentation","icon":"code","groups":[{"group":"Get Started","pages":[{"title":"Ayrshare Social Media API","href":"/ar/introduction"},{"title":"دليل البدء السريع","href":"/ar/quickstart"},{"group":"MCP Server","pages":[{"title":"MCP Server: شغّل واجهة Ayrshare API بوكلاء الذكاء الاصطناعي","sidebarTitle":"نظرة عامة","icon":"robot","href":"/ar/additional/mcp-action-server"},{"title":"الاتصال بخادم MCP","sidebarTitle":"الاتصال والإعداد","icon":"plug","href":"/ar/additional/mcp-action-connect"},{"title":"كتالوج أدوات MCP","sidebarTitle":"كتالوج الأدوات","icon":"list","href":"/ar/additional/mcp-action-tools"},{"title":"إضافة Claude Code","icon":"terminal","href":"/ar/additional/mcp-claude-code-plugin"},{"title":"n8n","icon":"diagram-project","href":"/ar/additional/mcp-n8n"},{"title":"إعداد حسابات التواصل الاجتماعي للعملاء","sidebarTitle":"إعداد العميل","icon":"user-plus","href":"/ar/additional/mcp-client-onboarding"},{"title":"MCP للتوثيق","sidebarTitle":"MCP للتوثيق","icon":"magnifying-glass","href":"/ar/additional/mcp-server"}]}]},{"group":"API Endpoints","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات Ayrshare","href":"/ar/apis/overview"},{"group":"GraphQL","pages":[{"title":"نظرة عامة على GraphQL API","href":"/ar/apis/graphql/overview"},{"title":"استخدام GraphQL API","href":"/ar/apis/graphql/using-the-api"},{"title":"أخطاء GraphQL","href":"/ar/apis/graphql/errors"},{"title":"حدود GraphQL والفوترة","href":"/ar/apis/graphql/limits"},{"title":"الإعلانات","href":"/ar/apis/graphql/ads"}]},{"group":"Ads","pages":[{"title":"Ads API: عزّز منشورات Meta وأدِر Google Ads","sidebarTitle":"نظرة عامة على Ads API","href":"/ar/apis/ads/overview"},{"title":"الحملات الإعلانية","href":"/ar/apis/ads/campaigns"},{"group":"Facebook Ads","pages":[{"title":"Accounts","api":"GET /ads/facebook/accounts","href":"/ar/apis/ads/facebook/get-ad-accounts"},{"title":"الحملات","api":"GET /ads/facebook/campaigns","href":"/ar/apis/ads/facebook/get-ad-campaigns"},{"title":"تعزيز المنشور","api":"POST /ads/facebook/boost","href":"/ar/apis/ads/facebook/boost-post"},{"title":"الإعلانات المُعزَّزة","api":"GET /ads/facebook/ads","href":"/ar/apis/ads/facebook/get-boosted-ads"},{"title":"السجل","api":"GET /ads/facebook/history","href":"/ar/apis/ads/facebook/get-ad-history"},{"title":"الرؤى","api":"GET /ads/facebook/insights","href":"/ar/apis/ads/facebook/get-ad-insights"},{"title":"الاهتمامات","api":"GET /ads/facebook/interests","href":"/ar/apis/ads/facebook/get-ad-interests"},{"title":"المناطق","api":"GET /ads/facebook/regions","href":"/ar/apis/ads/facebook/get-ad-regions"},{"title":"المدن","api":"GET /ads/facebook/cities","href":"/ar/apis/ads/facebook/get-ad-cities"},{"title":"توصيات DSA","api":"GET /ads/facebook/dsaRecommendations","href":"/ar/apis/ads/facebook/get-dsa-recommendations"},{"title":"تحديث إعلان","api":"PUT /ads/facebook/ads","href":"/ar/apis/ads/facebook/put-ad-update"}]},{"group":"Instagram Ads","pages":[{"title":"Accounts","api":"GET /ads/instagram/accounts","href":"/ar/apis/ads/instagram/get-ad-accounts"},{"title":"الحملات","api":"GET /ads/instagram/campaigns","href":"/ar/apis/ads/instagram/get-ad-campaigns"},{"title":"المناطق","api":"GET /ads/instagram/regions","href":"/ar/apis/ads/instagram/get-ad-regions"},{"title":"المدن","api":"GET /ads/instagram/cities","href":"/ar/apis/ads/instagram/get-ad-cities"},{"title":"توصيات DSA","api":"GET /ads/instagram/dsaRecommendations","href":"/ar/apis/ads/instagram/get-dsa-recommendations"},{"title":"تعزيز المنشور","api":"POST /ads/instagram/boost","href":"/ar/apis/ads/instagram/boost-post"},{"title":"الإعلانات المُعزَّزة","api":"GET /ads/instagram/ads","href":"/ar/apis/ads/instagram/get-boosted-ads"},{"title":"السجل","description":"استرجع الإنفاق اليومي التاريخي ومقاييس الأداء لإعلانات Instagram، مع تفصيل يومي ومقاييس مجمّعة حسب نوع الهدف وعنوانه ضمن نطاق زمني.","api":"GET /ads/instagram/history","href":"/ar/apis/ads/instagram/get-ad-history"},{"title":"الرؤى","api":"GET /ads/instagram/insights","href":"/ar/apis/ads/instagram/get-ad-insights"},{"title":"الاهتمامات","description":"ابحث عن اهتمامات استهداف إعلانات Instagram بالكلمة المفتاحية مع تقديرات حجم الجمهور. استخدم المعرّفات المُرجعة في مصفوفة interests لتعزيز المنشورات.","api":"GET /ads/instagram/interests","href":"/ar/apis/ads/instagram/get-ad-interests"},{"title":"تحديث إعلان","api":"PUT /ads/instagram/ads","href":"/ar/apis/ads/instagram/put-ad-update"}]},{"group":"Google Ads","pages":[{"title":"Accounts","api":"GET /ads/google/accounts","href":"/ar/apis/ads/google/get-ad-accounts"},{"title":"حملات بحث Google","sidebarTitle":"حملات البحث","api":"POST /ads/google/campaigns","href":"/ar/apis/ads/google/search-campaigns"},{"title":"حملات Google Performance Max","sidebarTitle":"حملات Performance Max","api":"POST /ads/google/campaigns","href":"/ar/apis/ads/google/performance-max-campaigns"},{"title":"الحصول على حملة","api":"GET /ads/google/campaigns/{id}","href":"/ar/apis/ads/google/get-campaign"},{"title":"تحديث حملة","api":"PUT /ads/google/campaigns/{id}","href":"/ar/apis/ads/google/update-campaign"},{"title":"الرؤى","api":"GET /ads/google/insights","href":"/ar/apis/ads/google/get-ad-insights"}]}]},{"group":"Analytics","pages":[{"title":"واجهة التحليلات: مقاييس المنشورات والحسابات والروابط","sidebarTitle":"نظرة عامة على واجهة برمجة تطبيقات التحليلات","href":"/ar/apis/analytics/overview"},{"title":"التحليلات على منشور","api":"POST /analytics/post","href":"/ar/apis/analytics/post"},{"title":"تحليلات على منشور حسب معرف اجتماعي","api":"POST /analytics/post","href":"/ar/apis/analytics/social-by-id"},{"title":"التحليلات على شبكة اجتماعية","api":"POST /analytics/social","href":"/ar/apis/analytics/social"},{"title":"قوائم تشغيل YouTube","api":"GET /analytics/youTubePlaylists","href":"/ar/apis/analytics/youtube-playlists"},{"title":"عدد متابعي إنستجرام المتصلين","api":"GET /analytics/getInstagramOnlineFollowers","href":"/ar/apis/analytics/instagram-follower-count"}]},{"group":"Auto Schedule","pages":[{"title":"نظرة عامة على Auto Schedule","href":"/ar/apis/auto-schedule/overview"},{"title":"تعيين الجدولة التلقائية","api":"POST /auto-schedule/set","href":"/ar/apis/auto-schedule/set-schedule"},{"title":"حذف الجدول التلقائي","api":"DELETE /auto-schedule/delete","href":"/ar/apis/auto-schedule/delete-schedule"},{"title":"عرض قائمة الجدولة التلقائية","api":"GET /auto-schedule/list","href":"/ar/apis/auto-schedule/list-schedule"},{"title":"الحصول على المنشورات المجدولة تلقائيًا المعلقة","api":"GET /auto-schedule/pending","href":"/ar/apis/auto-schedule/pending-auto-schedule"}]},{"group":"Automations","tag":"BETA","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات الأتمتة","href":"/ar/apis/automations/overview"},{"title":"إنشاء أتمتة","api":"POST /automations","href":"/ar/apis/automations/create-automation"},{"title":"عرض قائمة الأتمتة","api":"GET /automations","href":"/ar/apis/automations/list-automations"},{"title":"الحصول على أتمتة","api":"GET /automations/:id","href":"/ar/apis/automations/get-automation"},{"title":"تحديث الأتمتة","api":"PUT /automations/:id","href":"/ar/apis/automations/update-automation"},{"title":"حذف الأتمتة","api":"DELETE /automations/:id","href":"/ar/apis/automations/delete-automation"},{"title":"الحصول على نشاط الأتمتة","api":"GET /automations/:id/activity","href":"/ar/apis/automations/get-activity"}]},{"group":"Brand","pages":[{"title":"Brand API: بيانات الحسابات العامة والمنافسين","href":"/ar/apis/brand/overview"}]},{"group":"Comments","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات التعليقات","href":"/ar/apis/comments/overview"},{"title":"نشر تعليق","api":"POST /comments","href":"/ar/apis/comments/post-comment"},{"title":"الحصول على التعليقات","api":"GET /comments/:id","href":"/ar/apis/comments/get-comments"},{"title":"حذف التعليقات","api":"DELETE /comments/:id","href":"/ar/apis/comments/delete-comments"},{"title":"الرد على تعليق","api":"POST /comments/reply/:commentId","href":"/ar/apis/comments/reply-to-comment"}]},{"group":"Feed","pages":[{"title":"نظرة عامة على خلاصات RSS","href":"/ar/apis/feeds/overview"},{"title":"إضافة تغذية RSS","api":"POST /feed","href":"/ar/apis/feeds/add-feed"},{"title":"حذف تغذية RSS","api":"DELETE /feed","href":"/ar/apis/feeds/delete-feed"},{"title":"الحصول على خلاصات RSS","api":"GET /feed","href":"/ar/apis/feeds/get-feeds"},{"title":"تحديث خلاصة RSS","api":"PUT /feed","href":"/ar/apis/feeds/update-feed"}]},{"group":"Generate","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات التوليد","href":"/ar/apis/generate/overview"},{"title":"توليد نص المنشور","api":"POST /generate/post","href":"/ar/apis/generate/post-text"},{"title":"إعادة صياغة المنشور","api":"POST /generate/rewrite","href":"/ar/apis/generate/rewrite-post"},{"title":"تفريغ فيديو","api":"POST /generate/transcription","href":"/ar/apis/generate/transcribe-video"},{"title":"ترجمة منشور","api":"POST /generate/translate","href":"/ar/apis/generate/translate-post"},{"title":"توليد النص البديل","api":"POST /generate/altText","href":"/ar/apis/generate/image-alt-text"},{"title":"تحليل المشاعر","api":"POST /generate/sentiment","href":"/ar/apis/generate/sentiment"}]},{"group":"Hashtags","pages":[{"title":"نظرة عامة على واجهة الوسوم (Hashtags)","href":"/ar/apis/hashtags/overview"},{"title":"الهاشتاغات التلقائية","api":"POST /hashtags/auto","href":"/ar/apis/hashtags/auto-hashtags"},{"title":"التحقق من الوسوم المحظورة","api":"GET /hashtags/banned","href":"/ar/apis/hashtags/check-hashtags"},{"title":"التوصية بالوسوم","api":"GET /hashtags/recommend","href":"/ar/apis/hashtags/recommend-hashtags"},{"title":"البحث في الوسوم","api":"GET /hashtags/search","href":"/ar/apis/hashtags/search-hashtags"}]},{"group":"History","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات السجل","href":"/ar/apis/history/overview"},{"title":"سجل المنشورات","api":"GET /history","href":"/ar/apis/history/get-history"},{"title":"سجل المنشور حسب المعرّف","api":"GET /history/:id","href":"/ar/apis/history/get-history-id"},{"title":"الحصول على سجل المنشورات لمنصة تواصل اجتماعي","api":"GET /history/:platform","href":"/ar/apis/history/history-platform"},{"title":"سجل المنشورات حسب المعرّف الاجتماعي","api":"GET /history/:socialId","href":"/ar/apis/history/history-social-id"}]},{"group":"Links","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات الروابط","href":"/ar/apis/links/overview"},{"title":"إنشاء رابط قصير","api":"POST /links","href":"/ar/apis/links/create-short-link"},{"title":"تحديث رابط قصير","api":"PUT /links/:id","href":"/ar/apis/links/update-short-link"},{"title":"تحليلات الروابط","api":"GET /links/:id","href":"/ar/apis/links/link-analytics"}]},{"group":"Listening","pages":[{"title":"واجهة برمجة تطبيقات الاستماع: مراقبة وسائل التواصل الاجتماعي والإشارات","href":"/ar/apis/listen/overview"},{"title":"الحصول على بيانات العلامة التجارية","api":"GET /brand/byUser","href":"/ar/apis/listen/brand-user"},{"group":"Search","pages":[{"title":"البحث في صفحات فيسبوك","api":"GET /brand/search/facebook","href":"/ar/apis/listen/search/fb-page-search"},{"title":"البحث في LinkedIn","api":"GET /brand/search/linkedin","href":"/ar/apis/listen/search/linkedin-search"}]},{"group":"Keyword","pages":[{"title":"البحث عن التغريدات حسب الكلمة المفتاحية","api":"GET /listen/keyword","href":"/ar/apis/listen/keyword/search-tweets"}]}]},{"group":"Media","pages":[{"title":"نظرة عامة على Media API","href":"/ar/apis/media/overview"},{"title":"تحميل صورة أو فيديو","api":"POST /media/upload","href":"/ar/apis/media/upload-media"},{"title":"تحميل ملفات وسائط كبيرة","api":"GET /media/uploadUrl","href":"/ar/apis/media/upload-large-media"},{"title":"التحقق من وجود عنوان URL للوسائط","api":"POST /media/urlExists","href":"/ar/apis/media/verify-media-url"},{"title":"احصل على كل الوسائط في المعرض","api":"GET /media","href":"/ar/apis/media/get-media-in-gallery"},{"title":"تغيير حجم الصورة","api":"POST /media/resize","href":"/ar/apis/media/resize"},{"title":"البيانات الوصفية لملف وسائط","api":"GET /media/meta","href":"/ar/apis/media/get-media-metadata"},{"title":"البحث في صوتيات Instagram","api":"GET /media/instagram/audio/search","href":"/ar/apis/media/search-instagram-audio"},{"title":"الحصول على البيانات الوصفية لصوت Instagram","api":"GET /media/instagram/audio/{audioId}","href":"/ar/apis/media/get-instagram-audio"}]},{"group":"Messages","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات الرسائل","href":"/ar/apis/messages/overview"},{"title":"إرسال رسالة","api":"POST /messages/:platform","href":"/ar/apis/messages/send-message"},{"title":"الحصول على الرسائل","api":"GET /messages/:platform","href":"/ar/apis/messages/get-messages"},{"title":"تحديث الرسائل","api":"PUT /messages/:platform/:conversationId","href":"/ar/apis/messages/update-messages"},{"title":"تعيين الرد التلقائي","api":"POST /messages/autoresponse","href":"/ar/apis/messages/set-auto-response"},{"title":"الحصول على الرد التلقائي","api":"GET /messages/autoresponse","href":"/ar/apis/messages/get-auto-response"}]},{"group":"Post","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات النشر","href":"/ar/apis/post/overview"},{"title":"واجهة نشر منشور: النشر على أي شبكة اجتماعية","api":"POST /post","href":"/ar/apis/post/post"},{"title":"الحصول على منشور","api":"GET /post/:id","href":"/ar/apis/post/get-post"},{"title":"حذف منشور","api":"DELETE /post","href":"/ar/apis/post/delete-post"},{"title":"تحديث منشور","api":"PATCH /post","href":"/ar/apis/post/update-post"},{"title":"إعادة محاولة منشور","api":"PUT /post/retry","href":"/ar/apis/post/retry-post"},{"title":"نسخ منشور","api":"POST /post/copy","href":"/ar/apis/post/copy-post"},{"title":"النشر المجمّع","api":"POST /post/bulk","href":"/ar/apis/post/bulk-post"},{"group":"Social Networks","pages":[{"title":"الشبكات الاجتماعية المدعومة","href":"/ar/apis/post/social-networks/overview"},{"title":"Bluesky API","icon":"bluesky","href":"/ar/apis/post/social-networks/bluesky"},{"title":"واجهة برمجة تطبيقات صفحة Facebook","icon":"facebook","href":"/ar/apis/post/social-networks/facebook"},{"title":"واجهة Google Business Profile","icon":"google","href":"/ar/apis/post/social-networks/google"},{"title":"Instagram API","icon":"instagram","href":"/ar/apis/post/social-networks/instagram"},{"title":"LinkedIn API","icon":"linkedin","href":"/ar/apis/post/social-networks/linkedin"},{"title":"Pinterest API","icon":"pinterest","href":"/ar/apis/post/social-networks/pinterest"},{"title":"Reddit API","icon":"reddit","href":"/ar/apis/post/social-networks/reddit"},{"title":"Snapchat API","icon":"snapchat","href":"/ar/apis/post/social-networks/snapchat"},{"title":"Telegram API","icon":"telegram","href":"/ar/apis/post/social-networks/telegram"},{"title":"Threads API","icon":"threads","href":"/ar/apis/post/social-networks/threads"},{"title":"TikTok API","icon":"tiktok","href":"/ar/apis/post/social-networks/tiktok"},{"title":"X API","icon":"x-twitter","href":"/ar/apis/post/social-networks/x-twitter"},{"title":"YouTube API","icon":"youtube","href":"/ar/apis/post/social-networks/youtube"}]}]},{"group":"Profiles","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات الملفات الشخصية","href":"/ar/apis/profiles/overview"},{"title":"إنشاء ملف تعريف مستخدم","api":"POST /profiles","href":"/ar/apis/profiles/create-profile"},{"title":"حذف User Profile","api":"DELETE /profiles","href":"/ar/apis/profiles/delete-profile"},{"title":"تحديث ملف تعريف مستخدم","api":"PATCH /profiles","href":"/ar/apis/profiles/update-profile"},{"title":"الحصول على ملفات تعريف المستخدمين","api":"GET /profiles","href":"/ar/apis/profiles/get-profiles"},{"title":"إلغاء ربط شبكة تواصل اجتماعي","api":"DELETE /profiles/social","href":"/ar/apis/profiles/unlink-social-network"},{"title":"نظرة عامة على الربط الاجتماعي","href":"/ar/apis/profiles/social-linking-overview"},{"title":"إنشاء Link Session","api":"POST /profiles/link-sessions","href":"/ar/apis/profiles/create-link-session"},{"title":"الحصول على Link Session","api":"GET /profiles/link-sessions/{sessionId}","href":"/ar/apis/profiles/get-link-session"},{"title":"إبطال Link Session","api":"DELETE /profiles/link-sessions/{sessionId}","href":"/ar/apis/profiles/revoke-link-session"},{"title":"إنشاء رابط ربط (generateJWT)","api":"POST /profiles/generateJWT","deprecated":true,"href":"/ar/apis/profiles/generate-jwt"}]},{"group":"Reviews","pages":[{"title":"نظرة عامة على Reviews API","href":"/ar/apis/reviews/overview"},{"title":"الحصول على جميع المراجعات","api":"GET /reviews","href":"/ar/apis/reviews/get-reviews"},{"title":"الحصول على مراجعة واحدة","api":"GET /reviews/:id","href":"/ar/apis/reviews/get-one-review"},{"title":"الرد على مراجعة","api":"POST /reviews","href":"/ar/apis/reviews/reply-review"},{"title":"حذف رد على مراجعة","api":"DELETE /reviews","href":"/ar/apis/reviews/delete-review-reply"}]},{"group":"User","pages":[{"title":"نظرة عامة على واجهة برمجة تطبيقات ملف المستخدم","href":"/ar/apis/user/overview"},{"title":"تفاصيل ملف المستخدم","api":"GET /user","href":"/ar/apis/user/profile-details"},{"title":"لوحات Pinterest","api":"GET /user/details/pinterest","href":"/ar/apis/user/pinterest-board"},{"title":"تحديث المستخدم","api":"PATCH /user/:platform","href":"/ar/apis/user/update-user"},{"title":"ملف WhatsApp التجاري","api":"GET /user/details/whatsapp","href":"/ar/apis/user/whatsapp-profile"},{"title":"جلب جميع المستخدمين دفعةً واحدة","api":"GET /user/batch","href":"/ar/apis/user/batch-all-users"}]},{"group":"Utils","pages":[{"title":"حالة طلب المتعاون","api":"GET /post/collaborators/:id","href":"/ar/apis/utils/instagram-get-collaborator"},{"title":"Reddit Flair","api":"GET /post/redditFlair/:subreddit","href":"/ar/apis/utils/reddit-get-flair"},{"title":"عمليات بحث المستخدمين","api":"GET /user/lookups","href":"/ar/apis/utils/user-lookups"},{"group":"YouTube","pages":[{"title":"فئات YouTube","api":"GET /post/youtubeCategories/:region","href":"/ar/apis/utils/youtube-categories"},{"title":"تعيين علامة مائية لـ YouTube","api":"POST /post/youTubeWatermark","href":"/ar/apis/utils/set-youtube-watermark"},{"title":"إزالة العلامة المائية لـ YouTube","api":"DELETE /post/youTubeWatermark","href":"/ar/apis/utils/remove-youtube-watermark"}]}]},{"group":"Validate","pages":[{"title":"نظرة عامة على Validate API","href":"/ar/apis/validate/overview"},{"title":"التحقق من الوسائط","href":"/ar/apis/validate/validate-media"},{"title":"التحقق من طول المنشور","api":"POST /validate/postLength","href":"/ar/apis/validate/check-post-length"},{"title":"التحقق من وجود Subreddit","api":"GET /validate/redditExists/:subreddit","href":"/ar/apis/validate/check-subreddit"},{"title":"الإشراف على المحتوى","api":"POST /validate/moderation","href":"/ar/apis/validate/moderation"},{"title":"التحقق من صحة JSON","api":"POST /validate/json","href":"/ar/apis/validate/validate-json"},{"title":"التحقق من صحة المنشور","api":"POST /validate/post","href":"/ar/apis/validate/validate-post"}]},{"group":"Webhooks","pages":[{"title":"نظرة عامة على Webhooks","href":"/ar/apis/webhooks/overview"},{"title":"إجراءات Webhook","href":"/ar/apis/webhooks/actions"},{"title":"تسجيل Webhook","api":"POST /hook/webhook","href":"/ar/apis/webhooks/register"},{"title":"إلغاء تسجيل Webhook","api":"DELETE /hook/webhook","href":"/ar/apis/webhooks/unregister"},{"title":"تدوير المفتاح السري للتوقيع","api":"POST /hook/webhook/secret","href":"/ar/apis/webhooks/rotate-signing-secret"},{"title":"سرد Webhooks المسجلة","api":"GET /hook/webhook","href":"/ar/apis/webhooks/list"},{"title":"سجل Webhook","api":"GET /hook/history","href":"/ar/apis/webhooks/history"}]}]},{"group":"Multiple Users","pages":[{"title":"خطة Launch: خطة Business متعددة المستخدمين للمبتدئين","href":"/ar/multiple-users/business-launch-overview"},{"title":"نظرة عامة على Business Plan","href":"/ar/multiple-users/business-plan-overview"},{"title":"تكامل المستخدم","href":"/ar/multiple-users/user-integration"},{"title":"تكامل واجهة API للأعمال","href":"/ar/multiple-users/api-integration-business"},{"title":"أداة Ayrshare Connect","href":"/ar/multiple-users/connect-widget"},{"title":"ابنِ نافذة الربط المنبثقة الخاصة بك","href":"/ar/multiple-users/connect-direct-mode"},{"title":"أحداث اكتمال الربط","href":"/ar/multiple-users/link-completion-events"},{"title":"إدارة ملفات مستخدمين متعددة","href":"/ar/multiple-users/manage-user-profiles"}]},{"group":"Dashboard","pages":[{"title":"نظرة عامة على لوحة تحكم Ayrshare","href":"/ar/dashboard/overview"},{"group":"Connect Social Accounts","pages":[{"title":"ربط حسابات وسائل التواصل الاجتماعي","href":"/ar/dashboard/connect-social-accounts/overview"},{"title":"ربط Bluesky","icon":"bluesky","href":"/ar/dashboard/connect-social-accounts/bluesky"},{"title":"ربط فيسبوك","icon":"facebook","href":"/ar/dashboard/connect-social-accounts/facebook"},{"title":"ربط Google Business Profile","icon":"google","href":"/ar/dashboard/connect-social-accounts/google-business"},{"title":"ربط Instagram","icon":"instagram","href":"/ar/dashboard/connect-social-accounts/instagram"},{"title":"ربط LinkedIn","icon":"linkedin","href":"/ar/dashboard/connect-social-accounts/linkedin"},{"title":"ربط Pinterest","icon":"pinterest","href":"/ar/dashboard/connect-social-accounts/pinterest"},{"title":"ربط Reddit","icon":"reddit","href":"/ar/dashboard/connect-social-accounts/reddit"},{"title":"ربط Snapchat","icon":"snapchat","href":"/ar/dashboard/connect-social-accounts/snapchat"},{"title":"ربط مجموعة أو قناة Telegram بـ Ayrshare","icon":"telegram","href":"/ar/dashboard/connect-social-accounts/telegram"},{"title":"ربط Threads","icon":"threads","href":"/ar/dashboard/connect-social-accounts/threads"},{"title":"ربط TikTok","icon":"tiktok","href":"/ar/dashboard/connect-social-accounts/tiktok"},{"title":"إعداد مفتاح X API الخاص بك","icon":"x-twitter","href":"/ar/dashboard/connect-social-accounts/x-twitter-byo-keys"},{"title":"ربط X","icon":"x-twitter","href":"/ar/dashboard/connect-social-accounts/x-twitter"},{"title":"ربط YouTube","icon":"youtube","href":"/ar/dashboard/connect-social-accounts/youtube"}]},{"title":"كيفية نشر منشورات وسائل التواصل الاجتماعي","href":"/ar/dashboard/publish-post"},{"title":"عرض JSON","href":"/ar/dashboard/view-json"},{"title":"إلغاء الوصول إلى وسائل التواصل الاجتماعي","href":"/ar/dashboard/revoke-access"},{"group":"RSS","pages":[{"title":"خلاصات RSS وSubstack وYouTube","href":"/ar/dashboard/automated-rss-feeds"},{"title":"العثور على عنوان URL لتغذية RSS","href":"/ar/dashboard/find-rss"}]}]},{"group":"Additional","pages":[{"group":"What's New At Ayrshare","pages":[{"title":"أحدث التحديثات","href":"/ar/whatsnew/latest"},{"title":"أرشيف التحديثات","href":"/ar/whatsnew/archive"},{"title":"تغييرات API القادمة","mode":"wide","href":"/ar/whatsnew/upcoming-api-changes"}]},{"group":"Errors","pages":[{"title":"نظرة عامة على الأخطاء","href":"/ar/errors/overview"},{"title":"رموز حالة HTTP","href":"/ar/errors/errors-http"},{"title":"رموز أخطاء Ayrshare","href":"/ar/errors/errors-ayrshare"}]},{"title":"Max Pack","mode":"wide","href":"/ar/additional/maxpack"},{"group":"Media Guidelines","pages":[{"title":"متطلبات الصور والفيديو على وسائل التواصل الاجتماعي","href":"/ar/media-guidelines/overview"},{"title":"Bluesky","icon":"bluesky","href":"/ar/media-guidelines/bluesky"},{"title":"صفحات Facebook","icon":"facebook","href":"/ar/media-guidelines/facebook-pages"},{"title":"Google Business Profile","icon":"google","href":"/ar/media-guidelines/google-business-profile"},{"title":"إنستجرام","icon":"instagram","href":"/ar/media-guidelines/instagram"},{"title":"LinkedIn","icon":"linkedin","href":"/ar/media-guidelines/linkedin"},{"title":"Pinterest","icon":"pinterest","href":"/ar/media-guidelines/pinterest"},{"title":"Reddit","icon":"reddit","href":"/ar/media-guidelines/reddit"},{"title":"Snapchat","icon":"snapchat","href":"/ar/media-guidelines/snapchat"},{"title":"Telegram","icon":"telegram","href":"/ar/media-guidelines/telegram"},{"title":"Threads","icon":"threads","href":"/ar/media-guidelines/threads"},{"title":"TikTok","icon":"tiktok","href":"/ar/media-guidelines/tiktok"},{"title":"WhatsApp","icon":"whatsapp","href":"/ar/media-guidelines/whatsapp"},{"title":"X","icon":"x-twitter","href":"/ar/media-guidelines/x-twitter"},{"title":"YouTube","icon":"youtube","href":"/ar/media-guidelines/youtube"}]},{"group":"Packages \u0026 Guides","pages":[{"title":"نظرة عامة على SDKs وأدلة تكامل Ayrshare","mode":"wide","href":"/ar/packages-guides/overview"},{"title":"Airtable","href":"/ar/packages-guides/airtable"},{"title":"Bubble.io","href":"/ar/packages-guides/bubble"},{"title":"Flutter","href":"/ar/packages-guides/flutter"},{"title":"FlutterFlow","href":"/ar/packages-guides/flutterflow"},{"title":"Make","href":"/ar/packages-guides/make"},{"title":"n8n","href":"/ar/packages-guides/n8n"},{"title":"Node.js NPM","href":"/ar/packages-guides/nodejs"},{"title":"Notion","href":"/ar/packages-guides/notion"},{"title":"Python PyPI","href":"/ar/packages-guides/python"},{"title":"Retool","href":"/ar/packages-guides/retool"}]},{"title":"حالة النظام","href":"/ar/additional/status"},{"group":"Testing \u0026 Verification","pages":[{"title":"Hurl","href":"/ar/testing/hurl"},{"title":"نقاط نهاية التحقق (Validation Endpoints)","href":"/ar/testing/validation-endpoints"},{"title":"Postman","href":"/ar/testing/postman"},{"title":"التحقق من المنشورات","href":"/ar/testing/post-verification"}]},{"group":"ISO Codes","pages":[{"title":"رموز الدول","href":"/ar/iso-codes/country"},{"title":"رموز اللغات","href":"/ar/iso-codes/language"}]}]}]},{"anchor":"Help Center","icon":"lightbulb","pages":[{"title":"Help Center","href":"/ar/help-center/overview"}]}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/zh-Hans/apis/ads/instagram/get-ad-insights"}]},{"language":"zh-Hant","pages":[{"title":"zh-Hant","href":"/zh-Hant/apis/ads/instagram/get-ad-insights"}]}]},"basePath":"","title":"الرؤى - Ayrshare Docs","deploymentId":"dpl_CFbeYcBupdGZjfVqbRSLXa1aokj1","buildId":"dpl_CFbeYcBupdGZjfVqbRSLXa1aokj1","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-C5_4BIxl.js","snippetPresets-De8eFKTP.js","utils-DqxsIfn0.js","style-to-object-BY3JEAdk.js","utils-6jv9vlCo.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-D9GOYqmT.js","conditional-requirements-CFM0id0Q.js","cloneDeep-d0XxWgEP.js","_Uint8Array-C5dI0k_o.js","isObject-FP1Yky1u.js","ApiExamples-BlmjaTZ_.js","usePlaygroundInputsStore-B3tvnLMl.js","shallow-Dm1yzv7C.js","isEqual-DDKjFPBV.js","CodeSnippets-nlgbnOm-.js","CodeSnippet-Chrw1IQB.js","getApiPlaygroundDisplay-B13iPCI4.js","Page-CbA7GmUI.js","DynamicMarkdown-C-ETkiXU.js","SectionHeading-UD4HZLdm.js","icon-COQrGsHB.js","MethodPill-C0GaUnBC.js","getPastedJson-BiCCW2gz.js","Check2Icon-Bd8dHgOe.js","axios-CsQoIw0U.js"]}