# Pinterest Search API Reference Canonical: https://monsterapi.co/docs/api/pinterest-search Read the Pinterest Search reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Pinterest](https://monsterapi.co/docs/openapi/platforms/pinterest.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Pinterest: Boards matching a phrase `GET /pinterest/api/search/boards` Documentation: https://monsterapi.co/docs/api/pinterest#boards-matching-a-phrase Operation ID: `pinterest_search_boards_list` Returns one page of the boards whose name or content matches a search phrase, each board whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `query` (query, required): The search phrase: free text, required, 1 to 256 characters after trimming. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of boards and its continuation - 400: Phrase or cursor outside the accepted format Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: No boards for the phrase, or a page with no boards and no continuation - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Pinterest returned unusable data - 503: Temporarily unavailable or rate limited; check `code` and any `Retry-After` header Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/pinterest/api/search/boards' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Accounts matching a phrase `GET /pinterest/api/search/users` Documentation: https://monsterapi.co/docs/api/pinterest#accounts-matching-a-phrase Operation ID: `pinterest_search_users_list` Returns one page of the accounts whose name matches a search phrase, each account whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `query` (query, required): The search phrase: free text, required, 1 to 256 characters after trimming. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of accounts and its continuation - 400: Phrase or cursor outside the accepted format Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: No accounts for the phrase, or a page with no accounts and no continuation - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Pinterest returned unusable data - 503: Temporarily unavailable or rate limited; check `code` and any `Retry-After` header Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/pinterest/api/search/users' \ -H 'Authorization: Bearer ' ```