ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceBoardsList a board's ads

List a board's ads

GET/api/v1/boards/{id}/items

The ads saved in the board, newest save first.

Bearer API keyMCP tool list_board_items

Path parameters

idstringrequired

Board id.

Query parameters

limitintegerdefault 50

1–200.

Try it

GET/api/v1/boards/8b7c6d5e-4f3a-4b2c-9d1e-0f1a2b3c4d5e/items
curl "https://provly.co/api/v1/boards/8b7c6d5e-4f3a-4b2c-9d1e-0f1a2b3c4d5e/items" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": [
    {
      "id": "meta_library_1203944578113742",
      "advertiser": {
        "id": "meta_library_104587213",
        "name": "Pawfect Co."
      },
      "platforms": [
        "facebook",
        "instagram"
      ],
      "format": "video",
      "headline": "The self-cleaning litter box cats love",
      "body": "No scooping for 14 days. 30-day money-back guarantee.",
      "cta": "Shop now",
      "landing_url": "https://pawfect.co/products/autobox",
      "is_active": true,
      "started_at": "2026-07-02T00:00:00.000Z",
      "ended_at": null,
      "running_days": 86,
      "countries": [
        "TR",
        "DE"
      ],
      "languages": [
        "tr"
      ],
      "niches": [
        "pet-supplies"
      ],
      "media": {
        "image": null,
        "video": "https://media.provly.co/meta/1203944578113742.mp4",
        "thumbnail": "https://media.provly.co/meta/1203944578113742.jpg",
        "video_duration": 27
      },
      "reach": 184200,
      "engagement": null,
      "duplicates": 6,
      "transcript": "Tired of scooping every day? …",
      "provly_url": "https://provly.co/app?ad=meta_library_1203944578113742"
    }
  ],
  "pagination": {
    "total": 1284,
    "next_cursor": null
  }
}