Pinterest Filtering API
There are two ways to narrow a Pinterest search. type and less_ai work like Pinterest's "Filters" menu and "Less AI" filter. The options of filters and the related_searches refine the query instead: each one is a new search for its own query.
To apply an option, search its query in q, or follow its serpapi_link, which also keeps type and less_ai.
The API endpoint is https://serpapi.com/search?engine=pinterest
Head to the playground for a live and interactive demo.
API parameters
API examples
Result for q: coffee corner ideas
filters are the dropdowns under Pinterest's search bar, like "Style", each with its options. related_searches are the chips next to them. Each option and related search has its query, its link on Pinterest, and its serpapi_link.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "coffee corner ideas"
},
"related_searches": [
{
"name": "Small spaces",
"query": "coffee corner ideas small spaces",
"thumbnail": "https://i.pinimg.com/60x60/b1/4d/d7/b14dd795be300ef5ee4aea1d0c6121f2.jpg",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20small%20spaces&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+small+spaces"
},
{
"name": "Countertop",
"query": "coffee corner ideas countertop",
"thumbnail": "https://i.pinimg.com/60x60/8a/e7/eb/8ae7ebdeb7e8647220c5b9b660c1d6d4.jpg",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20countertop&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+countertop"
},
...
],
"filters": [
{
"name": "Style",
"options": [
{
"name": "Modern",
"query": "coffee corner ideas modern",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20modern&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+modern"
},
{
"name": "Simple",
"query": "simple coffee corner ideas",
"link": "https://www.pinterest.com/search/pins/?q=simple%20coffee%20corner%20ideas&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=simple+coffee+corner+ideas"
},
...
]
},
{
"name": "Fixture",
"options": [
{
"name": "Bar",
"query": "corner coffee bar ideas",
"link": "https://www.pinterest.com/search/pins/?q=corner%20coffee%20bar%20ideas&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=corner+coffee+bar+ideas"
},
...
]
},
{
"name": "Room",
"options": [
{
"name": "Kitchen",
"query": "coffee corner ideas kitchen",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20kitchen&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+kitchen"
},
...
]
},
...
],
...
}
Result for q: coffee corner ideas modern (a filter option)
Applying the "Modern" option of the "Style" filter searches for its query, coffee corner ideas modern. The filters of that search refine it further: the "Kitchen" option of its "Room" filter searches for coffee corner ideas modern kitchen.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "coffee corner ideas modern"
},
"related_searches": [
{
"name": "Luxury bar",
"query": "coffee corner ideas modern luxury bar",
"thumbnail": "https://i.pinimg.com/60x60/1d/45/cf/1d45cff0490752ed7c1daab7951aa3c1.jpg",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20modern%20luxury%20bar&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+modern+luxury+bar"
},
...
],
"filters": [
{
"name": "Room",
"options": [
{
"name": "Living room",
"query": "coffee corner ideas modern in living room",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20modern%20in%20living%20room&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+modern+in+living+room"
},
{
"name": "Kitchen",
"query": "coffee corner ideas modern kitchen",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20modern%20kitchen&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+modern+kitchen"
},
...
]
}
],
"pins": [
...
],
...
}
Result for type: products
type searches pins (default), videos, boards, profiles, or products, like the "Filters" menu of Pinterest's search bar. Searches for pins, videos, and products have related searches, and some also have filters; their SerpApi links keep the type. Searches for boards and profiles have neither.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "coffee table",
"type": "products"
},
"filters": [
{
"name": "Ideas",
"options": [
{
"name": "Design",
"query": "coffee table design",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20table%20design&rs=typed&commerce_only=True",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+table+design&type=products"
},
...
]
},
...
],
"pins": [
{
"pin_id": "e1_AfqPShxukFikJvKSS_389L13IRwl9yhrwx-pXle5KOGcvFrgTGIhHg",
"title": "Rectangle Coffee Table Solid Wood Coffee Table with Storage Shelf,Farmhouse 2-Tier Center Table Lacquered Classical Legs",
"link": "https://www.bedbathandbeyond.com/c/living-room-tables/coffee-tables?t=24449&featuredproduct=44315735&featuredoption=93852388",
"source": "bedbathandbeyond.com",
"price": "$249.99",
"extracted_price": 249.99,
"currency": "USD",
"in_stock": true,
...
},
...
],
...
}
Result for less_ai: true
less_ai shows fewer AI-generated and AI-modified pins, like Pinterest's "Less AI" filter. The SerpApi links of related_searches and filters keep it, so their options apply on top of it.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "fall outfits women",
"less_ai": true
},
"related_searches": [
{
"name": "2025",
"query": "fall outfits women 2025",
"thumbnail": "https://i.pinimg.com/60x60/6b/d8/7a/6bd87a0230384928caeb5ad950d233af.jpg",
"link": "https://www.pinterest.com/search/pins/?q=fall%20outfits%20women%202025&rs=typed&filter_genai=true",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&less_ai=true&q=fall+outfits+women+2025"
},
...
],
"filters": [
{
"name": "Accessories",
"options": [
{
"name": "Hats",
"query": "fall hats for women outfits",
"link": "https://www.pinterest.com/search/pins/?q=fall%20hats%20for%20women%20outfits&rs=typed&filter_genai=true",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&less_ai=true&q=fall+hats+for+women+outfits"
},
...
]
},
...
],
...
}
JSON structure overview
{
...
"related_searches": [
{
"name": "String - Name of the related search. (Ex. Small spaces)",
"query": "String - Query of the related search. (Ex. coffee corner ideas small spaces)",
"thumbnail": "String - Link to the thumbnail of the related search.",
"link": "String - Link to the related search on Pinterest.",
"serpapi_link": "String - SerpApi link to the related search."
}
],
"filters": [
{
"name": "String - Name of the filter. (Ex. Style)",
"options": [
{
"name": "String - Name of the option. (Ex. Modern)",
"query": "String - Query of the option. Search it in q to apply the option. (Ex. coffee corner ideas modern)",
"link": "String - Link to the search of the option on Pinterest.",
"serpapi_link": "String - SerpApi link to the search of the option."
}
]
}
],
...
}