اگر تا حالا دنبال یک API قدرتمند برای اضافه کردن قابلیت جستوجوی وب و پاسخدهی هوشمند به پروژههای هوش مصنوعی خودتون بودید، احتمالاً اسم you.com به گوشتون خورده. این سرویس یکی از معدود ارائهدهندههایی است که بدون نیاز به کارت بانکی، از همان لحظه ثبتنام ۱۰۰ دلار کردیت رایگان در اختیارتان میگذارد تا API را واقعی امتحان کنید، نه فقط با یک نسخهی محدود و آزمایشی.
در این مقاله قدمبهقدم میبینیم که you.com دقیقاً چه چیزی ارائه میدهد، چطور اکانت بسازید، کردیت رایگان را فعال کنید و اولین درخواست واقعی خودتان را به API بفرستید.

به زبان ساده، یک API هوش مصنوعی راهی است که برنامهی شما بدون نیاز به رابط کاربری، مستقیم با یک سرویس هوشمند صحبت کند: یک درخواست میفرستید (مثلاً یک سؤال یا یک عبارت جستوجو) و پاسخی ساختیافته و آمادهی مصرف در کدتان تحویل میگیرید.
مشکل اصلی توسعهدهندگان و استارتاپها معمولاً همینجاست: قبل از اینکه مطمئن شوید یک سرویس واقعاً بهدرد پروژهتان میخورد، باید هزینه کنید. اینجاست که کردیت رایگان اهمیت پیدا میکند؛ فرصتی برای تست واقعی، بدون ریسک مالی.
you.com دقیقاً همین جای خالی را پر میکند. برخلاف بسیاری از سرویسها که فقط چند دلار ناچیز یا یک بازهی زمانی کوتاه هدیه میدهند، you.com از همان اول ثبتنام، ۱۰۰ دلار کردیت رایگان و بدون نیاز به کارت بانکی در اختیار کاربر قرار میدهد. نکتهی مهم این است که you.com یک ارائهدهندهی مدلهای زبانی مثل GPT یا Claude نیست؛ بلکه تمرکزش روی چیزی است که در دنیای هوش مصنوعی کمتر به آن پرداخته میشود ولی بههمان اندازه حیاتی است: دسترسی هوشمند و لحظهای به وب. یعنی میتوانید مدل زبانی دلخواه خودتان (چه GPT، چه Claude، چه هر مدل دیگری) را با اطلاعات تازه و واقعی از اینترنت تغذیه کنید، بدون اینکه خودتان موتور جستوجو یا خزندهی وب بسازید.
قبل از ورود به مراحل ثبتنام، بهتر است بدانید دقیقاً چه چیزی در انتظارتان است. you.com پنج API مجزا ارائه میدهد که همگی حول یک محور مشترک میچرخند: هوش وب لحظهای. هرکدام از این APIها برای یک نوع کاربرد خاص طراحی شدهاند.

تفاوت Web Search API و Answer API
Web Search API خامترین لایهی سرویس است: عبارت جستوجو را میفرستید و نتایج وب و اخبار را بهصورت JSON ساختیافته و آماده برای تزریق به پرامپت مدل زبانیتان دریافت میکنید. این گزینه مناسب کسانی است که میخواهند خودشان روی نتایج خام کنترل کامل داشته باشند و منطق synthesis (ترکیب و جمعبندی) را خودشان در سمت اپلیکیشن پیاده کنند.
Answer API یک قدم جلوتر میرود: بهجای نتایج خام، یک پاسخ نهایی و آماده بههمراه استنادهای درونمتنی (inline citations) برمیگرداند. هر استناد قبل از بازگشت، در برابر متن منبع اصلی راستیآزمایی میشود؛ یعنی میتوانید مطمئن باشید عبارتی که بهعنوان مدرک نشان داده شده، واقعاً در آن صفحه وجود دارد. اگر میخواهید سریعترین مسیر از «سؤال» تا «پاسخ مستند» را طی کنید، بدون اینکه خودتان orchestration انجام دهید، این API انتخاب بهتری است.
کاربرد Contents API، Research API و Finance Research API
Contents API برای زمانی است که آدرس دقیق چند صفحهی وب را دارید (مثلاً صفحهی قیمتگذاری رقبا) و میخواهید محتوای تمیز آنها را بهشکل Markdown یا HTML استخراج کنید، بدون درگیر شدن با پارس کردن HTML یا اتوماسیون مرورگر.
Research API برای سؤالهای پیچیدهتر طراحی شده است؛ جایی که یک جستوجوی ساده کافی نیست. این API چندین جستوجوی پیدرپی انجام میدهد، منابع را میخواند و یک پاسخ جامع و مستند تولید میکند. عمق تحقیق را میتوانید با پارامتر research_effort از حالت سبک (lite) تا فوقسنگین (frontier) تنظیم کنید.
Finance Research API نسخهی تخصصی همین ابزار برای حوزهی مالی است: بهجای وب باز، روی گزارشهای SEC، قیمت سهام، دادههای بنیادی و اخبار مالی جستوجو میکند. برای تحلیل گزارشهای سالانه، due diligence یا تحقیقات بازار مالی گزینهی مناسبی است.
مراحل ساخت اکانت رایگان در you.com
ساخت اکانت در you.com فرآیندی سریع و بدون پیچیدگی است و در چند دقیقه کامل میشود.

ثبتنام اولیه و تایید حساب
برای شروع کافی است به آدرس you.com/platform بروید و روی گزینهی ساخت حساب کاربری کلیک کنید. میتوانید با ایمیل معمولی ثبتنام کنید یا از گزینههای ورود سریع استفاده کنید. بعد از وارد کردن اطلاعات پایه، یک ایمیل تأیید برایتان ارسال میشود؛ با کلیک روی لینک داخل آن ایمیل، حساب شما فعال شده و میتوانید وارد پنل کاربری (Platform Dashboard) شوید. تا این مرحله هیچ نیازی به وارد کردن اطلاعات کارت بانکی نیست.
کردیت خوشآمدگویی ۱۰۰ دلاری: چه زمانی و چطور بعد از ثبتنام فعال میشه
نکتهای که you.com را از خیلی از رقبا متمایز میکند، همینجاست. بلافاصله بعد از تأیید ایمیل و ورود موفق به پنل، ۱۰۰ دلار کردیت رایگان بهصورت خودکار در حساب شما فعال میشود؛ بدون اینکه لازم باشد کارت بانکی ثبت کنید یا مرحلهی اضافهای طی کنید. این کردیت را میتوانید در بخش Billing یا داشبورد اصلی پنل مشاهده کنید.
این مبلغ برای مصرف در هرکدام از پنج API قابل استفاده است و مبنای پرداخت شما هم pay-as-you-go است؛ یعنی فقط بهاندازهی مصرف واقعی از این کردیت کم میشود. برای مثال، هر ۱۰۰۰ فراخوانی Web Search API چیزی حدود ۵ دلار از این کردیت را مصرف میکند؛ یعنی با ۱۰۰ دلار کردیت اولیه میتوانید هزاران درخواست را بدون پرداخت هیچ هزینهای تست کنید.

دریافت ۱۰۰ دلار کردیت اضافی با تکمیل پروفایل حساب
خبر خوب اینجاست که کردیت رایگان شما لزوماً به همان ۱۰۰ دلار اول ختم نمیشود. you.com یک مرحلهی دوم هم دارد که با تکمیل پروفایل حساب، ۱۰۰ دلار کردیت اضافی (در مجموع ۲۰۰ دلار) به شما تعلق میگیرد.
برای رسیدن به این مرحله دو راه دارید:
- از همان داشبورد اصلی پنل کاربری، روی بنر یا لینک مربوط به تکمیل پروفایل (Continue your profile / Get additional credits) کلیک کنید.
- یا مستقیماً به آدرس زیر بروید:
https://you.com/platform/incentive/continue
در این صفحه یک فرم کوتاه از شما خواسته میشود که شامل فیلدهای زیر است:
- First name / Last name: نام و نامخانوادگی
- Valid work email: ایمیل کاری معتبر
- What is your role? نقش شما در سازمان (از یک لیست کشویی انتخاب میشود)
- What do you plan to do here? توضیح کوتاهی از اینکه قصد دارید با API چه کاری انجام دهید
نکتهی مهم همین جاست: در فیلد ایمیل، سیستم صراحتاً اعلام میکند که ایمیلهای رایگان و عمومی مثل Gmail و Outlook پذیرفته نمیشوند و باید یک ایمیل با دامنهی اختصاصی (مثلاً something@yourcompany.com) وارد کنید. دلیل این محدودیت هم روشن است: این کردیت اضافه برای شناسایی کاربران و کسبوکارهای واقعی طراحی شده، نه برای کسانی که با چند اکانت Gmail مختلف چند بار همین فرم را پر میکنند. فیلتر دامنهی اختصاصی راه ساده و مؤثری است برای جلوگیری از این نوع سوءاستفاده.
راههای سریع و قانونی تهیه ایمیل با دامنه شخصی
خبر خوب این است که داشتن یک ایمیل با دامنهی اختصاصی، حتی اگر صاحب کسبوکار رسمی نباشید، کار پرهزینه یا پیچیدهای نیست. چند گزینهی عملی:
- ثبت یک دامنهی ارزان: ثبت یک دامنهی
.com یا .io معمولاً سالانه چند دلار هزینه دارد (از ثبتکنندههایی مثل Namecheap یا Cloudflare Registrar). - فعالسازی ایمیل روی دامنه، بهصورت رایگان: بعد از ثبت دامنه، لازم نیست هزینهی اضافهای برای هاست ایمیل بدهید. سرویسهایی مثل Cloudflare Email Routing یا ImprovMX بهصورت رایگان اجازه میدهند ایمیلهای
you@yourdomain.com را مستقیماً به Gmail یا هر ایمیل شخصی خودتان فوروارد کنید؛ یعنی هم آدرس ایمیل با دامنهی اختصاصی دارید، هم پیامها را در همان اینباکس همیشگیتان میبینید. - استفاده از دامنهای که از قبل دارید: اگر یک وبسایت شخصی، پورتفولیو یا پروژهای با دامنهی اختصاصی دارید، همان دامنه هم برای این فرم کافی است؛ نیازی نیست حتماً دامنهی جدید بخرید.
بعد از پر کردن فرم با یک ایمیل واقعی و دارای دامنهی اختصاصی، معمولاً یک کد تأیید به همان ایمیل ارسال میشود. کد را در همان صفحه وارد کنید تا مرحله تکمیل شود؛ بهمحض تأیید، کردیت حساب شما از ۱۰۰ به ۲۰۰ دلار افزایش پیدا میکند.

ترفند تهیه ایمیل اختصاصی
راه دیگر برای عبور از این مرحله استفاده از ایمیل موقت هست که با جست و جو در گوگل میتوانید به این سرویس ها دسترسی داشته باشید برای گذراندن این مرحله و دریافت 100 دلار اعتبار بیشتر.
راه دیگر استفادهی رایگان: سرور MCP بدون نیاز به ثبتنام
یکی از نکاتی که کمتر جایی به آن اشاره میشود این است که you.com حتی برای کسانی که هنوز اکانت نساختهاند هم یک مسیر رایگان دارد. اگر از ابزارهای مبتنی بر MCP (مثل Claude Code، Cursor، VS Code یا JetBrains) استفاده میکنید، کافی است ابزار خود را به آدرس زیر متصل کنید تا بدون هیچ کلید API یا ثبتنامی، از قابلیت جستوجوی وب استفاده کنید:

تبریک میگوییم اگر تا اینجا مارو همراهی کرده باشید الان شما 200 دلار اعتبار رایگان api هوش مصنوعی از you.com دریافت کردید.
https://api.you.com/mcp?profile=free
این مسیر رایگان محدود به ۱۰۰ درخواست جستوجو در روز است و فقط ابزار you-search را پوشش میدهد. برای دسترسی به ابزارهای دیگر (you-answer، you-contents، you-research و you-finance) و سقف بالاتر، باید همان مسیر گرفتن API Key را طی کنید که در بخش بعد توضیح داده میشود. این گزینه برای تست سریع یا پروژههای شخصی کوچک، قبل از تعهد به ساخت اکانت کامل، بسیار کاربردی است.
ساخت و دریافت API Key از پنل کاربری you.com
وقتی حساب شما فعال شد و کردیت رایگان را در داشبورد دیدید، وقت گرفتن کلید واقعی API فرا میرسد. مسیر کار اینطور است:
- وارد پنل کاربری در آدرس you.com/platform شوید.
- به بخش مربوط به API Keys در منوی مدیریت حساب بروید.
- روی گزینهی ساخت کلید جدید (Create API Key) کلیک کنید.
- کلید تولیدشده را کپی کرده و در جایی امن نگه دارید، چون معمولاً بعد از بستن پنجره دیگر بهصورت کامل نمایش داده نمیشود.
بهترین روش برای استفاده از این کلید در پروژهها این است که آن را بهعنوان یک متغیر محیطی (environment variable) با نام استاندارد YOUR_API_KEY تنظیم کنید؛ این همان نامی است که در تمام مستندات، SDKها و نمونهکدهای رسمی you.com استفاده شده است:
from youdotcom import You
export YOUR_API_KEY="کلید-شما"
with You(api_key_auth="YOUR_API_KEY") as you:
قبل از نوشتن هر خط کد، سری به مستندات رسمی بزنید: docs.you.com. این مستندات چند بخش کلیدی دارد که خوب است بشناسیدشان:
- Quickstart: سریعترین راه برای گرفتن کلید و ارسال اولین درخواست، با نمونهکد آماده برای Python، TypeScript و cURL.
- API Reference: توضیح کامل هر endpoint، پارامترهای ورودی و ساختار پاسخ برای هرکدام از پنج API.
- Rate Limits: سقف تعداد درخواستها در بازههای زمانی مختلف، که برای برنامهریزی مصرف کردیت اهمیت دارد.
- Billing: جزئیات کامل قیمتگذاری هر API به ازای هر هزار فراخوانی.
نکتهی جالب این است که you.com یک قابلیت خاص برای خود مستندات هم دارد: کافی است به انتهای هر آدرس صفحه، پسوند .md اضافه کنید تا نسخهی متنی و خام (Markdown) همان صفحه را دریافت کنید؛ چیزی که مخصوصاً برای تغذیهی مستندات به ایجنتهای هوش مصنوعی طراحی شده است.
پیادهسازی و تست عملی API با کد نمونه
وقت آن رسیده که همهچیز را کنار هم بگذاریم و اولین درخواست واقعی را بفرستیم.
نمونه کد فراخوانی Web Search API
سادهترین راه استفاده از پایتون، نصب SDK رسمی you.com است:
و بعد یک جستوجوی ساده:
from youdotcom import You
with You(api_key_auth="YOUR_API_KEY") as you:
response = you.search(
query="چه عواملی باعث کاهش نرخ زاد و ولد جهانی شدهاند؟",
)
print(response.answer)
print(f"\n--- {len(response.citations or [])} استناد ---")
for i, citation in enumerate(response.citations or [], 1):
print(f"[{i}] {citation.source}")
اگر ترجیح میدهید مستقیم با cURL کار کنید (بدون نصب هیچ کتابخانهای)، کافی است هدر X-API-Key را با کلید خودتان تنظیم کنید و درخواست را به endpoint مربوط به Web Search API بفرستید؛ ساختار دقیق و آدرس کامل را در بخش «Web Search API» مستندات رسمی پیدا میکنید.
اگر بهجای نتایج خام، یک پاسخ نهایی و مستند نیاز دارید، Answer API گزینهی بهتری است:
from youdotcom import You
with You(api_key_auth="YOUR_API_KEY") as you:
response = you.answer(
query="چه عواملی باعث کاهش نرخ زاد و ولد جهانی شدهاند؟",
)
print(response.answer)
print(f"\n--- {len(response.citations or [])} استناد ---")
for i, citation in enumerate(response.citations or [], 1):
print(f"[{i}] {citation.source}")
پاسخ این درخواست، یک متن Markdown با استنادهای شمارهگذاریشده و لیست منابع واقعی است که هر ادعا از آنها استخراج شده.

مدیریت خطاهای رایج در فراخوانی API
در مسیر استفاده از API، معمولاً با چند نوع خطا مواجه میشوید:
- کلید نامعتبر یا منقضی (Invalid API Key): معمولاً به این معناست که کلید را اشتباه کپی کردهاید یا فضای خالی اضافه در ابتدا/انتهای آن باقی مانده. کلید را دوباره از پنل کپی کنید.
- اتمام کردیت (Insufficient Credits): وقتی کردیت رایگان شما تمام شود، درخواستهای بعدی رد میشوند تا زمانی که روش پرداخت فعال کنید یا کردیت جدید اضافه شود. مصرف را از طریق داشبورد آنالیتیکس پیگیری کنید تا غافلگیر نشوید.
- عبور از سقف نرخ (Rate Limit Exceeded): اگر در بازهی زمانی کوتاه تعداد زیادی درخواست بفرستید، ممکن است موقتاً محدود شوید. جزئیات دقیق سقفها را در صفحهی Rate Limits مستندات ببینید و در صورت نیاز، درخواستها را با تأخیر کوتاه (backoff) پخش کنید.
جمعبندی و توصیههای نهایی برای استفاده بهینه از کردیت رایگان you.com
مسیری که طی کردیم این بود: آشنایی با پنج API واقعی you.com (Web Search، Answer، Contents، Research و Finance Research)، ساخت یک اکانت رایگان در چند دقیقه، دریافت خودکار ۱۰۰ دلار کردیت بدون نیاز به کارت بانکی، و در نهایت گرفتن کلید API و ارسال اولین درخواست واقعی.
چند توصیهی عملی برای مدیریت بهتر این کردیت:
- قبل از ساخت هر پروژهی جدی، ابتدا با مسیر رایگان MCP (بدون کلید) تست کنید تا مطمئن شوید کیفیت نتایج مناسب پروژهتان است.
- برای کارهایی که فقط به دادهی خام نیاز دارند، سراغ Web Search API بروید که ارزانترین گزینه است؛ Answer و Research را برای زمانی نگه دارید که واقعاً به پاسخ نهایی و مستند نیاز دارید، چون قیمت بالاتری دارند.
- مصرف کردیت را مرتب از داشبورد آنالیتیکس پیگیری کنید تا قبل از اتمام آن غافلگیر نشوید.
اگر تا اینجا مقاله را دنبال کردهاید، تنها قدم باقیمانده ساخت حساب در you.com/platform و ارسال اولین درخواست واقعی است؛ کاری که کمتر از ده دقیقه زمان میبرد.