> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Target API — Overview

> Search Target US products, retrieve variants and prices, read reviews and questions, and monitor stores and stock.

Search Target US products, retrieve variants and prices, read reviews and questions, and monitor stores and stock.

Authenticate with `X-API-Key`. Requests use `https://scrapebadger.com/v1/target`.

## Endpoints

| Endpoint | Request | Credits |
| - | - | -: |
| [List supported markets](https://docs.scrapebadger.com/api-reference/endpoint/target/markets.md) | `GET /markets` | 0 |
| [Search products](https://docs.scrapebadger.com/api-reference/endpoint/target/search.md) | `GET /search` | 5 |
| [Browse a category](https://docs.scrapebadger.com/api-reference/endpoint/target/category.md) | `GET /category` | 5 |
| [Get search suggestions](https://docs.scrapebadger.com/api-reference/endpoint/target/autocomplete.md) | `GET /autocomplete` | 5 |
| [Find nearby stores](https://docs.scrapebadger.com/api-reference/endpoint/target/stores.md) | `GET /stores` | 5 |
| [Get store detail](https://docs.scrapebadger.com/api-reference/endpoint/target/stores-store-id.md) | `GET /stores/{store_id}` | 5 |
| [Get categories](https://docs.scrapebadger.com/api-reference/endpoint/target/categories.md) | `GET /categories` | 5 |
| [Get product reviews](https://docs.scrapebadger.com/api-reference/endpoint/target/products-tcin-reviews.md) | `GET /products/{tcin}/reviews` | 5 |
| [Get product questions](https://docs.scrapebadger.com/api-reference/endpoint/target/products-tcin-questions.md) | `GET /products/{tcin}/questions` | 5 |
| [Get product availability](https://docs.scrapebadger.com/api-reference/endpoint/target/products-tcin-availability.md) | `GET /products/{tcin}/availability` | 10 |
| [Get product detail](https://docs.scrapebadger.com/api-reference/endpoint/target/products-tcin.md) | `GET /products/{tcin}` | 10 |

Credits apply to successful requests. Failed requests and empty result sets are not charged.

## Markets

Supported market codes: `us`.

Use the same market and location parameters across search, product and availability requests. Store availability and prices reflect the requested context at collection time.

## Pagination

Follow each endpoint’s pagination fields and retain product IDs to deduplicate results. Search counts and stock can change between calls.

## Get started

[Open the playground](https://scrapebadger.com/dashboard/target-scraper) or use the [Python and Node.js SDKs](https://docs.scrapebadger.com/sdks.md).

## Run this asynchronously

Calls on this API can run in the background, so you don't hold a connection open while they work. Add one of these to the call:

| Add | What you get |
| - | - |
| `async=true` | The normal response if the call finishes within 25 s. Otherwise `202` with a `request_id`, which you poll at `GET /v1/requests/{request_id}` for free. |
| `callback_url=https://…` | `202` at once. When the call completes, the result is POSTed to your URL, signed with your webhook secret. |
| `Idempotency-Key: <your id>` header | A resent submit returns the first call instead of running it again. |

```bash theme={null}
curl -s "https://scrapebadger.com/v1/...?your=params&async=true" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
# 202 {"request_id": "…", "status": "running", …}, then:
curl -s "https://scrapebadger.com/v1/requests/REQUEST_ID" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
```

An async call is billed once, when it completes. See [Async requests and webhooks](https://docs.scrapebadger.com/long-running-requests.md) for webhooks, signatures and the SDK helpers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.