What you get
| Field | Type | Sample value |
|---|---|---|
description |
string | This hearty kale salad is roughly inspired by gỏi tôm (Vietnamese shrimp salad)… |
publisher_name |
string | NYT Cooking |
url |
string | cooking.nytimes.com/recipes/794864348-kal… |
image_url |
array of string | static01.nyt.com/images/2026/11/17/multim… |
rating |
integer | not in the saved sample |
badge |
string | EASY |
consolidated_byline_string |
string | Susan Vu |
headline_default |
string | Kale and Shrimp Salad With Fish Sauce Dressing |
All 87 fields
Key fields
descriptionpublisher_nameurlimage_urlratingbadgeconsolidated_byline_stringheadline_defaulttotal_time_displayuriall_notesauthor_urlcook_timecooking_methodcopyright_yeardate_modifieddate_publishedhas_part_css_selectorhas_part_is_accessible_for_freeimage_credit_textimage_date_modifiedis_enhanced_byline_enabledkeywordsmeta_descriptionmeta_image_urlmeta_page_typemeta_scoop_recipe_urnmeta_social_titlemeta_titlenutrition_caloriesnutrition_carbohydrate_contentnutrition_cholesterol_contentnutrition_fat_contentnutrition_fiber_contentnutrition_protein_contentnutrition_saturated_fat_contentnutrition_sodium_contentnutrition_sugar_contentnutrition_unsaturated_fat_contentprep_timerecipe_categoryrecipe_cuisinerecipe_ingredientrecipe_instructions_textrecipe_instructions_urlrecipe_yieldscoop_recipe_headliner_hook_doc_typescoop_recipe_ingredients_doc_typescoop_recipe_ingredients_text_contentscoop_recipe_media_hero_image_first_publishedscoop_recipe_media_hero_image_uriscoop_recipe_media_hero_image_urlscoop_recipe_nutritional_info_per_serving_caloriesscoop_recipe_preparation_doc_typescoop_recipe_preparation_text_contentscoop_recipe_rights_categoryscoop_recipe_time_ready_intotal_timetrending_articles_typetrending_articles_uritrending_articles_url
Technical fields
image_alt_textoverride_alt_textreview_countsource_idcopyright_holder_namedetail_urlhelpful_notesimage_content_urlimage_date_publishedimage_heightimage_upload_dateimage_widthis_accessible_for_freeis_media_net_enabledis_part_of_nameis_part_of_product_idmeta_disable_title_brandingmeta_is_recipe_box_redesign_enabledmeta_is_social_giftmeta_social_descriptionscoop_recipe_headnote_doc_typescoop_recipe_media_hero_image_last_major_modificationscoop_recipe_media_hero_image_last_modifiedscoop_recipe_media_hero_image_source_idscoop_recipe_uritrending_articles_id
Every field with its type, and the schemas, are in contract.json.
Sample records
1 of 3 saved records. This is a saved sample, not a live run.
description |
publisher_name |
url |
image_url |
badge |
consolidated_byline_string |
|---|---|---|---|---|---|
| This hearty kale salad is roughly inspired by gỏi tôm (Vietnamese shrimp salad)… | NYT Cooking | cooking.nytimes.com/recipes/794864348-kal… | static01.nyt.com/images/2026/11/17/multim… | EASY | Susan Vu |
Scroll sideways to see more columns.
Inputs
-
categorytextOptional. Free text: any category the site serves, written with letters and hyphens, up to 48 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing.
-
recipestextOptional. Free text: any recipe the site serves, written with letters and hyphens, up to 44 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c013c757b5594b60a750b4bd/endpoints/generated_c013c757b5594b60a750b4bd_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c013c757b5594b60a750b4bd/endpoints/generated_c013c757b5594b60a750b4bd_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"category": "vegan-thanksgiving"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Nytimes.com Dinner Recipes API.
The agent calls get_api with generated_c013c757b5594b60a750b4bd, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- News & content
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Nytimes.