Skip to content
Scrappa Get API key
Dick's Sporting Goods API 1 credit / request

Dick's Sporting Goods Product Search API Documentation

GET https://scrappa.co/api/dickssporting/search

Dick's Sporting Goods Product Search API Documentation 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.

Dick's Sporting Goods Product Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/dickssporting/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
{
    "data": {
        "sort": 1,
        "query": "running shoes",
        "facets": [
            {
                "id": "X_BRAND",
                "name": "Brand",
                "values": [
                    {
                        "count": 120,
                        "value": "Nike"
                    }
                ]
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

7 optional filters available.

query string Required

Search text, 1 to 200 characters. Example: running shoes.

Example value coffee shops
page integer Optional

Page number, 1 to 100. Each page has 24 products. Default: 1.

Example value 1
sort integer Optional

Storefront sort code, integer 0 to 7. Default: 0.

Example value relevance
category string Optional

Numeric category id from a Dick's category url. Passed as selectedCategory.

Example value example
min_price number Optional

Lowest current price in USD. Send with max_price. Rows below it are never returned.

Example value 10
max_price number Optional

Highest current price in USD. Send with min_price.

Example value 10
brand string Optional

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.

Example value example
price_band string Optional

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 value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required query parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "sort": [
            "The sort is an integer code from 0 to 7."
        ]
    },
    "message": "The request validation failed"
}
503

Service Unavailable

Dick's Sporting Goods could not be reached or refused the request. This response is not billable. Retry later.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Dick's Sporting Goods is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.