APIs / Marketplaces / Target

1 credit per call4 endpoints13 datapoints

Target API

Target API for product search, product details, store availability, reviews and store lookup by ZIP code as JSON, from 1 credit per call.

Target
GET/v1/target/search?query=coffee+maker
{
  "success": true,
  "data": {
    "query": "coffee maker",
    "results": [
      {
        "tcin": "91863920",
        "title": "Mr. Coffee 12-Cup Programmable Coffee Maker Black",
        "brand": "Mr. Coffee",
        "url": "https://www.target.com/p/mr-coffee-12c-programmable-drip-coffee-maker-stainless-steel-finish/-/A-91863920",
        "dpci": "072-08-0313",
        "department_id": 72,
        "class_id": 8,
        "item_type": "Coffee Makers",
        "images": {
          "primary": "https://target.scene7.com/is/image/Target/GUEST_fd026130-c56b-41d3-9e88-992fcf06debf",
          "alternates": [
            "https://target.scene7.com/is/image/Target/GUEST_22aead54-0df3-4d28-9158-7de16148d656",
            "https://target.scene7.com/is/image/Target/GUEST_c4da4ed8-1abb-40b5-b060-e40be685b2ea",
            "https://target.scene7.com/is/image/Target/GUEST_b589d0f6-282f-4a35-be74-f8b2fbfd46a6"
          ]
        },
        "price": {
          "current": 19.99,
          "regular": 34.99,
          "formatted_current": "$19.99",
          "formatted_regular": "$34.99",
          "comparison_type": "reg",
          "save_amount": 15,
          "save_percent": 43,
          "is_on_sale": true
        },
        "rating": {
          "average": 4.27,
          "count": 1037
        },
        "bullets": [
          {
            "label": "Dimensions (Overall)",
            "value": "13.6 Inches (H) x 10.75 Inches (W) x 11.5 Inches (D)"
          },
          {
            "label": "Weight",
            "value": "5.71 Pounds"
          },
          {
            "label": "Capacity (Volume)",
            "value": "60 fl oz (US)"
          }
        ],
        "badges": [
          "Bestseller"
        ]
      },
      {
        "tcin": "91863923",
        "title": "Mr. Coffee 12-Cup Switch Coffee Maker Black: Electric Drip Coffee Machine, 60 oz Capacity, Dishwasher-Safe Parts",
        "brand": "Mr. Coffee",
        "url": "https://www.target.com/p/mr-coffee-12c-drip-coffee-maker-black/-/A-91863923",
        "dpci": "072-08-0315",
        "department_id": 72,
        "class_id": 8,
        "item_type": "Coffee Makers",
        "images": {
          "primary": "https://target.scene7.com/is/image/Target/GUEST_7b42039c-223f-420b-97a8-d99a339a6295",
          "alternates": [
            "https://target.scene7.com/is/image/Target/GUEST_de1060bf-8bcc-4059-8616-43b4d4ea11b6",
            "https://target.scene7.com/is/image/Target/GUEST_c4e4c1de-2168-4ce6-965a-a2f124861021",
            "https://target.scene7.com/is/image/Target/GUEST_bbd90a00-379e-4f7a-9a34-d8604f53af40"
          ]
        },
        "price": {
          "current": 26.99,
          "regular": 26.99,
          "formatted_current": "$26.99",
          "is_on_sale": false
        },
        "rating": {
          "average": 4.41,
          "count": 1309
        },
        "bullets": [
          {
            "label": "Dimensions (Overall)",
            "value": "13.5 Inches (H) x 8.7 Meter (W) x 13 Inches (D)"
          },
          {
            "label": "Weight",
            "value": "5.14 Pounds"
          },
          {
            "label": "Capacity (Volume)",
            "value": "60 fl oz (US)"
          }
        ],
        "badges": [
          "Bestseller"
        ]
      },
      {
        "tcin": "94482782",
        "title": "bella 12 Cup Programmable Coffee Maker Oatmilk",
        "brand": "bella",
        "url": "https://www.target.com/p/bella-12-cup-programmable-coffee-maker-oatmilk/-/A-94482782",
        "dpci": "072-08-6593",
        "department_id": 72,
        "class_id": 8,
        "item_type": "Coffee Makers",
        "images": {
          "primary": "https://target.scene7.com/is/image/Target/GUEST_d6618107-b274-47f6-a0ff-ddbab4ae46fa",
          "alternates": [
            "https://target.scene7.com/is/image/Target/GUEST_52ead7e7-d92d-4f02-82af-cf443d0af417",
            "https://target.scene7.com/is/image/Target/GUEST_e2d812f8-dd34-4495-86ea-3fb8205c5b49",
            "https://target.scene7.com/is/image/Target/GUEST_337aab34-a88f-4d62-94b4-48f1a4cba9a8"
          ]
        },
        "videos": [
          {
            "url": "https://target.scene7.com/is/content/Target/GUEST_9407b802-8f2f-46f4-8cc6-d6596e1b0c3f"
          }
        ],
        "price": {
          "current": 29.99,
          "regular": 39.99,
          "formatted_current": "$29.99",
          "formatted_regular": "$39.99",
          "comparison_type": "reg",
          "save_amount": 10,
          "save_percent": 25,
          "is_on_sale": true
        },
        "rating": {},
        "parent_tcin": "94482826",
        "bullets": [
          {
            "label": "Dimensions (Overall)",
            "value": "12.24 Inches (H) x 10.35 Inches (W) x 6.65 Inches (D)"
          },
          {
            "label": "Weight",
            "value": "2.68 Pounds"
          },
          {
            "label": "Features",
            "value": "Automatic Shut-Off"
          }
        ],
        "badges": [
          "4k+ bought in last month"
        ]
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 13,
      "total_results": 293,
      "per_page": 24,
      "has_next_page": true
    },
    "sort_by": "relevance",
    "sort_options": [
      "relevance",
      "featured",
      "price_low"
    ],
    "store_id": "3991",
    "facets": [
      {
        "id": "d_deals",
        "name": "Deals",
        "type": "checkbox",
        "options": [
          {
            "name": "All Deals",
            "value": "all deals"
          },
          {
            "name": "Sale",
            "value": "sale"
          },
          {
            "name": "Weekly Ad",
            "value": "weekly ad"
          }
        ]
      },
      {
        "id": "d_channel",
        "name": "Shipping & Pickup",
        "type": "checkbox",
        "options": [
          {
            "name": "buy online & pick up",
            "value": "buy online & pick up"
          },
          {
            "name": "get it today",
            "value": "get it today"
          },
          {
            "name": "in stores",
            "value": "in stores"
          }
        ]
      },
      {
        "id": "d_item_type_all",
        "name": "Type",
        "type": "checkbox",
        "options": [
          {
            "name": "Automatic Espresso Makers",
            "value": "automatic espresso makers"
          },
          {
            "name": "Coffee Maker Parts and Accessories",
            "value": "coffee maker parts and accessories"
          },
          {
            "name": "Coffee Percolators",
            "value": "coffee percolators"
          }
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "duration_ms": 904,
    "request_id": "req_da296619b75b4499bb0170c2c6f6bc72",
    "credits_charged": 1,
    "credits_remaining": 1945
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#tcinstringtitlestringbrandstringurlurldpcistringdepartment_idintegerclass_idintegeritem_typestringimagesobjectpriceobjectratingobjectbulletsobject[]badgesstring[]
191863920Mr. Coffee 12-Cup Programmable Coffee Maker BlackMr. Coffeehttps://www.target.com/p/mr-coffee-12c-programmable-drip-coffee-maker-stainless-steel-finish/-/A-91863920072-08-0313728Coffee Makers{2 fields}{8 fields}{2 fields}[3 items][1 item]
291863923Mr. Coffee 12-Cup Switch Coffee Maker Black: Electric Drip Coffee Machine, 60 oz Capacity, Dishwasher-Safe PartsMr. Coffeehttps://www.target.com/p/mr-coffee-12c-drip-coffee-maker-black/-/A-91863923072-08-0315728Coffee Makers{2 fields}{4 fields}{2 fields}[3 items][1 item]
394482782bella 12 Cup Programmable Coffee Maker Oatmilkbellahttps://www.target.com/p/bella-12-cup-programmable-coffee-maker-oatmilk/-/A-94482782072-08-6593728Coffee Makers{2 fields}{8 fields}{0 fields}[3 items][1 item]

Recorded from our API · 3 items shown · 13 datapoints per itemGET /v1/target/search?query=coffee+maker

13 datapoints

Identity

  • titlestring
  • brandstring
  • department_idinteger
  • class_idinteger
  • item_typestring

Contact

  • urlurl

Reputation

  • imagesobject
  • ratingobject
  • badgesstring[]

Price

  • priceobject

Other

  • tcinstring
  • dpcistring
  • bulletsobject[]

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/target/search?query=coffee+maker" \
  -H "X-API-Key: $API_KEY"

Target · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/target/product
tcin+4 optional
1–2 credits
GET/v1/target/reviews
tcin+5 optional
1 credit
GET/v1/target/search
query+8 optional
1 credit
GET/v1/target/stores
zip
1 credit

Overview

About the Target API

What you can get

The Target API returns Target product and store data as JSON through 4 endpoints.

  • Search: search takes a query, with page, sort (relevance, featured, price_low, price_high, rating_high, bestselling or newest), min_price, max_price, category, store_id, zip and include_fulfillment.
  • Products: product takes a tcin, with url, store_id, zip and include_fulfillment.
  • Reviews: reviews takes a tcin, with page, size, verified_only, photos_only and sort (most_recent, highest_rating, lowest_rating or helpfulness_desc).
  • Stores: stores takes a zip.

The recorded search for "coffee maker" returns results, each with tcin, title, brand, url, dpci, item_type, images, price (current, regular, save_amount, save_percent and is_on_sale), rating (average and count), bullets and badges. It also returns pagination with total_results (293 in that recording), total_pages and has_next_page, plus the store_id it used, sort_options and facets.

How a call works

Search, then look up: GET /v1/target/search?query=coffee+maker with your key in the X-API-Key header returns each product's tcin; product and reviews take a tcin. For a local store, find one with GET /v1/target/stores?zip=55401 and pass its id as store_id. Every successful call costs 1 credit, except product with include_fulfillment, which costs 2 when store availability loads; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

Use cases

Track Target prices and sale prices for a product list

Use the Target API to track Target prices and sale prices for a product list

Check a product's availability at a nearby store

Use the Target API to check a product's availability at a nearby store

Watch bestselling and newest products for a query

Use the Target API to watch bestselling and newest products for a query

Analyse verified or photo reviews by rating

Use the Target API to analyse verified or photo reviews by rating

FAQ

Questions

How much does the Target API cost?

Each successful call costs one credit. A `product` call with `include_fulfillment` costs one more when store availability loads, so two in all. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I check stock at a specific store?

Yes. Pass a `store_id` or `zip` to `product` with `include_fulfillment`. `stores` finds stores by `zip`.

Do I need a Target account?

No. You call this Target API with your Perceptlayer key in the `X-API-Key` header, with no Target login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Target scraper instead?

You can, but a Target scraper is code you maintain: page changes break it, requests get blocked, and Target's terms govern how you collect data. The Target API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Target API with 100 free credits

No credit card. Failed calls are never billed.