{"openapi":"3.1.0","info":{"title":"smm.guide catalog API","version":"1.0.0","description":"Read-only access to the smm.guide catalog: SMM panels with their Trust Score, ratings, live prices, order counters and market pages. One free key per account (sign in → Account → Security → API access). Limits: 60 requests a minute, 5000 a day. Quote figures with a link to the listing they come from.","termsOfService":"https://smm.guide/terms/","contact":{"name":"smm.guide","url":"https://smm.guide/about/"}},"servers":[{"url":"https://smm.guide/api/v1"}],"security":[{"bearerAuth":[]}],"paths":{"/panels":{"get":{"operationId":"listPanels","summary":"Search and filter panels","parameters":[{"name":"q","in":"query","description":"Name or domain contains","schema":{"type":"string","maxLength":80}},{"name":"market","in":"query","description":"A market key from /markets (india, turkey, api …)","schema":{"type":"string"}},{"name":"platform","in":"query","description":"A network key from /platforms (instagram, tiktok …): panels with a public price list for it","schema":{"type":"string"}},{"name":"engine","in":"query","schema":{"type":"string","enum":["perfect-panel","socpanel","other"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["online","offline","all"],"default":"online"}},{"name":"verified","in":"query","description":"Only panels whose owner verified the listing","schema":{"type":"boolean"}},{"name":"api","in":"query","description":"Only panels that answer the v2 reseller API","schema":{"type":"boolean"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["rank","trust","rating","orders","age","price"],"default":"rank"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"A page of panels","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanelList"}}}},"401":{"description":"No key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Bad parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/panels/{panel}":{"get":{"operationId":"getPanel","summary":"One panel with every measured figure","parameters":[{"name":"panel","in":"path","required":true,"description":"Slug (prm4u-com) or domain (prm4u.com)","schema":{"type":"string"}}],"responses":{"200":{"description":"The panel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanelDetail"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/panels/{panel}/services":{"get":{"operationId":"listServices","summary":"The public price list of a panel","parameters":[{"name":"panel","in":"path","required":true,"schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}},{"name":"kind","in":"query","description":"followers, likes, views, comments, subscribers …","schema":{"type":"string"}},{"name":"q","in":"query","description":"Service name contains","schema":{"type":"string","maxLength":80}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of services, cheapest platform first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceList"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/markets":{"get":{"operationId":"listMarkets","summary":"Country and language markets, and the API market, with counts","responses":{"200":{"description":"Markets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketList"}}}}}}},"/platforms":{"get":{"operationId":"listPlatforms","summary":"Networks with a public price list somewhere in the catalog","responses":{"200":{"description":"Platforms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformList"}}}}}}},"/stats":{"get":{"operationId":"catalogStats","summary":"Catalog totals","responses":{"200":{"description":"Totals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer sg_… (also accepted: X-Api-Key header or api_key query parameter)"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"PanelSummary":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"website":{"type":"string"},"url":{"type":"string","format":"uri"},"online":{"type":"boolean"},"trust_score":{"type":"integer","description":"0–100, the open formula at /trust-score/"},"trust_band":{"type":"string"},"rating":{"type":["number","null"],"description":"Stars 1–5 from the review platforms we read"},"reviews":{"type":"integer"},"services":{"type":"integer"},"price_from_usd_per_1k":{"type":["number","null"]},"orders":{"type":["integer","null"],"description":"The public completed-orders counter"},"since":{"type":["integer","null"]},"engine":{"type":["string","null"]},"owner_verified":{"type":"boolean"},"mark":{"type":["string","null"],"enum":["trustpanel","verified",null]},"api":{"type":"boolean"},"updated_at":{"type":"string","format":"date"}}},"PanelDetail":{"allOf":[{"$ref":"#/components/schemas/PanelSummary"},{"type":"object","properties":{"trust":{"type":"object","properties":{"score":{"type":"integer"},"band":{"type":"string"},"parts":{"type":"array","items":{"type":"object"}}}},"rating_detail":{"type":"object"},"domain":{"type":"object"},"language":{"type":["string","null"]},"price_list":{"type":"object"},"orders_detail":{"type":"object"},"status":{"type":"object"},"links":{"type":"object"}}}]},"PanelList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PanelSummary"}},"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"}}},"Service":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"platform":{"type":"string"},"kind":{"type":"string"},"rate_usd_per_1k":{"type":["number","null"]},"min":{"type":"integer"},"max":{"type":"integer"},"ad":{"type":"boolean"},"note":{"type":"string"}}},"ServiceList":{"type":"object","properties":{"panel":{"type":"object"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"}}},"MarketList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"panels_online":{"type":"integer"},"rule":{"type":"string"},"url":{"type":"string"}}}}}},"PlatformList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"panels":{"type":"integer"},"from_usd_per_1k":{"type":["number","null"]},"url":{"type":"string"}}}}}},"Stats":{"type":"object","properties":{"panels":{"type":"integer"},"online":{"type":"integer"},"verified_owners":{"type":"integer"},"with_api":{"type":"integer"},"tools":{"type":"integer"},"services":{"type":"integer"},"reviews_read":{"type":"integer"},"review_platforms":{"type":"array","items":{"type":"string"}},"markets":{"type":"integer"},"as_of":{"type":"string","format":"date-time"}}}}}}