Piloterr

Target Product

GET
/v2/target/product

Get a Target.com product page: price, description, images and variations via browser rendering.

Credit cost: 2 credits per call

Autorização

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parâmetros de consulta

query*string

Target product URL or bare TCIN.

Examples:

17457624
https://www.target.com/p/-/A-17457624
https://www.target.com/p/l-oreal-paris-magic-root-cover-up-medium-brown-2-0oz/-/A-17457624
return_page_source?boolean

When true, return rendered HTML instead of JSON.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corpo da resposta

Successful response

application/json
  1. response
upc?string
url?string
dpci?string
name?string
tcin?string
brand?string
price?number
images?array<string>
rating?number
currency?string
ornaments?array<string>
highlights?array<string>
variations?array<>
breadcrumbs?array<>
description?string
ingredients?unknown
review_count?integer
bullet_descriptions?array<string>
Example Request
curl -X GET 'https://api.piloterr.com/v2/target/product?query=string'
Example Response
{  "upc": "071249318553",  "url": "https://www.target.com/p/l-oreal-paris-magic-root-cover-up-medium-brown-2-0oz/-/A-17457624",  "dpci": "063-01-0615",  "name": "L'Oreal Paris Magic Root Cover Up - Medium Brown - 2.0oz",  "tcin": "17457624",  "brand": "L'Oreal Paris",  "price": 11.99,  "images": [    "https://target.scene7.com/is/image/Target/GUEST_2947578e-fc62-4731-a22a-42211a91cbe5"  ],  "rating": 4.02,  "currency": "USD",  "ornaments": [    "Rarely returned",    "Highly rated"  ],  "highlights": [    "Conceals grays in seconds for flawless roots",    "Lightweight formula, no smudging or sticky residue"  ],  "variations": [    {      "url": "https://www.target.com/p/l-oreal-paris-magic-root-cover-up-medium-brown-2-0oz/-/A-17457624",      "name": "Color",      "tcin": "17457624",      "value": "Medium Brown",      "selected": true    },    {      "url": "https://www.target.com/p/l-oreal-paris-magic-root-cover-up-black-2-0oz/-/A-17457618",      "name": "Color",      "tcin": "17457618",      "value": "Black",      "selected": false    }  ],  "breadcrumbs": [    {      "url": "https://www.target.com/",      "name": "Target"    },    {      "url": "https://www.target.com/c/beauty/-/N-55r1x",      "name": "Beauty"    }  ],  "description": "Temporary hair color spray to cover gray roots in seconds. Ammonia-free and sulfate-free.",  "ingredients": null,  "review_count": 7057,  "bullet_descriptions": [    "Hair Type: All Hair Types",    "Product Form: Aerosol",    "Beauty Purpose: Hair Coloring"  ]}