> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "requestAmazonProductByURL"
description: "Requests an Amazon product to be tracked by Rye's API. Products will be refreshed on some interval. A product must be requested before it can be queried."
---

## Arguments

<ParamField path="input" type="RequestAmazonProductByURLInput!" required>
  An object containing the product's URL.

  <Expandable title="properties">
    <ParamField path="url" type={<a href="/api-reference/url">URL!</a>} required>
      The URL of the product to be requested.
    </ParamField>
  </Expandable>
</ParamField>

## Returns

<ResponseField name="productId" type="ID!">
  The `productId` is the unique identifier for the requested product, which can be used in subsequent queries to fetch product information, e.g. with [`productByID`](/api-reference/productbyid).
</ResponseField>

## Example

<Tabs items={["Request", "Response"]}>
  <Tab title="Request">
    ```graphql
    mutation RequestAmazonProductByURL {
      requestAmazonProductByURL(
        input: {
          url: "https://www.amazon.com/gp/product/B07S9NNCGQ/ref=ppx_yo_dt_b_search_asin_title?ie=UTF8&th=1"
        }
      ) {
        productId
      }
    }
    ```
  </Tab>

  <Tab title="Response">
    ```json
    {
      "data": {
        "requestAmazonProductByURL": {
          "productId": "B07S9NNCGQ"
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

## Errors

### Invalid URL

If the provided URL is not a valid Amazon product URL then the following error is returned

```JSON JSON
{
  "errors": [
    {
      "message": "The provided `url` input (\"www.google.com\") is not a valid Amazon product URL.",
      "path": [
        "requestAmazonProductByURL"
      ]
    }
  ],
  "data": null
}
```

### Product data not found

If the product data can't be found, a `PRODUCT_NOT_FOUND_ERROR` is returned. This can happen for a variety of reasons:

1. The URL doesn't point to a valid product page (for example, the provided URL returns a 404 status code)

```json JSON
{
  "errors": [
    {
      "message": "Product data not found - if the URL is valid, then the store may not be supported. See docs for more details",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": [
        "requestAmazonProductByURL"
      ],
      "extensions": {
        "code": "PRODUCT_NOT_FOUND_ERROR"
      }
    }
  ],
  "data": null
}
```

## Webhooks

Calling this mutation will subscribe your developer account to [product webhooks](/webhooks/events#product-related-webhooks) for the requested product.

***

## Related mutations

* [`requestShopifyProductByURL`](/api-reference/requestshopifyproductbyurl)
* [`requestStoreByURL`](/api-reference/requeststorebyurl)


---

*Powered by [holocron.so](https://holocron.so)*