Delivered-To: tjphuhs@gmail.com Received: by 2002:adf:f0d2:0:b0:441:282b:bd with SMTP id x18csp671516wro; Tue, 28 Apr 2026 12:57:03 -0700 (PDT) X-Received: by 2002:a05:690e:4843:b0:64e:a765:ef82 with SMTP id 956f58d0204a3-65beed818e3mr3264365d50.24.1777406222927; Tue, 28 Apr 2026 12:57:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1777406222; cv=none; d=google.com; s=arc-20240605; b=DcSrnoS6UDhEVbDSyTko7akNqLpaxqDaisNzUAS0VvhRCfyoQrINiCBzFkHaH5oiGV 6XQgTxtsEBomfTQHkP/YMoJZyt1X+fHLwuYrxazPm7mD0T8h39+Kx2iep7bQkGYq6oRa o368WNtvIHgaj0EoZvdDSff7XK2mB9eThFgSzLH3daDqbvMteNFTl89GIt6aoTrJGMON qMaUV3UX5ocKBEzH5l/1SakRZDJIj33udUMJJMAALZuweedOm0Iiia78xXMwIqm4zfZb 4WEyoM2/9QcnVZRqJgGvjgBcmezJvlRjCr0R2XcatmIh3D+lNqdIhaQRk8NOJyQPTxkT qUGQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=reply-to:subject:mime-version:date:to:list-unsubscribe-post :list-unsubscribe:message-id:from:dkim-signature; bh=oa3buXvQTb5LJA9A2pfr4TEX2ncYsq61rjrw/s06KJA=; fh=9zP21OW67FFZD2VV42mGudo540Qp4aalMWxJB5kMYug=; b=Z0ZnZ9LBbY9u7BZd4F4/SkxBYVAjbbgR7j5nU7b5TJWyor/dwb2Uq8HNdsldcRZr2r V5cMO5pE+UOQDhxhei5cfLgf+6cRgTu7HMm3zPZoR3+nZybEpyKQp6o69e3/wMu3y3bO zQJ5MjzZelVvPBvBYBNGFITdJi9Lo0goMBvdPMgcJtuGx4FY6Pnhoub8NkgBxjVpeZMi tgxJZm37BLXxjCzlsgF4kalXD9Em4+BRzcxggosvspWSjdZd/U6L90GQaWYOd6J1Iw19 m9KsENbGEzJUaHA1U33HxeTQ7Auwp2jloEQrByd9fWzc+HMSQifdeIESL5brM6EwJJee 1d8g==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@mail.you.com header.s=scph1123 header.b="t47cYB9/"; spf=pass (google.com: domain of msprvs1=20578pfgi0xdt=bounces-266693-1082@mail.you.com designates 137.22.227.75 as permitted sender) smtp.mailfrom="msprvs1=20578pFGi0XDt=bounces-266693-1082@mail.you.com"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=mail.you.com Return-Path: Received: from ipyoyc3c.mail.you.com (ipyoyc3c.mail.you.com. [137.22.227.75]) by mx.google.com with ESMTPS id 956f58d0204a3-65bee5794b1si2889128d50.265.2026.04.28.12.57.02 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Apr 2026 12:57:02 -0700 (PDT) Received-SPF: pass (google.com: domain of msprvs1=20578pfgi0xdt=bounces-266693-1082@mail.you.com designates 137.22.227.75 as permitted sender) client-ip=137.22.227.75; Authentication-Results: mx.google.com; dkim=pass header.i=@mail.you.com header.s=scph1123 header.b="t47cYB9/"; spf=pass (google.com: domain of msprvs1=20578pfgi0xdt=bounces-266693-1082@mail.you.com designates 137.22.227.75 as permitted sender) smtp.mailfrom="msprvs1=20578pFGi0XDt=bounces-266693-1082@mail.you.com"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=mail.you.com Return-Path: X-MSFBL: GODerA3nATijJDwIc5Ya6LyEaKwYTXEOwDt0SNyTVhc=|eyJ0ZW5hbnRfaWQiOiJ zcGMiLCJyIjoidGpwaHVoc0BnbWFpbC5jb20iLCJtZXNzYWdlX2lkIjoiNjllYTB lMTFmMTY5NWYwODA3NDEiLCJjdXN0b21lcl9pZCI6IjI2NjY5MyIsInN1YmFjY29 1bnRfaWQiOiIxMDgyIn0= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mail.you.com; s=scph1123; t=1777406222; i=@mail.you.com; bh=oa3buXvQTb5LJA9A2pfr4TEX2ncYsq61rjrw/s06KJA=; h=From:Message-ID:List-Unsubscribe:List-Unsubscribe-Post:To:Date: Content-Type:Subject:From:To:Cc:Subject; b=t47cYB9/JK17kCdLInWFVNT8vXElK3bbye5Hq5sJVpOdfKF/WQiObnNex2+BvFYKL 5x9hUPb9cFZfcSGdgfspmGKGc4bHhnTXGjoK3zQFK2BJGalVqMzHfJfTzBZLPLoWVA D5S9Kqfzs9Lq5EIdrCh+xxU6vMFLpExQjv/+8rkA= Received: from [10.90.45.128] ([10.90.45.128]) by i-0d30c95384645a9ef.mta1vrest.sd.prd.sparkpost (ecelerity 5.2.0.75597 r(msys-ecelerity:tags/5.2.0.19)) with REST id 14/78-25436-E0111F96; Tue, 28 Apr 2026 19:57:02 +0000 From: "You.com Product Team" Message-ID: <14.78.25436.E0111F96@i-0d30c95384645a9ef.mta1vrest.sd.prd.sparkpost> List-Unsubscribe: , List-Unsubscribe-Post: List-Unsubscribe=One-Click To: tjphuhs@gmail.com Date: Tue, 28 Apr 2026 19:57:02 +0000 Content-Type: multipart/alternative; boundary="_----z0Oy9Umov9gJgrMWIH3dLA===_2F/68-25436-E0111F96" MIME-Version: 1.0 Subject: New in Research API: source control & structured output Reply-To: support@you.com --_----z0Oy9Umov9gJgrMWIH3dLA===_2F/68-25436-E0111F96 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="UTF-8" Control where results come from and get structured JSON back.=0ANow availab= le in the Research API. We just shipped new=0Acapabilities in the Resea= rch API that give you more control over=0Ahow answers are generated and how= you use them downstream.=0A=0A********************************************= *******=0AIntroducing: Source control & structured output=0A***************= ************************************=0A=0AWith these updates, you can now c= ontrol both:=0A=0A* Where the model looks during research=0A* How the respo= nse is returned to your application=0A=0A----------------------------------= -----------------=0AControl where results come from with source_control=0A= =0A---------------------------------------------------=0A=0AYou can now con= strain which web sources the research agent=0Asearches and visits:=0A=0A* i= nclude_domains - Restrict results to a list of trusted=0Adomains (up to 500= ). This is useful when you need research scoped=0Aexclusively to known, aut= horitative sources=0A* exclude_domains - Block specific domains from both s= earch=0Aresults and agent browsing (up to 500)=0A* freshness - Filter by re= cency (=E2=80=9Cday=E2=80=9D, =E2=80=9Cweek=E2=80=9D, =E2=80=9Cmonth=E2=80= =9D, =E2=80=9Cyear=E2=80=9D,=0Aor a custom range)=0A* country - Focus resul= ts geographically (ISO country code)=0AThis is useful for keeping research = scoped to trusted sources,=0Areducing noise, or running more consistent eva= luations.=0A=0A-----------------------------------------=0AReturn structure= d JSON with output_schema=0A=0A-----------------------------------------=0A= =0ADefine a JSON schema and get structured output instead of=0Afree-form te= xt:=0A=0A* Extract entities, summaries, or comparisons=0A* Enforce predicta= ble response shapes=0A* Pipe results directly into your app, pipeline, or a= gent=0Aoutput_schema is supported with research_effort values of=0A=E2=80= =9Cstandard=E2=80=9D, =E2=80=9Cdeep=E2=80=9D, and =E2=80=9Cexhaustive=E2=80= =9D, and can be combined with=0Asource_control in the same request.=0A=0A--= --------------=0AWhy this matters=0A=0A----------------=0A=0AUntil now, tea= ms had to choose between broad, unstructured=0Aoutputs or building custom p= ipelines to control inputs and=0Astructure responses.=0A=0AYou can now do b= oth directly in the API.=0A=0A-----------=0ATry it out!=0A=0A-----------=0A= =0ABoth features are available today! Check out the docs for=0Aexamples and= schema guidelines:=0Ahttps://clicks.you.com/f/a/T4CKLHGUGpgYgJsFlnAwgg~~/A= AQRxRA~/6qO15AfGPLJeK7pZAoJkBT4pmKlnDhfM50TWZiUdVsRSfmjERZ-hNSsSBq-F3bZO1LY= eiqXKZgpl6gNd8RK1cSnJkUvX2wRzMW6U5x3s_s6CwJv32j--kQWTAADBY-5C =0A( https://= clicks.you.com/f/a/UnuuMplvX6NDhkbatKbuWQ~~/AAQRxRA~/SEeu70cnKkK1JqR7qt-3gK= GrFTguw913ON-bCI2U_Hh8Gxrhb7yslbTwiNuBsw-oqf5JZmCbcCNx3pr2HnFqWZdR9z-8OvWSl= sLjcLhldxf7FEIoP4hqrfCqlfrXm-rkr71KkOGDfh9UZOeEYf2nKgutUlDZaAxH3NlB56U3535p= -qWxYYwSvjASMItF56Xo5KfurLoldnKfJRd16xcQhYeDRnsw6cr8nbTiGUlquoX_e1azhAcMoVH= izQR0n39QW6cSZRN2yoj4r98ck9fAcRCjbOxulUUkjpYvP18JPFfiXwMIsEtAqwGtQMEqNMaX )= =0A, and read the full blog post on the updates below.=0A=0ARead the blog = =0A( https://clicks.you.com/f/a/Jbr67ObPYECn9oVJboIjlA~~/AAQRxRA~/1EDqEsTVD= flHbDp4EXsXlMe7_F_FnGU9dIJruQVlM7dGe6quVyzo0ZsG1MgbuyNB0xS9v5nODoLEh94a_plK= d_RwWqrkxSDIirypCS_mO-s1JaAlVHy1qOQfn_mbaLCQNpxLchY6kcXPiqpa1_kNlUph8PA1t-I= vL9ctbyjJAnG8npn3byPGnIXmwxo5G3syUKBfX6YFgbA6B2tat9K9uAJZhue3aZCG92rlAXd84K= _czxKn0b8nL6yIS9CDCYomz86wZ-seeyXuXiEDKqpPPXFs2QBdNTrj1iD9zPUWH8ZWArb1DMDFl= IygFg7byxP5mQLIltlX_xGX94_mFMZmSbp0BcnsxafV29PWRXZXlJs~ )=0A We=E2=80=99= re excited to see what you build with these!=0A=0A-The You.com Team=0A=0AIn= stagram =0A( https://clicks.you.com/f/a/fVm2Ega2GCEM3C1hjTv48A~~/AAQRxRA~/= 6qO15AfGPLJeK7pZAoJkBeq9X5A9BTH74rLStsqWzHyCKNWbqniQwcvVB3VaYSEfg08UpW7VTE1= F2CCvhP7yHrDeIv5yVz_aQkm6VBf4tyn18wHom40Ru6zuMLE5u2yg ) Facebook =0A( h= ttps://clicks.you.com/f/a/GMQulGQmKIl1Uv_f3aiVrA~~/AAQRxRA~/wRsam2NTLhyJEXR= u5a3XTcxEMVLyQUz2AqazgEaPRSbpqeZYoiFGD96SWP8k0gczIDdkKErN3AqzaE5UVRFu1FPzaZ= zRUtFZs6c0yv2eKaNu6LvFpGUFC2H26ZPci71l ) X =0A( https://clicks.you.com/= f/a/OpgMGEiLpzdb3tbEBPUEOw~~/AAQRxRA~/FFOPVycUTKnYy_dfMODMB2Yq9dFmedZtYiXIX= nfLI6XVWMLBRFwxLNZryDu644DmrPATSZ_NEF99JsnoqwKkta8xvFAA5WPhDr5PVwWtWt8~ ) = YouTube =0A( https://clicks.you.com/f/a/QVtmph8g7fGQ3lJ9hGPTBw~~/AAQRxRA= ~/dQX5O1RhyFwPOrLdo5s-wGmhQzWtlW2k9jYSjRQ97c9LZDhtQbiwXKc8jguaZaaYElS97pwEf= JL-6H-1QLL-Q3LpCfyC1Jsf97Q_2NNEY_N59l3rM2GhWSeB8gcD9VE0 ) Unsubscrib= e (=0Ahttps://clicks.you.com/f/a/8UQV2uEdE6ytIgBqziFUwA~~/AAQRxRA~/HiXSTaqB= o-0hqtAfpmCLnjIxl7SYnvVVs3n0D-McDwh7fbB_FcTFACV5PEXsgqqiEv3bHNwPlPufGVMdEJL= PucEboU_amb7H3jR5XVHKdQ10xhg2xsmU-qZYToAaVchjrzYeNMgTQBMyBDEbCsFelVlthfEh6J= 2ChkSl6BwCglITSxa2J9G5zVuQnh-NZoP5luPzH1NWJkYCqrIjyxHO850NsrMvcgCmgQo-LdeB_= 8sxF5--TJIo9Rziy69HU8cpz_YsPmkvZE5tLGXyJ90yFx8TflnPzICHTTeE7OmiVgiWd2gaMbWZ= W41DTGkF59nPG7pNwReNFps5b2f7NTwVn6Z7mcD7c-RUg2nisW4wHzVesiDHOLIGae_cK9GvA9c= xb87F8jzWtDlHduNAZDE-RCSXsVkFxzrh27-41e7wu7HDMtGJBT1lkB93HIV7WvReclVzzQdGO5= trCG0qEXM8bj5le5eCqaIq0H327bJJXfyD5dn-O2tFMmSfszmyCtCfyB337Rcfs-Ht6tKboTO-h= BUkKVN1ccs3jhCCcHO_6lbW9oohGzUQ4Rvb8oCP8F7ydNmH6GDjcMVrae0TzqzBZ-cJzipMlzmI= vyNTbSApWo4BYmyE3I6pLle6P86Y61XH1xoI5H56K3vAtosRHrpGki6s01nB6aElstchJWTdqxQ= ~ ) By using this site, you=0Aagree to the Terms of Service ( https://= clicks.you.com/f/a/NYU8WPflCPG7Fm2AinnbIA~~/AAQRxRA~/wYElX1UqXTBhlB-I4-yLUj= TnrL6uG7vdSkXotgfb8p2-FIp1oHdA1vx0N7aYS0cOsOb_dMOD9ppPggdQzpQE6QTBxgoHJe-AP= l-6IVgVs20~ ) and=0APrivacy Policy ( https://clicks.you.com/f/a/Fk9z9k2hRXc= RbR9I-tS7YA~~/AAQRxRA~/FFOPVycUTKnYy_dfMODMB-NJnuBEqOJA34Eq-DRjcDvjGKsP0K0u= otxX9HAhtnvEnLwuDyso3soUlWURT6HTIzmlyA-yrXUcxqoHb5_FCqA~ )=0A=0A=C2=A9 2025= You.com. All rights reserved --_----z0Oy9Umov9gJgrMWIH3dLA===_2F/68-25436-E0111F96 Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset="UTF-8" =0A=0A=0A=0A=0A=0A=0A=0A=0A=0A
Cont= rol where results come from and get structured JSON back. Now available in = the Research API.
=0A
=0A
3D""
=0A
=0A

=0AWe just shipped new capabilities in t= he Research API that give you more control over how answers are generated a= nd how you use them downstream.

=0A
=E2=80=8A
=0A

Introducing: Source contro= l & structured output

=0A

With these updates, you can now control both:

=
=0A
    =0A
  • Where the model looks during research=0A
  • How the response= is returned to your application
    • =0A
= =0A
=E2= =80=8A
=0A

Control where results come from wit= h source_control

=0A

=0AYou can now constrain which web sour= ces the research agent searches and visits:

=0A<= table class=3D"list_block block-9" width=3D"100%" border=3D"0" cellpadding= =3D"0" cellspacing=3D"0" role=3D"presentation" style=3D"mso-table-lspace:0;= mso-table-rspace:0;word-break:break-word;color:#000;direction:ltr;font-fami= ly:Sans-serif;font-size:16px;font-weight:400;letter-spacing:0;line-height:1= .5;text-align:left;mso-line-height-alt:24px">
=
    =0A
  • include_domains - Res= trict results to a list of trusted domains (up to 500). This is useful when= you need research scoped exclusively to known, authoritative sources
    • = =0A
  • =0Aexclude_domains - Blo= ck specific domains from both search results and agent browsing (up to 500)=
    • =0A
  • freshness - Filter = by recency (=E2=80=9Cday=E2=80=9D, =E2=80=9Cweek=E2=80=9D, =E2=80=9Cmonth= =E2=80=9D, =E2=80=9Cyear=E2=80=9D, or a custom range)
    • =0A
  • country - Focus results geographically (I= SO country code)
    • =0A
=0A
=0A

This is useful for keeping rese= arch scoped to trusted sources, reducing noise, or running more consistent = evaluations.

=0A
=0A=
=
=0A=E2=80=8A=0A
=0A

Return structured JSON with output_schema

=
=0A

Define a JSON schema and get structured output instead of free-form te= xt:

=0A
    =0A
  • Extract entities, summaries, or comparisons
    • = =0A
  • Enforce predictable resp= onse shapes
    • =0A
  • Pipe res= ults directly into your app, pipeline, or agent
    • =0A
=0A

= =0Aoutput_schema is supported with research_effort values of =E2=80=9Cstand= ard=E2=80=9D, =E2=80=9Cdeep=E2=80=9D, and =E2=80=9Cexhaustive=E2=80=9D, and= can be combined with source_control in the same request.

=0A
=E2=80=8A
=0A

Why this matters
<= /span>

=0A
=0A

=0AUntil now, teams had to choose bet= ween broad, unstructured outputs or building custom pipelines to control in= puts and structure responses. 

=0A

You can now= do both directly in the API. 

=0A
=0A
=E2=80= =8A
=0A=

Try it out!

=0A

= =0ABoth features are available today! Check out the docs for examples and s= chema guidelines: https://you.com/docs/res= earch/overview, and read the full blog post on the updates below.

=0A
=E2=80=8A
=0A
=0ARead the blog=0A
=0A
=E2=80=8A
=0A
=0A

We= =E2=80=99re excited to see what you build with these! 

=0A

-The You.com Team

=0A
=0A= =0A
=0A
=0A<= /tr>
3D""
=0A
=E2=80=8A
=0A
=0A=0A= =0A=0A =0A =0A =0A = =0A =0A
=0A =0A
=0A = 3D"Instagram"=0A
= =0A =0A 		=0A =0A
=0A 3D"Facebook"=0A
=0A =0A =0A 		=0A =0A
=0A 3D"X"=0A
= =0A =0A 		=0A =0A
=0A 3D"YouTube"=0A
=0A =0A
=0A=0A=0A=0A=0A=0A =0A =0A =0A
Unsubscribe
=0A
=0A

=0A B= y using this site, you agree to the =0A Terms of Ser= vice =0A and =0A Privacy Policy=0A

=0A
=E2=80=8A
=0A=0A

=C2=A9 2025 You.com. All rights reserved

=0A
=0A=0A=0D=0A3D""=0D=0A=0A --_----z0Oy9Umov9gJgrMWIH3dLA===_2F/68-25436-E0111F96--