Pinterest API: Recherche — Épingles par requête

Ce que fait cet endpoint

Ce que vous pouvez construire avec cette méthode d'API

Examinez d'abord le résultat et les flux courants, puis passez aux paramètres et à un exemple de requête fonctionnel.

À quoi sert cet endpoint

La réponse contient les Recherche correspondants, le contexte public et les données de pagination lorsque d'autres résultats sont disponibles.

Quand l'utiliser

Utilisez « Épingles par requête » lorsque vous ne connaissez pas l'identifiant exact de l'objet et devez d'abord trouver des candidats pertinents.

Cas d'usage courants

Recherche dans le produit

Ajoutez la recherche dans les données Pinterest aux interfaces clients et internes.

Constitution de catalogues

Trouvez des candidats par requête et conservez les objets pertinents pour un enrichissement ultérieur.

Études de marché

Collectez des ensembles de résultats pour analyser les sujets, les créateurs et la concurrence.

Versions disponibles

Version de la réponse

Les deux versions répondent au même besoin et acceptent les mêmes paramètres. Utilisez le sélecteur pour comparer la structure de la réponse et choisissez la version attendue par votre client.

Version de la réponse V2

Changez de version sur cette page pour comparer les structures de réponse sous la même URL de documentation.

Ce qui reste identique

L'authentification, les paramètres obligatoires et la forme de la requête sont identiques en V1 et V2. En pratique, vous choisissez la version en construisant le chemin de l'endpoint et en lisant la réponse.

Ce qui change entre les versions

La principale différence réside dans l'enveloppe de la réponse. Utilisez V2 pour les nouvelles intégrations et ne conservez V1 que si vous avez besoin de compatibilité avec un contrat client existant.

Comment l'utiliser

Comment appeler la méthode

Utilisez le même en-tête de clé API et les mêmes paramètres de requête dans les deux versions. Cette documentation présente d'abord l'ensemble commun de paramètres, puis les chemins et extraits de code de chaque version.

Paramètres d'entrée

Paramètres communs

Paramètre	Obligatoire	Type	Exemple	Description
`query`	Oui	`str`	`home decor`	Requête de recherche saisie par l'utilisateur.
`cursor`	Non	`str \| None`	`cursor-next-page`	Curseur de la page suivante issu de la réponse précédente. À omettre pour la première page.

Chemin de requête par version

V2

Choisissez une version lorsque vous copiez le chemin exact de l'endpoint, l'URL d'exemple et l'extrait de code. La liste des paramètres ci-dessus ne change pas.

GET /api/v2/pinterest.com/search/pins-by-query

Format normalisé

Aperçu de la requête

URL de base https://www.scrapestorm.net

Endpoint /api/v2/pinterest.com/search/pins-by-query

Paramètres obligatoires

query

Paramètres facultatifs

cursor

URL d'exemple

https://www.scrapestorm.net/api/v2/pinterest.com/search/pins-by-query?query=home+decor

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/pinterest.com/search/pins-by-query" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'query=home decor' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/pinterest.com/search/pins-by-query"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "query": "home decor",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/pinterest.com/search/pins-by-query";

const params = new URLSearchParams({
  query: "home decor",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  query: "home decor",
};

// Optional parameters
// params.cursor = "cursor-next-page";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "query" => "home decor",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v2/pinterest.com/search/pins-by-query", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/pinterest.com/search/pins-by-query"

    params := url.Values{}
    params.Set("query", "home decor")

    // Optional parameters
    // params.Set("cursor", "cursor-next-page")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Chemin de requête par version

V1

Choisissez une version lorsque vous copiez le chemin exact de l'endpoint, l'URL d'exemple et l'extrait de code. La liste des paramètres ci-dessus ne change pas.

GET /api/v1/pinterest.com/search/pins-by-query

Format natif de la plateforme

Aperçu de la requête

URL de base https://www.scrapestorm.net

Endpoint /api/v1/pinterest.com/search/pins-by-query

Paramètres obligatoires

query

Paramètres facultatifs

cursor

URL d'exemple

https://www.scrapestorm.net/api/v1/pinterest.com/search/pins-by-query?query=home+decor

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/pinterest.com/search/pins-by-query" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'query=home decor' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/pinterest.com/search/pins-by-query"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "query": "home decor",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/pinterest.com/search/pins-by-query";

const params = new URLSearchParams({
  query: "home decor",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  query: "home decor",
};

// Optional parameters
// params.cursor = "cursor-next-page";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "query" => "home decor",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v1/pinterest.com/search/pins-by-query", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/pinterest.com/search/pins-by-query"

    params := url.Values{}
    params.Set("query", "home decor")

    // Optional parameters
    // params.Set("cursor", "cursor-next-page")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Exemple de réponse

Réponse en direct par version

L'aperçu contient les champs clés et les premiers éléments de la collection pour vous permettre de vérifier rapidement la forme de la réponse. Le format JSON change avec la version.

Exemple de réponse

V2 JSON de réponse

Exemple vérifié

Cet exemple JSON compact provient de la dernière vérification réussie de V2.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "query": "home decor"
  },
  "data": {
    "pins": {
      "count": 7,
      "items": [
        {
          "url": "https://www.pinterest.com/pin/225039312627881892/",
          "pin_id": "225039312627881892",
          "aggregated_pin_id": "5263188580060150572",
          "title": "Cozy Reading Nook",
          "description": "Neva Round Daybed in Recycled Faux Fur color: Pampas Grass Featured on Instagram @ladyofbookshire",
          "emails": [],
          "hashtags": [],
          "link": "https://sixpenny.com/products/neva-round-daybed-slipcover-only?currency=USD&variant=40241699946540&utm_medium=cpc&utm_source=google&utm_campaign=Google+Shopping&gclid=EAIaIQobCh…",
          "domain": "sixpenny.com",
          "created_at": "2022-11-05T14:37:02+00:00",
          "reaction_count": 1616,
          "comment_count": null,
          "board": {
            "url": "https://www.pinterest.com/erinturnage/reading-room-inspo/",
            "board_id": "225039381319533959",
            "name": "Reading Room Inspo",
            "pin_count": 4,
            "collaborator_count": 0,
            "section_count": 0,
            "is_collaborative": false,
            "modified_at": "2023-02-10T03:09:22+00:00",
            "owner": {
              "url": "https://www.pinterest.com/erinturnage/",
              "user_id": "225039450038600465",
              "username": "erinturnage",
              "display_name": "Erin Turnage",
              "follower_count": 87,
              "verified": null,
              "avatar_url": "https://example.com/image.jpg"
            },
            "thumbnail_url": "https://example.com/image.jpg"
          },
          "pinner": {
            "url": "https://www.pinterest.com/erinturnage/",
            "user_id": "225039450038600465",
            "username": "erinturnage",
            "display_name": "Erin Turnage",
            "follower_count": 87,
            "verified": null,
            "avatar_url": "https://example.com/image.jpg"
          },
          "tags": [
            "Home Living Room",
            "Dream House Decor",
            {
              "_more_items": 7
            }
          ],
          "dominant_color": "#6c5942",
          "thumbnail_url": "https://example.com/image.jpg",
          "images": [
            {
              "url": "https://i.pinimg.com/236x/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg",
              "width": 236,
              "height": 445
            },
            {
              "url": "https://i.pinimg.com/474x/2c/24/91/2c24917f5d44c73a48b10de4692f3467.jpg",
              "width": 474,
              "height": 895
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "url": "https://www.pinterest.com/pin/696439529923803956/",
          "pin_id": "696439529923803956",
          "aggregated_pin_id": "3159035064123023616",
          "title": "🌸 Finally—a fluffy rug that doesn't shed everywhere",
          "description": "Your Room Deserves This Kind of Soft You know that feeling when you walk into a room and it just feels... right? Warm. Put-together. Like someone actually thought about it.  Tha…",
          "emails": [],
          "hashtags": [],
          "link": "https://clarendale.co/products/velura%E2%84%A2-gradient-plush-rug-for-cozy-rooms?utm_campaign=626757503084&utm_ad_group=2680088796241&utm_ad=687300955419&utm_source=pinterest&pp=1",
          "domain": "clarendale.co",
          "created_at": "2026-07-06T00:25:51+00:00",
          "reaction_count": 4178,
          "comment_count": null,
          "board": {
            "url": "https://www.pinterest.com/Io_Gabriiiell_A/deco/",
            "board_id": "696439598566996202",
            "name": "DECO",
            "pin_count": 58,
            "collaborator_count": 0,
            "section_count": 0,
            "is_collaborative": false,
            "modified_at": "2026-07-16T02:20:40+00:00",
            "owner": {
              "url": "https://www.pinterest.com/Io_Gabriiiell_A/",
              "user_id": "696439667284860054",
              "username": "Io_Gabriiiell_A",
              "display_name": "IO Gabriiiell ∆",
              "follower_count": 10,
              "verified": null,
              "avatar_url": "https://example.com/image.jpg"
            },
            "thumbnail_url": "https://example.com/image.jpg"
          },
          "pinner": {
            "url": "https://www.pinterest.com/Io_Gabriiiell_A/",
            "user_id": "696439667284860054",
            "username": "Io_Gabriiiell_A",
            "display_name": "IO Gabriiiell ∆",
            "follower_count": 10,
            "verified": null,
            "avatar_url": "https://example.com/image.jpg"
          },
          "tags": [
            "Rug Color",
            "Thick Rug",
            {
              "_more_items": 7
            }
          ],
          "dominant_color": "#796557",
          "thumbnail_url": "https://example.com/image.jpg",
          "images": [
            {
              "url": "https://i.pinimg.com/236x/3c/b7/b0/3cb7b0c54787ae270cb3178ddc5bebcd.jpg",
              "width": 236,
              "height": 354
            },
            {
              "url": "https://i.pinimg.com/474x/3c/b7/b0/3cb7b0c54787ae270cb3178ddc5bebcd.jpg",
              "width": 474,
              "height": 711
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "_more_items": 5
        }
      ]
    }
  }
}

Exemple de réponse

V1 JSON de réponse

Exemple vérifié

Cet exemple JSON compact provient de la dernière vérification réussie de V1.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "query": "home decor"
  },
  "data": {
    "resource_response": {
      "bookmark": "Y2JVSG81V2sxcmNHRlpWM1J5VFVaU2NscEhSbE5XYlZKYVdXdGFRMVl4U25Sa1JFNVhVbnBXTTFVeU1WZGphelZXVm14YVYxSnJjRkpXVjNSaFkyMVdSMVZzWkZaaVZGWnhWbTEwYzA1R1ZuUmpNMmhWVWpCd01WZFljRU5YUmxwMFZXc…",
      "code": 0,
      "endpoint_name": "v3_search_pins",
      "http_status": 200,
      "message": "ok",
      "status": "success",
      "x_pinterest_sli_endpoint_name": "v3_search_pins",
      "metadata": {
        "query_shopping_intent_score": 0.5373958927701674
      },
      "data": {
        "clientTrackingParams": "CwABAAAAEDYyOTY0NzIzNDQ4ODY1MTgGAAMACAsADQAAABA2Mjk2NDcyMzQ0ODg2NTE4AA",
        "nag": {},
        "shouldAppendGlobalSearch": false,
        "results": [
          {
            "id": "RV4mxPIg",
            "tracking_params": "CwABAAAAEDYyOTY0NzIzNDQ4ODY1MTgGAAMACAA",
            "experience_extra_context": {},
            "display_options": {
              "shopping_grid_display": "…",
              "hide_search_guides_when_visible": false,
              "has_condensed_header": false,
              "num_columns_requested": 0,
              "show_separator": false,
              "container_grid_span": 2,
              "header_hidden": false,
              "extra_spacing_after": 0,
              "extra_spacing_before": 0,
              "horizontal_full_bleed": false,
              "show_bottom_divider": false,
              "ideas_card_hide_when_offscreen": false,
              "align_image_bottom": false,
              "use_plain_text_display_mode": false,
              "corner_radius": 0,
              "content_display": "…",
              "show_simplified_pin": false,
              "carousel_fade_ends": 0,
              "show_top_divider": false,
              "ai_fwd_presentation_options": "…",
              "header_display": "…",
              "footer_display": "…"
            },
            "copy": {},
            "dynamic_insertion_options": {},
            "content_ids": [
              "4603171502677205376",
              "4604790001023379840",
              {
                "_more_items": 2
              }
            ],
            "story_type": "shop_tab_upsell",
            "action": {
              "url": "/search/pins/?rs=product_carousel&tab=shop&q=home%20decor&source_id=RV4mxPIg&commerce_only=True&request_params=%7B%2237%22%3A%20%22Shop%20home%20decor%22%2C%20%221%22%3A%20%2294%22%2C%20%2236%22%3A%20%22home%20decor%22%2C%20%2230%22%3A%20%22Shop%20home%20decor%22%2C%20%222%22%3A%20%22Shop%20home%20decor%22%2C%20%2233%22%3A%20%5B%224603171502677205376%22%2C%20%224604790001023379840%22%2C%20%224605564023841488256%22%2C%20%224594868019668488576%22%5D%2C%20%2234%22%3A%20%220%22%2C%20%227%22%3A%20%22RV4mxPIg%22%2C%20%228%22%3A%20%22home%20decor%22%7D&pins_display=2",
              "text": "Show more",
              "request_params": "{\"37\": \"Shop home decor\", \"1\": \"94\", \"36\": \"home decor\", \"30\": \"Shop home decor\", \"2\": \"Shop home decor\", \"33\": [\"4603171502677205376\", \"4604790001023379840\", \"4605564023841488256\", \"4594868019668488576\"], \"34\": \"0\", \"7\": \"RV4mxPIg\", \"8\": \"home decor\"}",
              "location": 3,
              "style": 0,
              "pins_display": 2,
              "end_card_images": "…",
              "quick_save_icon": 0,
              "show_landing_page_hero": false
            },
            "custom_properties": {},
            "title": {
              "format": "Shop home decor",
              "args": "…",
              "args_reformatted": "…"
            },
            "relationships": {},
            "container_type": 90,
            "mapped_display_options": {},
            "objects": [
              "…",
              "…",
              {
                "_more_items": 2
              }
            ],
            "type": "story",
            "node_id": "__EMPTY__"
          },
          {
            "id": "5173793291037562383",
            "tracking_params": "CwABAAAAEDYyOTY0NzIzNDQ4ODY1MTgGAAMACAA",
            "experience_extra_context": {},
            "display_options": {
              "hide_search_guides_when_visible": false,
              "has_condensed_header": false,
              "num_columns_requested": 0,
              "show_separator": false,
              "container_grid_span": 2,
              "header_hidden": false,
              "extra_spacing_after": 0,
              "extra_spacing_before": 0,
              "horizontal_full_bleed": false,
              "show_bottom_divider": false,
              "ideas_card_hide_when_offscreen": false,
              "align_image_bottom": false,
              "use_plain_text_display_mode": false,
              "corner_radius": 0,
              "show_simplified_pin": false,
              "carousel_fade_ends": 0,
              "show_top_divider": false,
              "ai_fwd_presentation_options": "…",
              "header_display": "…"
            },
            "copy": {},
            "dynamic_insertion_options": {},
            "content_ids": [],
            "story_type": "search_story_separator",
            "custom_properties": {},
            "title": {
              "format": "More ideas",
              "args": "…",
              "args_reformatted": "…"
            },
            "relationships": {},
            "container_type": 88,
            "mapped_display_options": {},
            "objects": [],
            "type": "story",
            "node_id": "__EMPTY__"
          },
          {
            "_more_items": 7
          }
        ],
        "rankedGuides": [
          {
            "term": "home decor ideas",
            "display": "Ideas",
            "position": -1,
            "dominant_color": "#7a654a",
            "source": 9,
            "guideType": 0,
            "image_medium_url": "https://i.pinimg.com/60x60/bb/c0/2a/bbc02a6d3523e2a039dc457444de19b6.jpg",
            "subtracted_attributes": [],
            "score": 13.74494196347812
          },
          {
            "term": "diy home decor",
            "display": "Diy",
            "position": -1,
            "dominant_color": "#989288",
            "source": 9,
            "guideType": 0,
            "image_medium_url": "https://i.pinimg.com/60x60/16/90/93/169093f8ad1623611c8ef11a176df791.jpg",
            "subtracted_attributes": [],
            "score": 12.364019393203414
          },
          {
            "_more_items": 8
          }
        ],
        "sensitivity": {},
        "oneBarModules": [
          {
            "module_type": 0,
            "action": {
              "filters": "…",
              "id": "-1734449582590210971",
              "filter_type": 0,
              "title": "Filters",
              "id_reformatted": "-1734449582590210971",
              "type": "contenttypefiltermoduleaction"
            },
            "id": "5247486355220583601",
            "type": "onebarmodule",
            "animation": 0,
            "display": {
              "selected_text_color_hex": "…",
              "image_urls": [],
              "selected_border_color_hex": "…",
              "id": "2458070944038924620",
              "text_color_hex": "…",
              "border_color_hex": "…",
              "is_selected": false,
              "icon": 3,
              "id_reformatted": "2458070944038924620",
              "type": "onebarmoduledisplay",
              "selected_background_color_hex": "…",
              "secondary_text_color_hex": "…",
              "background_color_hex": "…"
            }
          },
          {
            "module_type": 17,
            "action": {
              "id": "-1686058478899134738",
              "type": "shopfiltermoduleaction",
              "filter": "…"
            },
            "id": "8905892088050080531",
            "aux_data": {
              "label": "Price",
              "subtracted_attributes": "…",
              "journey_depth": 0,
              "module_type": "SHOP_FILTER",
              "options": "…",
              "module_id": "OB_PriceRange_60a95f5a-37f2-43d4-a47d-1d4c389c0a8a",
              "query": "home decor",
              "rs": "direct_navigation",
              "product_filter_type": "PRODUCT_PRICE"
            },
            "type": "onebarmodule",
            "animation": 0,
            "display": {
              "selected_text_color_hex": "…",
              "image_urls": [],
              "selected_border_color_hex": "…",
              "id": "3560232843938949991",
              "text_color_hex": "…",
              "border_color_hex": "…",
              "is_selected": false,
              "icon": 7,
              "id_reformatted": "3560232843938949991",
              "type": "onebarmoduledisplay",
              "selected_background_color_hex": "…",
              "display_text": "Price",
              "secondary_text_color_hex": "…",
              "background_color_hex": "…"
            }
          },
          {
            "_more_items": 29
          }
        ],
        "queryL1VerticalIds": [
          935249274030
        ],
        "productFilters": {
          "priceFilters": {
            "currency_type": "USD",
            "min_value": 1,
            "max_value": 5100,
            "suggested_max_value": 700,
            "filter_id": "9749519455",
            "min_option_id": "9036720075",
            "max_option_id": "7594789270",
            "suggested_max_option_id": "9390980317"
          }
        }
      }
    },
    "client_context": {
      "analysis_ua": {
        "app_type": 5,
        "app_version": "",
        "browser_name": "Chrome",
        "browser_version": "145.0.0",
        "device_type": null,
        "device": "Other",
        "os_name": "Windows 10",
        "os_version": "10"
      },
      "app_type_detailed": 5,
      "app_version": "e86b6e0",
      "autologin": null,
      "browser_locale": "en-US",
      "browser_name": "Chrome",
      "browser_type": 1,
      "browser_version": "145.0.0",
      "country": "US",
      "country_from_hostname": "US",
      "country_from_ip": "US",
      "csp_nonce": "705e2d596f00c150f37c4a9c90e0f6e3",
      "current_url": "https://www.pinterest.com/resource/BaseSearchResource/get/?source_url=/search/pins/?q%3Dhome%2Bdecor&data=%7B%22options%22:%7B%22query%22:%22home+decor%22,%22scope%22:%22pins%22…",
      "debug": false,
      "deep_link": "",
      "enabled_advertiser_countries": [
        "AR",
        "AT",
        {
          "_more_items": 24
        }
      ],
      "facebook_token": null,
      "full_path": "/resource/BaseSearchResource/get/?source_url=/search/pins/?q%3Dhome%2Bdecor&data=%7B%22options%22:%7B%22query%22:%22home+decor%22,%22scope%22:%22pins%22,%22rs%22:%22direct_navig…",
      "http_referrer": "https://www.pinterest.com/",
      "impersonator_user_id": null,
      "invite_code": "",
      "invite_sender_id": "",
      "is_authenticated": false,
      "is_bot": "false",
      "_more_fields": "33 more fields"
    },
    "resource": {
      "name": "BaseSearchResource",
      "options": {
        "bookmarks": [
          "Y2JVSG81V2sxcmNHRlpWM1J5VFVaU2NscEhSbE5XYlZKYVdXdGFRMVl4U25Sa1JFNVhVbnBXTTFVeU1WZGphelZXVm14YVYxSnJjRkpXVjNSaFkyMVdSMVZzWkZaaVZGWnhWbTEwYzA1R1ZuUmpNMmhWVWpCd01WZFljRU5YUmxwMFZXc…"
        ],
        "query": "home decor",
        "scope": "pins",
        "rs": "direct_navigation",
        "redux_normalize_feed": true,
        "page_size": 10
      }
    },
    "request_identifier": "6296472344886518"
  }
}

Méthodes associées

Continuez avec Recherche

Les méthodes associées résolvent le même objet par un autre identifiant, ouvrent des détails ou passent à une vue agrégée.

Étapes suivantes

Poursuivez l'évaluation

Utilisez cette documentation comme premier point de décision, puis vérifiez les prix, la couverture de la plateforme et les règles d'intégration avant de connecter l'endpoint pour un usage récurrent.

Ouvrez la page de la plateforme Pinterest

Comparez les entités associées, les groupes de méthodes d'API et la documentation liée avant l'implémentation.

Ouvrir la page de la plateforme

Comparez les prix des méthodes d'API

Vérifiez la place de cette méthode dans le tableau public des tarifs avant d'augmenter l'utilisation.

Voir les tarifs

Consultez les règles d'intégration

Confirmez l'authentification, les versions, les nouvelles tentatives et les différences entre test et production dans la documentation de démarrage.

Ouvrir la documentation

Questions fréquentes

Les questions que posent les équipes avant l'implémentation

Utilisez ces réponses pour décider si cette méthode d'API convient à votre flux, à votre choix de version et à votre plan de déploiement.

Quelles données renvoie cette méthode de l'API Pinterest ?

La méthode exécute « Épingles par requête » pour Recherche. L'exemple de réponse compact ci-dessous montre la structure exacte des champs.

Dois-je choisir V1 ou V2 ?

Choisissez V2 pour les nouvelles intégrations, car elle fournit une structure normalisée. N'utilisez V1 que pour la compatibilité avec des clients qui traitent déjà le format natif de la plateforme.

De quoi ai-je besoin pour la première requête ?

Créez une clé API, envoyez-la dans l'en-tête de la requête et renseignez les paramètres obligatoires du tableau. Les exemples de code contiennent déjà le bon chemin et la bonne structure de requête.

Pinterest API: Recherche — Épingles par requête

Ce que vous pouvez construire avec cette méthode d'API

À quoi sert cet endpoint

Quand l'utiliser

Cas d'usage courants

Recherche dans le produit

Constitution de catalogues

Études de marché

Version de la réponse

Ce qui reste identique

Ce qui change entre les versions

Comment appeler la méthode

Paramètres d'entrée

Chemin de requête par version

Exemples de code

Chemin de requête par version

Exemples de code

Réponse en direct par version

V2 JSON de réponse

V1 JSON de réponse

Continuez avec Recherche

Recherche: Métriques des épingles par requête

Recherche: Suggestions par terme

Poursuivez l'évaluation

Ouvrez la page de la plateforme Pinterest

Comparez les prix des méthodes d'API

Consultez les règles d'intégration

Les questions que posent les équipes avant l'implémentation