Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Search

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

Pinterest

​

Pins, boards and public profile content.

Pinterest Операции

Search

​

Searches Pinterest for pins matching a keyword and returns pins plus a cursor to page. Each pin carries id, url, title, description, grid_title, created_at, images in five sizes (170x, 236x, 474x, 736x, orig), link, domain, board (name, url, pin_count) and pinner (username). The board.url on each result feeds get_pinterest_board; for one pin's engagement counts use get_pinterest_pin.

Query-параметры
  • query
    Тип: string
    обязательно

    Search query

  • cursor
    Тип: string

    Cursor

  • trim
    Тип: boolean

    Set to true for a trimmed down version of the response

Ответы
  • 200
    Тип: object · PinterestPinsResponse

    Successful response

    • credits_remaining
      Тип: integer

      Integer numbers.

    • cursor
      Тип: string может быть null
    • pins
      Тип: array object[]
      • propertyName
        Тип: anything
    • success
      Тип: boolean
    • propertyName
      Тип: anything
    application/json
  • 400

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/pinterest/search
curl 'https://openapi.felo.ai/v1/beta/pinterest/search?query=Italian%20Pot%20Roast' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "success": true,
  "pins": [
    {
      "id": "643874078015272259",
      "url": "https://www.pinterest.com/pin/643874078015272259",
      "description": "#cute #animal #dog #puppy #pfp #icon #dogpfp #silly #cutepuppy #bordercollie #fyp #trend",
      "created_at": "Tue, 10 Jun 2025 21:45:32 +0000",
      "pinner": {
        "node_id": "VXNlcjo2NDM4NzQyMTUzODQxMzkwMTg=",
        "full_name": "Annika Strøm",
        "is_ads_only_profile": false,
        "username": "annikastrom2",
        "image_medium_url": "https://i.pinimg.com/75x75_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
        "is_primary_website_verified": false,
        "follower_count": 2,
        "ads_only_profile_site": null,
        "id": "643874215384139018",
        "is_verified_merchant": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
        "verified_identity": {},
        "image_small_url": "https://i.pinimg.com/30x30_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg"
      },
      "images": {
        "170x": {
          "width": 236,
          "height": 312,
          "url": "https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "236x": {
          "width": 236,
          "height": 312,
          "url": "https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "474x": {
          "width": 474,
          "height": 626,
          "url": "https://i.pinimg.com/474x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "736x": {
          "width": 736,
          "height": 973,
          "url": "https://i.pinimg.com/736x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "orig": {
          "width": 946,
          "height": 1251,
          "url": "https://i.pinimg.com/originals/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        }
      }
    }
  ],
  "cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWl..."
}

Successful response

Search