PPSPYAPI Platform
EN / 中文
Docs/Ad Monitor/Reference
API REFERENCE

Search Advertisers API

POST/open-api/v1/ad-monitor-task/search-fb-ads-advertiser
·api.ppspy.com
Data and monitoring usage rules

Points Consumption Rules: 1. Retrieving a Shopify data result consumes 1 data, while retrieving an ad library data result consumes 2 data. Retrieving additional data details for a data result does not consume data. 2. Ad monitoring and sales monitoring: Each monitoring session costs $1/month. Each monitoring session is valid for one month and automatically expires after one month. Deleting a monitoring session does not restore the monitoring session, so please delete with caution. Monitoring sessions can be accessed at any time and are unlimited.

Request headers

AUTHORIZATIONAuthorization: {API Key}
CONTENT-TYPEapplication/json
ACCEPTapplication/json

Request example

cURL
curl --location --request POST 'https://api.ppspy.com/open-api/v1/ad-monitor-task/search-fb-ads-advertiser' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}' \
--data-raw '{
    "name": "nike"
}'

Request parameters 2 fields

Pass each parameter in its specified location.

Parameter Type Description
body
body · optional
object | -
» name
body · required
string Advertiser Name | none

Response example

Response · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "facebook_page_id": "51212153078",
                "name": "Nike Football",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/387181570_863325755161415_3589774989337788111_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=VXHg3cDdH_MQ7kNvwGlelIU&_nc_oc=AdmHOxMhLnC56XZI9bvTzMxmYzRI-oK1_TikxtuzfdL0a7-4prNM_5E6aNPyNcbgY5s&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfcSU77YS2Rz-Qeoaq6gP7lp9gpajDxjdZu4M9pEa1wBEg&oe=68FFB585",
                "category": "Product/service",
                "country": null
            },
            {
                "facebook_page_id": "15087023444",
                "name": "Nike",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/284964043_10159903868513445_7696353984967674128_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=102&ccb=1-7&_nc_sid=418b77&_nc_ohc=MOGh_beXBDkQ7kNvwEJ-yr9&_nc_oc=AdlM-Hr6tQSHakGgEkDziL-kduC2PWfD-jjWBzCNUajYUgLKV3mfOwS8V-ozl6Mukig&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_Afe_s_nMawUYiFAfhm1JVZ9c0qWCIlbx_F9Ap5Yt4TVEoA&oe=68FFADB0",
                "category": "Sportswear Store",
                "country": null
            },
            {
                "facebook_page_id": "65604112975",
                "name": "Nike Run Club",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/381660358_828089658776016_1921906525565601948_n.png?stp=dst-png_s100x100&_nc_cat=101&ccb=1-7&_nc_sid=418b77&_nc_ohc=trHWDCcTRIgQ7kNvwEnpMcU&_nc_oc=AdkY0MUtKtlrvS0OGjSKlw106hix4pvN_c1XF04OdtelXakqV0tzbd0_0p2QiGzmjWY&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfdpW64sXD5fnonkgEa5SOj3CzLWN0nAj_asEMVFCPw_yQ&oe=68FFD42A",
                "category": "Sports & Recreation Venue",
                "country": null
            },
            {
                "facebook_page_id": "20825389113",
                "name": "Nike Sportswear",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/352238800_1378999996006774_4240209247781423917_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=7DbKFSQQBJoQ7kNvwHxwch3&_nc_oc=AdndFxJE9ZHC2iUv_4T_28oV27HJoFojwOoUGvAPiUEAnV8S_TglNfQXtUfgmLjvQxU&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfeJBpAWPxBpXGC6KvFudYUcifhO4_9UeFPoXUxg0DNItw&oe=68FFAD9F",
                "category": "Product/service",
                "country": null
            },
            {
                "facebook_page_id": "5941596308",
                "name": "Nike Basketball",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/352779693_291587943296654_5195981052627043005_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=106&ccb=1-7&_nc_sid=418b77&_nc_ohc=4VnGZwbgRJQQ7kNvwHAs2aC&_nc_oc=AdmmjsmlMD7EvEM1Hr6T0MOlNVqgDpZtKnaF3aLRW5bgDWoMNrTpVPzg5cWk8QpNUU0&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AffxTQB6X7xOMS4kk2SpwgyawPwPzj4hiGjPCyVljxLCJA&oe=68FFA252",
                "category": "Product/service",
                "country": null
            },
            {
                "facebook_page_id": "108379289247689",
                "name": "Nike Skateboarding",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/352706208_1588401181639202_901415604300420876_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=110&ccb=1-7&_nc_sid=418b77&_nc_ohc=0DFjCM3TRMkQ7kNvwFoEJ1a&_nc_oc=AdkMlPxNmlTgDSUy9gty60zo1WDz4IaCdNUY5DZWddgQarBjGcGx06lle9K1ajyZvfg&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfdW2SK7XR3QbyZM36zbbiYLzXOScWxVAL7iMYXOsa6TyA&oe=68FFB280",
                "category": "Product/service",
                "country": null
            },
            {
                "facebook_page_id": "6261664682",
                "name": "NikeWomen",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/360155777_843020267183742_6325909005771886494_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=106&ccb=1-7&_nc_sid=418b77&_nc_ohc=X8g11dmgqNIQ7kNvwEXK6q8&_nc_oc=AdkX4n2om6nmZ9croqQi-jcM2PnuYV-j9_zHVgoAEhzvV-HmVHeO58Uwh9ooCNFz8rw&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfdYV8ICKmdWMOGRFDllTlQxypg0S8Z6lDoeH9MlTI-rmg&oe=68FFB3CE",
                "category": "Product/service",
                "country": null
            },
            {
                "facebook_page_id": "1461718484118285",
                "name": "Niké je tipovanie",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/341111328_738870064578442_1225960234040314537_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=100&ccb=1-7&_nc_sid=418b77&_nc_ohc=ALs6l4aOS3cQ7kNvwG7mPeK&_nc_oc=Adn14jV7fTSpU1DhusFI1oLpOLXPuSJtRnvqmUpJPcWCrCeJMcQl6Py9mvEuFnEABfQ&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfdixWfsJzaTWS-ni4AEQacks-CYU2Pdc6c1ul5Ol6GBRQ&oe=68FFADF0",
                "category": "Interest",
                "country": null
            },
            {
                "facebook_page_id": "57460905720",
                "name": "Nike Football",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/352241125_115307234918826_7034162321122119580_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=100&ccb=1-7&_nc_sid=418b77&_nc_ohc=xP1CV-JOKz4Q7kNvwE0KCLO&_nc_oc=AdnqIy3uUJnlyaWAMRY9ky8JAWutstLSxvge4jMIPonpn3BYtwUXJQfe7D8SoFCyJPg&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfcqhbGaXnX8Zfz_fq2Gf7fbsZuyChkLMGdH7Nfnb3tYKw&oe=68FFAC94",
                "category": "Retail Company",
                "country": null
            },
            {
                "facebook_page_id": "128198963716100",
                "name": "Nike Strength",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/387074276_122113082780063867_240960197833276102_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=104&ccb=1-7&_nc_sid=418b77&_nc_ohc=8DW7D2HutjAQ7kNvwGt3GGC&_nc_oc=AdlHgDmWDjht4gf2DECyYY7SRJT8skdYGQhJx0ooqEJ-zs76bin7FMxEXSmIPWyeOpk&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfchtkAX-wEk27We4mP16dWtnPnxrYuQxXYO2G3HeAHudw&oe=68FFC7D3",
                "category": "Brand",
                "country": null
            },
            {
                "facebook_page_id": "1957446251204909",
                "name": "Nikema Williams",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/263004090_404760094355264_2047193406290386818_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=107&ccb=1-7&_nc_sid=418b77&_nc_ohc=2u2JsBmJw-oQ7kNvwFMAla4&_nc_oc=AdnIN2scjW_bKm6SfAh5SMAosB0exFiWziROsh2B3PvEIdm6rRfeGp5fe5KPDPrg_rQ&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AffPFsg7UuQaRueVh1k0MfHiGU2dAclyYAjVnEplDc4x0A&oe=68FFB3B0",
                "category": "Politician",
                "country": null
            },
            {
                "facebook_page_id": "127408080691130",
                "name": "BioNike",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/347645769_657384689752226_3696916042294272251_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=104&ccb=1-7&_nc_sid=418b77&_nc_ohc=8HIAXTDqhnsQ7kNvwEfrjBf&_nc_oc=AdliwI7kN__x6Iv4yqHXqgXXF8OrxbJFmcoTeR7qcEFGqtOO2intr6uivXypk4PHeQ0&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AffnOlipFQD0RgvWR4UgOR_mMdEy99wV4QGlazMBnP-nyA&oe=68FFB920",
                "category": "Health/beauty",
                "country": null
            },
            {
                "facebook_page_id": "119854457758881",
                "name": "nikecosmetics",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/344809380_233665295918187_14815575778860611_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=111&ccb=1-7&_nc_sid=418b77&_nc_ohc=yxZxdGMZ65cQ7kNvwFMA0EN&_nc_oc=AdnZjQPUoSDA64bU9oOQQ9X7aRlsSl5eTsF9KusiYiznEzhvkateKyWjdj90t8ly-so&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfcsX10lwTdxsDsTOM-xV3fEtgAyFL2fw9wT-LGAiojGzA&oe=68FFA912",
                "category": "Beauty, Cosmetic & Personal Care",
                "country": null
            },
            {
                "facebook_page_id": "682288964969542",
                "name": "Nike Product Testers",
                "avatar_url": "https://scontent.ftpe4-2.fna.fbcdn.net/v/t39.30808-1/511193282_10160755385761783_9018986867387327551_n.jpg?stp=dst-jpg_p100x100_tt6&_nc_cat=104&ccb=1-7&_nc_sid=418b77&_nc_ohc=cQN--Bb2ZvwQ7kNvwGzUvyA&_nc_oc=AdlHqPgcpfgA9-bc9vxqLGAv7WoPxbco77wi4gRJF28nlMqwUn0cvySBnubztBePwgw&_nc_zt=24&_nc_ht=scontent.ftpe4-2.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfcxfL39G5I00w6ieL5JUN4oyblWZXbrj0sdBi1B7PJrEQ&oe=68FFAE17",
                "category": "Apparel & Clothing",
                "country": null
            },
            {
                "facebook_page_id": "276907439024459",
                "name": "Nike Japan (ナイキ)",
                "avatar_url": "https://scontent.ftpe4-1.fna.fbcdn.net/v/t39.30808-1/351525976_226734210145102_5521153730850946611_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=108&ccb=1-7&_nc_sid=418b77&_nc_ohc=IS2bMJlDafQQ7kNvwFulmCC&_nc_oc=Adn3CujDnAdzx7frpWfs1sM52fLjFwhSgwpwjx2CW7BYgdk_k_LKfOZ8NceaFoFiAck&_nc_zt=24&_nc_ht=scontent.ftpe4-1.fna&_nc_gid=cFO-xZglZPsr-meLEgn2Tg&oh=00_AfeDcnOhSk3ADIXAjSD43x0AwEgEWDzOIjpl7tr61vk1mg&oe=68FFBF6D",
                "category": "Retail Company",
                "country": null
            }
        ]
    },
    "credits": {
        "remaining_credits": 745,
        "consumed_credits": 0,
        "total_credits": 745
    }
}
Example data from the existing documentation

Response structure

Name Type Required Constraints Display Name Description
» code integer true none Business status code
» message string true none Response Message none
» data object true none Response Data none
»» data [object] true none none
»»» facebook_page_id string true none Facebook Advertiser ID none
»»» name string true none Advertiser Name none
»»» avatar_url string true none Advertiser Avatar none
»»» category string¦null true none Category none
»»» country string¦null true none Country none
» credits object true none Credits information Credits information for the current API request
»» remaining_credits integer true none Remaining credits Remaining credits after this request
»» consumed_credits integer true none Consumed credits Credits consumed by this request
»» total_credits integer true none Total credits Total credits of the current credits type
Original API information and base URL

Base URLs

  • Production Environment: https://api.ppspy.com

API Information

  • API Name: Search Advertisers
  • Request Method: POST
  • API URL: /open-api/v1/ad-monitor-task/search-fb-ads-advertiser
  • Usage Note: Free
GETCurrent Credits/open-api/v1/creditsGETShopify Store List/open-api/v1/shopGETShopify Store Details/open-api/v1/shop/{id}GETStore Traffic List/open-api/v1/shop/traffic-shopGETSingle Product Store List/open-api/v1/shop/single-product-shopGETShopify Theme Store List/open-api/v1/shop/theme-shopGETShopify Product List/open-api/v1/productGETShopify Bestselling Products List/open-api/v1/bestsellersPOSTAdvertisement List/open-api/v1/advertisements/searchGETAdvertisement Details/open-api/v1/advertisements/{id}POSTAd Store List/open-api/v1/ad-stores/searchGETAd Store Details/open-api/v1/ad-stores/{id}GETAd Store Landing Page Stats/open-api/v1/ad-stores/landing-pages-ad-countGETAd Store Advertising Trends/open-api/v1/ad-stores/analysisGETAd Store Placement Analysis/open-api/v1/ad-stores/deep-analysisGETStore Ad Content Most Used/open-api/v1/ad-stores/ad-contentGETStore Ad Content Longest Run/open-api/v1/ad-stores/ad-content-longest-runGETAdvertisers for Ad Store/open-api/v1/ad-stores/advertisersPOSTAd Product List/open-api/v1/ad-products/searchGETAd Product Details/open-api/v1/ad-products/{id}POSTCreate Group/open-api/v1/ad-monitor-groupsGETGroup List/open-api/v1/ad-monitor-groupsPUTEdit Group/open-api/v1/ad-monitor-groups/{id}DELETEDelete Group/open-api/v1/ad-monitor-groups/{id}POSTSearch Advertisers/open-api/v1/ad-monitor-task/search-fb-ads-advertiser
Search the existing endpoint names and paths