New in Research API: source control & structured output

Snippet

Body

Control where results come from and get structured JSON back.
Now available in the Research API.     We just shipped new
capabilities in the Research API that give you more control over
how answers are generated and how you use them downstream.

***************************************************
Introducing: Source control & structured output
***************************************************

With these updates, you can now control both:

* Where the model looks during research
* How the response is returned to your application

---------------------------------------------------
Control where results come from with source_control

---------------------------------------------------

You can now constrain which web sources the research agent
searches and visits:

* include_domains - Restrict results to a list of trusted
domains (up to 500). This is useful when you need research scoped
exclusively to known, authoritative sources
* exclude_domains - Block specific domains from both search
results and agent browsing (up to 500)
* freshness - Filter by recency (“day”, “week”, “month”, “year”,
or a custom range)
* country - Focus results geographically (ISO country code)
This is useful for keeping research scoped to trusted sources,
reducing noise, or running more consistent evaluations.

-----------------------------------------
Return structured JSON with output_schema

-----------------------------------------

Define a JSON schema and get structured output instead of
free-form text:

* Extract entities, summaries, or comparisons
* Enforce predictable response shapes
* Pipe results directly into your app, pipeline, or agent
output_schema is supported with research_effort values of
“standard”, “deep”, and “exhaustive”, and can be combined with
source_control in the same request.

----------------
Why this matters

----------------

Until now, teams had to choose between broad, unstructured
outputs or building custom pipelines to control inputs and
structure responses.

You can now do both directly in the API.

-----------
Try it out!

-----------

Both features are available today! Check out the docs for
examples and schema guidelines:
https://clicks.you.com/f/a/T4CKLHGUGpgYgJsFlnAwgg~~/AAQRxRA~/6qO15AfGPLJeK7pZAoJkBT4pmKlnDhfM50TWZiUdVsRSfmjERZ-hNSsSBq-F3bZO1LYeiqXKZgpl6gNd8RK1cSnJkUvX2wRzMW6U5x3s_s6CwJv32j--kQWTAADBY-5C 
( https://clicks.you.com/f/a/UnuuMplvX6NDhkbatKbuWQ~~/AAQRxRA~/SEeu70cnKkK1JqR7qt-3gKGrFTguw913ON-bCI2U_Hh8Gxrhb7yslbTwiNuBsw-oqf5JZmCbcCNx3pr2HnFqWZdR9z-8OvWSlsLjcLhldxf7FEIoP4hqrfCqlfrXm-rkr71KkOGDfh9UZOeEYf2nKgutUlDZaAxH3NlB56U3535p-qWxYYwSvjASMItF56Xo5KfurLoldnKfJRd16xcQhYeDRnsw6cr8nbTiGUlquoX_e1azhAcMoVHizQR0n39QW6cSZRN2yoj4r98ck9fAcRCjbOxulUUkjpYvP18JPFfiXwMIsEtAqwGtQMEqNMaX )
, and read the full blog post on the updates below.

Read the blog  
( https://clicks.you.com/f/a/Jbr67ObPYECn9oVJboIjlA~~/AAQRxRA~/1EDqEsTVDflHbDp4EXsXlMe7_F_FnGU9dIJruQVlM7dGe6quVyzo0ZsG1MgbuyNB0xS9v5nODoLEh94a_plKd_RwWqrkxSDIirypCS_mO-s1JaAlVHy1qOQfn_mbaLCQNpxLchY6kcXPiqpa1_kNlUph8PA1t-IvL9ctbyjJAnG8npn3byPGnIXmwxo5G3syUKBfX6YFgbA6B2tat9K9uAJZhue3aZCG92rlAXd84K_czxKn0b8nL6yIS9CDCYomz86wZ-seeyXuXiEDKqpPPXFs2QBdNTrj1iD9zPUWH8ZWArb1DMDFlIygFg7byxP5mQLIltlX_xGX94_mFMZmSbp0BcnsxafV29PWRXZXlJs~ )
    We’re excited to see what you build with these!

-The You.com Team

Instagram  
( https://clicks.you.com/f/a/fVm2Ega2GCEM3C1hjTv48A~~/AAQRxRA~/6qO15AfGPLJeK7pZAoJkBeq9X5A9BTH74rLStsqWzHyCKNWbqniQwcvVB3VaYSEfg08UpW7VTE1F2CCvhP7yHrDeIv5yVz_aQkm6VBf4tyn18wHom40Ru6zuMLE5u2yg )    Facebook  
( https://clicks.you.com/f/a/GMQulGQmKIl1Uv_f3aiVrA~~/AAQRxRA~/wRsam2NTLhyJEXRu5a3XTcxEMVLyQUz2AqazgEaPRSbpqeZYoiFGD96SWP8k0gczIDdkKErN3AqzaE5UVRFu1FPzaZzRUtFZs6c0yv2eKaNu6LvFpGUFC2H26ZPci71l )    X  
( https://clicks.you.com/f/a/OpgMGEiLpzdb3tbEBPUEOw~~/AAQRxRA~/FFOPVycUTKnYy_dfMODMB2Yq9dFmedZtYiXIXnfLI6XVWMLBRFwxLNZryDu644DmrPATSZ_NEF99JsnoqwKkta8xvFAA5WPhDr5PVwWtWt8~ )    YouTube  
( https://clicks.you.com/f/a/QVtmph8g7fGQ3lJ9hGPTBw~~/AAQRxRA~/dQX5O1RhyFwPOrLdo5s-wGmhQzWtlW2k9jYSjRQ97c9LZDhtQbiwXKc8jguaZaaYElS97pwEfJL-6H-1QLL-Q3LpCfyC1Jsf97Q_2NNEY_N59l3rM2GhWSeB8gcD9VE0 )        Unsubscribe (
https://clicks.you.com/f/a/8UQV2uEdE6ytIgBqziFUwA~~/AAQRxRA~/HiXSTaqBo-0hqtAfpmCLnjIxl7SYnvVVs3n0D-McDwh7fbB_FcTFACV5PEXsgqqiEv3bHNwPlPufGVMdEJLPucEboU_amb7H3jR5XVHKdQ10xhg2xsmU-qZYToAaVchjrzYeNMgTQBMyBDEbCsFelVlthfEh6J2ChkSl6BwCglITSxa2J9G5zVuQnh-NZoP5luPzH1NWJkYCqrIjyxHO850NsrMvcgCmgQo-LdeB_8sxF5--TJIo9Rziy69HU8cpz_YsPmkvZE5tLGXyJ90yFx8TflnPzICHTTeE7OmiVgiWd2gaMbWZW41DTGkF59nPG7pNwReNFps5b2f7NTwVn6Z7mcD7c-RUg2nisW4wHzVesiDHOLIGae_cK9GvA9cxb87F8jzWtDlHduNAZDE-RCSXsVkFxzrh27-41e7wu7HDMtGJBT1lkB93HIV7WvReclVzzQdGO5trCG0qEXM8bj5le5eCqaIq0H327bJJXfyD5dn-O2tFMmSfszmyCtCfyB337Rcfs-Ht6tKboTO-hBUkKVN1ccs3jhCCcHO_6lbW9oohGzUQ4Rvb8oCP8F7ydNmH6GDjcMVrae0TzqzBZ-cJzipMlzmIvyNTbSApWo4BYmyE3I6pLle6P86Y61XH1xoI5H56K3vAtosRHrpGki6s01nB6aElstchJWTdqxQ~ )      By using this site, you
agree to the Terms of Service ( https://clicks.you.com/f/a/NYU8WPflCPG7Fm2AinnbIA~~/AAQRxRA~/wYElX1UqXTBhlB-I4-yLUjTnrL6uG7vdSkXotgfb8p2-FIp1oHdA1vx0N7aYS0cOsOb_dMOD9ppPggdQzpQE6QTBxgoHJe-APl-6IVgVs20~ ) and
Privacy Policy ( https://clicks.you.com/f/a/Fk9z9k2hRXcRbR9I-tS7YA~~/AAQRxRA~/FFOPVycUTKnYy_dfMODMB-NJnuBEqOJA34Eq-DRjcDvjGKsP0K0uotxX9HAhtnvEnLwuDyso3soUlWURT6HTIzmlyA-yrXUcxqoHb5_FCqA~ )

© 2025 You.com. All rights reserved