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

# Scrape a Target category listing

> Lists the products of one Target category (by id or category link; a brand page's id or link works too) as JSON: `category` (id, name, link, and `type`: category or brand), `breadcrumbs`, `totalResults`, `totalPages`, and `products` with `tcin`, `title`, `brand`, `price` (`priceMax` for a family priced as a range), `originalPrice` and `priceType` when on sale, `formattedPrice`, `currency`, `rating`, `ratingCount`, `promotions`, `image` and `url`. Sort with `sort`, start at `page` and collect up to `max_results` across pages (Target serves at most 50 pages of 24). Filters in a category link (...Z<facet>) are not applied. Each page fetched is billed as one request (`pagesFetched`).



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/target-category
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /marketplace/target-category:
    post:
      tags:
        - Plugins
      summary: Scrape a Target category listing
      description: >-
        Lists the products of one Target category (by id or category link; a
        brand page's id or link works too) as JSON: `category` (id, name, link,
        and `type`: category or brand), `breadcrumbs`, `totalResults`,
        `totalPages`, and `products` with `tcin`, `title`, `brand`, `price`
        (`priceMax` for a family priced as a range), `originalPrice` and
        `priceType` when on sale, `formattedPrice`, `currency`, `rating`,
        `ratingCount`, `promotions`, `image` and `url`. Sort with `sort`, start
        at `page` and collect up to `max_results` across pages (Target serves at
        most 50 pages of 24). Filters in a category link (...Z<facet>) are not
        applied. Each page fetched is billed as one request (`pagesFetched`).
      operationId: target_category_marketplace_target_category_post
      parameters:
        - name: category
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Target category: its id (e.g. '5xtro', the part after N- in a
              category link) or a target.com category link, e.g.
              https://www.target.com/c/coffee-makers-tea-espresso-kitchen-appliances-dining/-/N-5xtro.
              A brand page (/b/<brand>/-/N-<id>) lists that brand.
            title: Category
          description: >-
            Target category: its id (e.g. '5xtro', the part after N- in a
            category link) or a target.com category link, e.g.
            https://www.target.com/c/coffee-makers-tea-espresso-kitchen-appliances-dining/-/N-5xtro.
            A brand page (/b/<brand>/-/N-<id>) lists that brand.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: >-
              Order: relevance, price_low, price_high, rating, best_selling,
              newest.
            default: relevance
            title: Sort
          description: >-
            Order: relevance, price_low, price_high, rating, best_selling,
            newest.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: 1-based page to start from (1-50, 24 products per page).
            default: 1
            title: Page
          description: 1-based page to start from (1-50, 24 products per page).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Products to collect across pages (1-240); each page fetched is
              billed as one request.
            default: 24
            title: Max Results
          description: >-
            Products to collect across pages (1-240); each page fetched is
            billed as one request.
      responses:
        '200':
          description: JSON with a `products` array.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: Target has no such category, or it has no products.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Target on every attempt, or the call did not finish in
            time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

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