# Dick's Sporting Goods Product Search API Documentation

<p><strong>Dick's Sporting Goods Product Search API Documentation</strong> Search Dick's Sporting Goods products. Each row has the partnumber, name, brand, prices, discount, rating, review count, availability, full-size image URL and the reviews id. Filter by price range, brand and category, and sort with the storefront sort code 0 to 7. The page number in the answer always matches the page you asked for. Brand and price are sent to the storefront as facet filters, and a numeric range sends every confirmed band it overlaps. A row check is kept as a safety net. Use a category id from the category field of a search answer to search inside one category. A page has 24 products. Cost: 1 credit per page. An upstream block and every error cost nothing. A call takes about 1 to 3 seconds.</p>

- **Documentation:** [https://scrappa.co/docs/dickssporting-api/dickssporting_search](https://scrappa.co/docs/dickssporting-api/dickssporting_search)
- **API group:** Dick's Sporting Goods API
- **Endpoint:** `GET https://scrappa.co/api/dickssporting/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search text, 1 to 200 characters. Example: running shoes. |
| `page` | integer | No | Page number, 1 to 100. Each page has 24 products. Default: 1. |
| `sort` | integer | No | Storefront sort code, integer 0 to 7. Default: 0. |
| `category` | string | No | Numeric category id from a Dick's category url. Passed as selectedCategory. |
| `min_price` | number | No | Lowest current price in USD. Send with max_price. Rows below it are never returned. |
| `max_price` | number | No | Highest current price in USD. Send with min_price. |
| `brand` | string | No | Brand value from the brand facet in a search answer. Use the exact facet value. Rows whose brand does not contain this text are dropped. |
| `price_band` | string | No | One of *-25, 25-50, 50-100, 100-150, 150-250 or 250-500 from the search facets. A numeric range sends every band it overlaps. |

## Example response

```json
{
    "data": {
        "sort": 1,
        "query": "running shoes",
        "facets": [
            {
                "id": "X_BRAND",
                "name": "Brand",
                "values": [
                    {
                        "count": 120,
                        "value": "Nike"
                    }
                ]
            }
        ],
        "results": [
            {
                "url": "https://www.dickssportinggoods.com/p/example-running-shoe-26nikasoccuxlfik3fkny",
                "name": "Example Running Shoe",
                "brand": "Nike",
                "image": "https://images.example.com/product-large.jpg",
                "price": {
                    "current": 89.99,
                    "regular": 110,
                    "currency": "USD",
                    "is_on_sale": true,
                    "discount_percent": 18.19
                },
                "rating": {
                    "count": 1280,
                    "average": 4.6
                },
                "partnumber": "26NIKASOCCUXLFIK3FKNY",
                "reviews_id": "25fhqwrh8whtwhtxxftw",
                "catentry_id": "123456789",
                "availability": "IN_STOCK"
            }
        ],
        "category": {
            "id": "12345",
            "url": "/c/running-shoes/12301_12345",
            "name": "Running Shoes"
        },
        "store_id": "15108",
        "pagination": {
            "per_page": 24,
            "total_pages": 27,
            "current_page": 1,
            "has_next_page": true,
            "total_results": 641
        },
        "sort_options": [
            0,
            1,
            2,
            3,
            4,
            5,
            6,
            7
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "duration_ms": 1200,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | Dick's Sporting Goods could not be reached or refused the request. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
