Piloterr

Chewy Search

GET
/v2/chewy/search

Search Chewy by keyword or listing URL. The default mode is expert and returns the historical listing objects. simple returns short snake_case cards.

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

What to search for. A keyword such as salmon kibble, or a Chewy search or category link such as https://www.chewy.com/s?query=dog+food. A product link (a URL that contains /dp/) returns 400. Another website returns 400.

page?number

Which page to fetch, starting at 1. Leave this empty for page 1. If query is a listing link that already has page=2, this value replaces that page. In simple mode, pagination.page is this page and pagination.next is the next page URL or null.

Range1 <= value
mode?string

Which JSON to return. Default expert.

expert: the historical payload. { results } of Chewy listing fields in snake_case (catalog_entry_id, name, href, advertised_price). No pagination object.

simple: the short card. { results, pagination }. Every key is lowercase snake_case. price is a number. price_display is that number in dollars, with no trailing dash.

Use simple for a short listing. Use expert for the full historical detail. Missing, empty, and expert are the same. Case does not matter. Any other value, including false, returns 400.

Default"expert"
return_page_source?boolean

Set to true to get the rendered HTML in result instead of JSON. Default false. The string false stays false and still returns JSON.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
Example Request
curl -X GET 'https://api.piloterr.com/v2/chewy/search?query=string'
Example Response
{  "results": [    {      "ppu": "$2.59/lb",      "href": "https://www.chewy.com/api/event/p/sar/click?adsOrigin=aspen2&id=238a99cdbce84f4a97e766531a139158&x=H4sIAAAAAAAA_6VYWZOiyhL-Lzw7PVCASr-ccGuFIzgiyhI34gZbK6sEoAgT57_fLLCV7tG2-9wnICv58sullqzfhOnwDvFMkX2q12M4RHYIO3XN3Du6WM6RbLfPdTnUIV5Db7vLsbDH9HtMj0MU6JpRYnrbGItZpkshjiN7HQA9umnuZW6KB2iK6wJOh0hSb596eYmFiOlyLEYIPTtYpyHxTOzyPMmef_50f1AU2-8-mU7lpsFT7OY_07_c_xxIknbcUkC8v_fEFXOSRnzGRy_4uxKVAInjNZqPhJ0z4ruiolfw7tXvo8LTEekt_DUp-ZNyoQSFVGLZFmR6KVbLAnR9s-S7Lk0CplQCJovxFuMALRRsR06wXUNdV7oqhaKyJA1lQkpjOdKVLZIUkV4odiFGk8IYLxmx4j3ADEyvsW-qgbfweLC12y2U0Demgm8oW9LwZfh2QqnSMcZJVybVQplQi9o3Oce-AU6kl9inASMqNi2NgxJjGlEB_G1yMbZJqQLZCuxoA2ynmvv8SRxBjKrJQfRFlvdgjLZhTAD-p9xCzNZEoadHp3A-zRM9EjJjNXwby2z0klkqd-Cn8tEoh6mpCp41Xd-Tb42IOxqj0wXbmHIxPzWOFlpe7cyknTWljpbX-u-q18Yu3dXVpo5eSP5zjm39zzADC9lnrnd9iizEBS2ugR0Hf_jnoF3iTDeRqUn7T2L0wWYrPjOBvWevxRHbztqxfMOet_4927nE5SM2f8E-nfm-xfLKp4lxE7NrXdS4vq5dc3jFGpaGKiU2-HsZO_9f27_pz-36wO92ear1btRKLbfUzc6aia3YUqGuFu9y3fKhFadL3bzFCuJy-rRWLv9oYnazjlu8b8Wy_Y-uypQ1WzY41zxcdGu_Rk2MzzF6F4cLt5kQWmpIWathYdES1F74DudNX6NxXqjEUcmtPeUqU5MTXBN_5C_kCjva5Ka2yfnZ8GijkDSx7x_i_gj30_Xg5Ws23s_HzetXfW3X-Bf4tdaIuzZu1_oXYoXXiP-D17-Kw7XO5Me69ZrwNd37a9sXOH1Ye77t__dqBuIe3uPU1jvzY7-iW-fyjd89_nfX2Hu1MjUSG22_MZ8kOMd8HsNHWA3HGucyLy_4EAcdhYWxucf3_br5qY1buflmHi3kVHdttNfZe3xv7hfSw3o9r7-Pebfy8TjXN_Yc6qHu12P3yK521-_vrDOt_fLfrElve9_d9abm8miefdzvr3v857jv98-7ur4YGZUe26yjhrEzG7KWmlRuPOF-rfD5m6Xh_H0SlTUjwfnZnoq4hziIlQ5jXAFj9Ny3T4vxEr6pD98y_oYzOcNI1bY69xCHG7L4T9nGxzLJY1jRn9BwtgeZg3sB3KeENvQ0VrzJLOgB7BkPnHjoawIKn__teAnfYsbHQgX6lDgewLu0q3smZVDgPsBGPO4DkrkyKKXIiEQk-OI4gL5lAH2U2OjQ0Ef4ASMpA9x_VE1PxUNfM6EXYNdRM9xn5BhT9MhSUnkkVbJneMA_Tg5NT7auFmOIVSxjLtCLBJVYbQvAhN5qSQFuYUF_hHsrxx_gfinGfY4zEygDfDFIiHcsl466xv5jDM-KuINR50bGMTrBP6SLMYKX3NCEREeToxJtaI0Kj3aUYUzPWkFfVwq5rsm-OarfU0MLaYsWAox56_yvUcOVvKaEzZrcriecstrIgkIy3ivwsrRNBvVTWNMwtHF_t2JIaQZ9Yzws7QYf5icXOKpErtRlHWvYT3NjynfnZf9cT_Aci0eIH3wvqzrmM-FozDa-M6F2psqOgW9oIK5012HNU9z0cZ5rDva0kcE8gbqWwUYfsKBvHOsYs5pXkwK-SbGse2TfwvmrBs07xIMPYS1RNyM7ejkYTR9N4lzg2PB-0uPjmreiq1S4jIWdFS1xLLM6r9jXCPrZMAe9ut8EXyYnaSxiHRLzWiPIx2ZYwtyjdHoJnE_vMWEeG6pzhP27xUGssbRqiRZ1jnGd8uxiJXDzWVb38n_yvupoGuZl-M08HRwkiJOjwXjEUtb0xOEbBNTNmouERXe2Kl8Z3VF_qOtX5cfe_u9UNv7-25D3RH1TYXvxlnj-Xb-6xDP7RHfxbYVrpr8aCaKe-r0-je9G3KMb5-IhzL0k9NyUeKY6RIqFB9DrPqEeYnpMn-ohmuN6AJOauauUCQzS8PPolwho3ScOUb0e1yGiveO9eq5zttN76lF9pkPsj26aes5F8g-m6UbeISKe8_Tgdogs3OeAhEiS7RDbdH9I8E0LAf5kXl7f51CoT1O9foeo9rHb3M2wdB8YxW5e7NOg1q9vX-AnO_-V7p2DnTdSkqIYuhbDdhDX10Ycd4PW_wDSwKvDVBIAAA&zip=true&golem=false&adRequestTime=1793380509061&pageNumber=1&pos=0&redirect=https://www.chewy.com/purina-pro-plan-adult-sensitive-skin/dp/128666",      "name": "Purina Pro Plan Adult Sensitive Skin & Stomach Salmon & Rice Formula Dry Dog Food, 30-lb bag",      "image": "https://image.chewy.com/catalog/general/images/moe/0671ffce-cb9e-7b85-8000-c4f526193d1c,1",      "is_ad": true,      "is_atf": true,      "is_btf": false,      "is_new": false,      "rating": 4.5068,      "is_deal": false,      "in_stock": true,      "is_fresh": false,      "is_bundle": false,      "is_frozen": false,      "is_pb_fresh": false,      "offer_price": "77.48",      "part_number": "101143",      "ad_placement": 0,      "bundle_title": null,      "is_gift_card": false,      "is_live_feed": false,      "is_smart_pak": false,      "key_benefits": [],      "manufacturer": "Purina Pro Plan",      "rating_count": 23711,      "strike_price": "$79.99",      "click_tracker": null,      "display_price": "$77.48",      "is_hard_goods": false,      "is_live_plant": false,      "autoship_price": "$73.61",      "is_dropshipped": false,      "is_enhanced_pb": false,      "is_rx_vet_diet": false,      "item_analytics": {        "data-id": "101143",        "data-name": "Purina Pro Plan Adult Sensitive Skin & Stomach Salmon & Rice Formula Dry Dog Food, 30-lb bag",        "data-brand": "Purina Pro Plan",        "data-price": "77.48",        "data-on-sale": "no",        "data-variant": null,        "data-category": "undefined",        "data-page-num": "1",        "data-deal-text": null,        "data-widget-id": null,        "data-creative-id": null,        "data-input-query": "salmon kibble",        "data-widget-type": null,        "data-is-monetized": "true",        "data-output-query": "salmon kibble",        "data-result-count": "1153",        "data-in-stock-flag": "true",        "data-price-per-unit": "$2.59/lb",        "data-experience-type": null,        "data-is-customizable": "false",        "data-widget-type-value": null,        "data-impression-tracker": "https://www.chewy.com/api/event/p/sar/impression?adsOrigin=aspen2&id=238a99cdbce84f4a97e766531a139158&x=H4sIAAAAAAAA_6VYWZeqRhD-LzybudDgwrzkuI1CBC-KIpy8sI02mwRQhJz891SDo8xcHWeSJ6C6-OqrpZfqvynTERzqmaF7TLfL8YhuUXbimhk-ukTO0-1Oj-_wqEW9Bni7y4iwy_W6XJdHDOiaYWzibUTEba7DIJ6nuy0APbpJhlM3IQMsw3cAp0XFCd4nOCuIEHEdvg0IOIwTN03xPlolAfVM7bIsTp9__HB_Y5h2r_NkOqWb-E-Rm_3AT1v8-rv754GmWcctRCR4eywtuZM8FFIhfCHfpaT6SBqt0Gwo7pyh0JFUvYR3XL0Pc6wjGs-9FS1742Ku-rlcENkWZHohlUoOup5ZCB2XpQFTLgCzTfDmIx_NVWJnERO7hrYqdU0OJFWhDXVMy6NFqKtbJKsSO1ftXArHuTFSOKkUMGD6Jq7tm5qP51gAW7vdXA08YyJ6hrqlDW8B304glzrBOOnquJyrY2Ze-bbIiG-AE-oF8anPSarNyiO_IJhGmAN_m56PbFouQbYEO5s-sVPOPOEkDSFG5fggeVJbwDDG2jAmAv9TZiFua6IA6-EpmE2yWA_F1FgO3sZSG72klsYfhMniaBSDxNREbE1W9-RbI-SPxvB0wTYmfCRMjKOFlKudqbyzJszRwo3_rnpN7MJdXm3q6IUWPufY1P8M07eQfeZ616fQQrzf4Orbkf-Lfw7axc5kHZobef9JjD7YbMRnKrbv2WtwJLbTZizfsGeNf892LnH5iC1csE9nvm-xvPKpY1zH7FoXFa6nb645vGINCkOTYxv8vYyd_6_s3_Tndn2Qd7s4VXo3aqWSW9p6Z02lRmyZQNfyd7lu-NCI06Vu3mIFcTl9WiuXfzZSerOOG7xvxbL5j64tGGuq1DjXPFx0K7-GdYzPMXoXhwu3qRhYWsBYy0FusTLUXvAO501_w5K8MLGj0Vt7wpfmZhGTmvglfwGf2-E6MzfrTJgOjjYKaJP4_iHuj3A_XQ9evmbj_Xxcv37V12aNf4FfY424a-N2rX8hVmSN-B-8_lMcrnW2eKxbrQlf072_tn2B04e159v-f69mIO7BPU5NvTO_9ld0q1y-8bvH_-4ae69WJkZso-035pMM55jPY_gIq-ZY4Vzm5QUf4qCjIDfW9_i-Xzc_tXErN9_Mo4Wc8q6N5jp7j-_N_UJ-WK_n9fcx70Y-Huf6xp7DPNT9euwe2d3c9fs760xjv_wva9Lb3nd3vam4PJpnH_f76x7_Oe77_fOurieFRqlHdtvRgsiZDtqWFpduNOZ_Lsn5u83C-fskqStOhvOzPZFID3GQSh3G-BzG2Jlnn-YjBb6ZD98L8g1nco6Ty2157iEON2TRr7K1R2Qy5tqSN2bhbA8yh_QCpE8JbOhprGidWtAD2FMBOAnQ1_gMOf_bkQLfUipEYgn6jDTqw7u8q3omtZ-TPsBGAukD4pnaL-TQCCUketLIh76lD32UVOuw0Ed4PierfdJ_lHVPJUBfM2bnYNfRUtJnZARTwnQhawKSywU2MPCP4kPdk63K-QhiFS0IF-hF_FIqtzlgQm-lMICbW9Afkd7K8fqkX4pIn-NMRcYAXwwa4h0tCkdbEf8JBrZC_mBUuVmQGJ3gH9olGP5LZmzEWEfjoxqu2Q0THO0wJZjYWkJfV4iZvll45rB6T4xNwFqs6BPMW-f_DTNYLlaMuF7R29WYV5frhajSHH4FXtZmnUL95NYkCGzS3y05Wp5C3xgNCrvGh_nJ-44m00tNqWIN-2lmTITOrOid6wmeI-kI8YNvpaxiPhWPxnTtOWNmZ2rtEfANDMQX7iqoeErrHslzxcGe1DKYJ1DXC7DRAyzoG0c6wSxn5TiHb1oqqh7Zs0j-yn79DvEQAlhLtPXQDl8ORt1H0yQXJDaCF3eFqOKt6hoTKJG4s0KFxDKt8kp8DaGfDTLQq_pN8GV8kkcS0aEJrxWCfKwHBcw9RmcV4Hx6jwnz2NCcI-zfDQ5ShbUpFTSvckzqVGjPlyI_m6ZVL_8r76vOZkN4GV49T_sHGeKkh2MyPwpSs0ZE3sfoVSF3CaiT1lcKcRj-lg-ZwFGUP8RVKMuvOZqMO9u__vKp6vLCxtGWev67enWp5_YT22lRduCayc9agpinXrfHkusS9-hGmXQIMhwH2E2oZ6ZFJUR4AL3OE-oirsv1mC5ieb4LMImZuWoRwyALPw9_SoDWeeIR0-3yLSrcO_gVu87ZTvepy_S4FrU_ukmCnYvkH0LTDfEhpJ6z5OC2qDTYZ4CEaLrdorbJ_hCTyxcK_ElxVl3xMKjHMt1eiyr3kVtf17TZHjCK3CzfJ36lX93FwE929jPZOwc7q6U0w3BsJYaNIapuknj-Bq1_AX5avc1nEgAA&zip=true&golem=false&adRequestTime=1793380509061&pageNumber=1&pos=0",        "data-new-cat-entry-type": "ITEM",        "data-analytics-ads-origin": "aspen2",        "data-analytics-ad-request-time": "1793380509061",        "data-analytics-alternative-rank": "undefined",        "data-analytics-piq-impression-id": "238a99cdbce84f4a97e766531a139158",        "data-analytics-piq-impression-payload": null      },      "is_customizable": false,      "is_discontinued": false,      "is_map_enforced": null,      "is_prescription": false,      "is_refrigerated": false,      "options_message": null,      "advertised_price": "77.48",      "catalog_entry_id": 128666,      "has_more_choices": false,      "is_autoship_deal": true,      "max_arrival_date": null,      "min_arrival_date": null,      "ft_autoship_price": "$57.48",      "strike_price_type": "LIST",      "impression_tracker": null,      "is_chewy_exclusive": false,      "parent_part_number": "67742",      "strike_savings_pct": "3",      "bundle_part_numbers": [],      "is_autoship_allowed": true,      "autoship_discount_pct": "5%",      "ensemble_part_numbers": [],      "ft_autoship_max_amount": "$20",      "validated_strike_price": "$79.99",      "parent_catalog_entry_id": null,      "ft_autoship_discount_pct": 35,      "minimum_advertised_price": null,      "is_canadian_national_brand": false,      "is_private_brand_from_spiq": false,      "new_user_other_cta_display": "none",      "show_promo_carousel_post_atc": false,      "supplemental_thumbnail_assets": [        "https://image.chewy.com/catalog/general/images/moe/069fe3d1-df1f-745f-8000-9bb61e099f02,1",        "https://image.chewy.com/catalog/general/images/moe/0671ffce-aa8a-7b92-8000-55ebf9862cbf,1",        "https://image.chewy.com/catalog/general/images/moe/0671ffa6-a1b3-75ba-8000-ce3bfaa8b1ed,1",        "https://image.chewy.com/catalog/general/images/moe/0671ffa6-816c-7aee-8000-e2155ccf0309,1",        "https://image.chewy.com/catalog/general/images/moe/0671ffa6-5dc2-7bc1-8000-86eef1c91470,1",        "https://image.chewy.com/catalog/general/images/moe/06835ef4-b5e0-79f8-8000-c6512e0bd24a,1",        "https://image.chewy.com/catalog/general/images/moe/0671ffa5-ee23-76bb-8000-529371470fee,1",        "https://image.chewy.com/catalog/general/images/moe/0671ffa5-cd60-7558-8000-33058e4394e6,1"      ],      "existing_user_other_cta_display": "none",      "should_display_atc_to_new_users": true,      "should_display_atc_to_existing_users": true,      "should_display_atc_to_new_users_below_min_ios": false    }  ]}