Category

The target_category source is designed to retrieve Target category pages based on Target's taxonomy node ID. The source supports localization features and allows you to browse through Target's product categories.

Request samples

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
    "source": "target_category",
    "category_id": "owq2q",
    "render": "html"
}'

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Parameter
Description
Default Value

source

Sets the scraper.

target_category

category_id

Target's taxonomy node ID for the category (e.g., "owq2q" for PlayStation 5 controllers).

-

render

Enables JavaScript rendering when set to html. More info.

-

callback_url

URL to your callback endpoint. More info.

-

user_agent_type

Device type and browser. The full list can be found here.

desktop

- mandatory parameter

Localization

Adapt results to specific stores, fulfillment types, and delivery locations.

Parameter
Description
Type

fulfillment_type

Set the fulfillment type. Available values are: pickup, shipping, shop_in_store, same_day_delivery.

String

store_id

Set the store location.

Integer

delivery_zip

Set the shipping to location.

String

Understanding Target's node IDs

Target's category system uses node IDs to identify specific categories. These node IDs are unique identifiers in Target's taxonomy system.

Example node IDs

Node IDs can be found in the category page URL. It's the part of the URL that has the format N-<5 symbols> . Here are some example category URLs and their corresponding node IDs:

  1. PlayStation 5 accessories: lbxgt

Node ID format

When using the target_category source, you only need to provide the node ID without the N- prefix. The API will automatically format the URL correctly.

Last updated

Was this helpful?