Piloterr

Target Search

GET
/v2/target/search

Search Target.com by keyword or search URL. Returns product cards with price, rating and pagination via browser rendering.

Credit cost: 2 credits per call

Autorización

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

Keyword or Target search URL.

Examples:

shampoo
root touch up hair dye
https://www.target.com/s?searchTerm=shampoo
page?string

Page number (1-based).

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

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/target/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.target.com/p/l-oreal-paris-magic-root-rescue-10-minute-root-hair-coloring-kit/-/A-54397299",      "name": "L'Oreal Paris Magic Root Rescue 10 Minute Root Hair Coloring Kit",      "tcin": "54397299",      "brand": "L'Oreal Paris",      "price": 6.99,      "rating": 4,      "currency": "USD",      "image_url": "https://target.scene7.com/is/image/Target/GUEST_c22ac354-59d7-4187-ab0b-8cd8a4707e07?qlt=65&fmt=webp&hei=350&wid=350",      "sponsored": true,      "review_count": 1525    }  ],  "pagination": {    "next": "https://www.target.com/s?searchTerm=root+touch+up+hair+dye&Nao=24",    "page": 1,    "per_page": 24,    "total_pages": 9,    "total_results": 201  }}