Target API endpoint
Returns paginated products for any category id from target-categories. Each response also contains every available dynamic filter group and option. Pass selected option ids through filter_ids as a comma-separated list. The sort enum accepts `relevance`, `featured`, `price-low`, `price-high`, `rating`, `bestselling`, and `newest`.
/target/category-productscategory_id is required and comes from /target/categories. page is one-based from 1 to 50 and defaults to 1. store_id defaults to 2885; look up real store IDs near a location with /target/stores. filter_ids accepts up to 40 comma-separated option IDs returned by filter_groups or /target/filter-options.
sort accepts relevance, featured, price-low, price-high, rating, bestselling, or newest and defaults to featured. The response returns pagination metadata, products, selected filter IDs, and every filter group and option available for the current category state.
| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| tcin | 24 | 75,665,976 to 1,009,879,515, median 94,769,366 |
| parent_tcin | 18 | 14,220,754 to 1,014,029,452, median 95,135,632 |
| title | 24 | “Women's Low-Rise Pull-On Shorts - Wild Fable™ Olive Green S…” and 23 other values |
| url | 24 | target.com |
| primary_image_url | 24 | target.scene7.com |
| brand | 24 | “Wild Fable” and 14 other values |
| category_id | 24 | |
| parent_category_id | 24 | |
| price | 24 | |
| rating | 24 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category_id | string | Yes | Target category id | 5q0ga | |
| page | integer | No | One-based page (1-50) Minimum: 1. Maximum: 50. | ||
| sort | string | No | Result order Allowed values: relevance, featured, price-low, price-high, rating, bestselling, newest. | ||
| store_id | integer | No | Target store id used for pricing Minimum: 1. | ||
| filter_ids | string | No | Comma-separated Target filter option ids | 5tdv1,fwtfr | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/target/category-products?category_id=5q0ga&page=1&sort=relevance" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category_id": "5q0ga",
"page": 1,
"page_size": 24,
"sort": "featured",
"store_id": 2885,
"total": 4158,
"total_pages": 50,
"count": 1,
"applied_filter_ids": [
"5tdv1"
],
"filter_groups": [
{
"id": "d_channel",
"display_name": "Shipping & Pickup",
"options": [
{
"id": "fwtfr",
"display_name": "Include out of stock"
}
]
}
],
"products": [
{
"tcin": "12345678",
"title": "Clearance item"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/target.categoryProductsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | target.CategoryProductsResponse | No | ||||
| data.applied_filter_ids | array | No | ||||
| data.category_id | string | No | 5q0ga | |||
| data.count | integer | No | 24 | |||
| data.fetched_at | string | No | ||||
| data.filter_groups | array | No | FilterGroup record, 10 fields: display_name, expanded, id, options, type. Described under List Target filter options API. | |||
| data.page | integer | No | 1 | |||
| data.page_size | integer | No | 24 | |||
| data.products | array | No | ProductSummary record, 18 fields: brand, category_id, parent_category_id, parent_tcin, price, primary_image_url, rating, tcin, title, url. Described under Search Target products API. | |||
| data.sort | string | No | featured | |||
| data.source_url | string | No | ||||
| data.store_id | integer | No | 2885 | |||
| data.total | integer | No | 4158 | |||
| data.total_pages | integer | No | 50 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/target/category-products?category_id=5q0ga&page=1&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"