{
  "service": "storecensus",
  "displayName": "StoreCensus",
  "categories": [
    "Data",
    "Marketing"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "your.api.key",
      "description": "StoreCensus API key sent with the Authorization Bearer header. Generate it from the API page of your StoreCensus account after signing in.",
      "extraFields": []
    }
  ],
  "homepageUrl": "https://www.storecensus.com",
  "actions": [
    {
      "id": "storecensus.get_website",
      "service": "storecensus",
      "name": "get_website",
      "description": "Retrieve StoreCensus ecommerce intelligence for a website domain or lead ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "minLength": 1,
            "description": "The domain name or numeric StoreCensus lead ID to retrieve, such as example-store.com or 12345.",
            "pattern": "\\S"
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "basic_info",
                "contact_info",
                "location_info",
                "social_media",
                "ecommerce_info",
                "financial_info",
                "traffic_analytics",
                "technical_info",
                "apps_integrations",
                "activity_signals",
                "crm",
                "data_metadata"
              ],
              "description": "A StoreCensus response section to include."
            },
            "description": "StoreCensus response sections to include. Omit this field to request all sections."
          }
        },
        "additionalProperties": false,
        "required": [
          "domain"
        ],
        "description": "The input payload for retrieving one StoreCensus website."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "website": {
            "type": "object",
            "properties": {
              "basic_info": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Basic website and company information."
              },
              "contact_info": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Store contact information."
              },
              "location_info": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Store location information."
              },
              "social_media": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Store social media profile information."
              },
              "ecommerce_info": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Ecommerce platform and catalog information."
              },
              "financial_info": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Estimated revenue and technology spend information."
              },
              "traffic_analytics": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Estimated traffic and audience analytics."
              },
              "technical_info": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Detected technology information."
              },
              "apps_integrations": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Detected Shopify app integration information."
              },
              "activity_signals": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Recent activity and growth signals."
              },
              "crm": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "StoreCensus CRM fields for the store."
              },
              "data_metadata": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "StoreCensus data metadata for the store."
              }
            },
            "additionalProperties": true,
            "description": "A StoreCensus ecommerce store record."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when retrieving one StoreCensus website."
      }
    },
    {
      "id": "storecensus.list_app_categories",
      "service": "storecensus",
      "name": "list_app_categories",
      "description": "List StoreCensus Shopify app categories that have active apps.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "The input payload for listing StoreCensus app categories."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "category_id": {
                  "type": "integer",
                  "description": "The StoreCensus category identifier."
                },
                "name": {
                  "type": "string",
                  "description": "The category name."
                },
                "slug": {
                  "type": "string",
                  "description": "The URL-friendly category slug."
                },
                "app_count": {
                  "type": "integer",
                  "description": "The number of active apps in this category."
                }
              },
              "additionalProperties": true,
              "description": "A StoreCensus Shopify app category."
            },
            "description": "The app categories returned by StoreCensus."
          },
          "total": {
            "type": "integer",
            "description": "The total number of categories returned by StoreCensus."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when listing StoreCensus app categories."
      }
    },
    {
      "id": "storecensus.list_apps",
      "service": "storecensus",
      "name": "list_apps",
      "description": "List or search StoreCensus Shopify apps with page pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The one-indexed page number to return."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "description": "The number of apps to return. StoreCensus caps this at 500."
          },
          "app_id": {
            "type": "integer",
            "minimum": 1,
            "description": "The specific StoreCensus app ID to retrieve."
          },
          "minRating": {
            "type": "number",
            "minimum": 0,
            "maximum": 5,
            "description": "The minimum app rating to return."
          },
          "search": {
            "type": "string",
            "minLength": 1,
            "description": "A text search applied to app name, description, or developer.",
            "pattern": "\\S"
          },
          "categoryId": {
            "type": "integer",
            "minimum": 1,
            "description": "The StoreCensus app category ID to filter by."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for listing StoreCensus Shopify apps."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "apps": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A StoreCensus Shopify app record."
            },
            "description": "The apps returned by StoreCensus."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The one-indexed page number returned by StoreCensus."
              },
              "pageSize": {
                "type": "integer",
                "description": "The page size returned by StoreCensus."
              },
              "hasMore": {
                "type": "boolean",
                "description": "Whether StoreCensus has more results after this page."
              },
              "nextCursor": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The cursor for the next result page."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total": {
                "type": "integer",
                "description": "The total number of matching records when StoreCensus returns it."
              },
              "returned": {
                "type": "integer",
                "description": "The number of records returned in this response."
              },
              "totalPages": {
                "type": "integer",
                "description": "The total number of pages when StoreCensus returns it."
              }
            },
            "additionalProperties": true,
            "description": "StoreCensus pagination metadata."
          },
          "filters": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The app filters applied by StoreCensus."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when listing StoreCensus Shopify apps."
      }
    },
    {
      "id": "storecensus.search_stores",
      "service": "storecensus",
      "name": "search_stores",
      "description": "Search StoreCensus ecommerce stores with filters and cursor pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "filters": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "StoreCensus store filters, such as country, vertical, apps, estimatedVisits, or CRM filters."
          },
          "sort": {
            "type": "object",
            "properties": {
              "column": {
                "type": "string",
                "minLength": 1,
                "description": "The StoreCensus column to sort by.",
                "pattern": "\\S"
              },
              "direction": {
                "type": "string",
                "enum": [
                  "asc",
                  "desc"
                ],
                "description": "The sort direction."
              }
            },
            "additionalProperties": false,
            "required": [
              "column"
            ],
            "description": "The StoreCensus sort configuration."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "description": "The number of stores to return. StoreCensus allows 50 to 500."
          },
          "cursor": {
            "type": "string",
            "minLength": 1,
            "description": "The StoreCensus cursor returned by the previous page.",
            "pattern": "\\S"
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "basic_info",
                "contact_info",
                "location_info",
                "social_media",
                "ecommerce_info",
                "financial_info",
                "traffic_analytics",
                "technical_info",
                "apps_integrations",
                "activity_signals",
                "crm",
                "data_metadata"
              ],
              "description": "A StoreCensus response section to include."
            },
            "description": "StoreCensus response sections to include. Omit this field to request all sections."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for searching StoreCensus stores."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "stores": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "basic_info": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Basic website and company information."
                },
                "contact_info": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Store contact information."
                },
                "location_info": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Store location information."
                },
                "social_media": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Store social media profile information."
                },
                "ecommerce_info": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Ecommerce platform and catalog information."
                },
                "financial_info": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Estimated revenue and technology spend information."
                },
                "traffic_analytics": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Estimated traffic and audience analytics."
                },
                "technical_info": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Detected technology information."
                },
                "apps_integrations": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Detected Shopify app integration information."
                },
                "activity_signals": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Recent activity and growth signals."
                },
                "crm": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "StoreCensus CRM fields for the store."
                },
                "data_metadata": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "StoreCensus data metadata for the store."
                }
              },
              "additionalProperties": true,
              "description": "A StoreCensus ecommerce store record."
            },
            "description": "The stores returned by StoreCensus."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The one-indexed page number returned by StoreCensus."
              },
              "pageSize": {
                "type": "integer",
                "description": "The page size returned by StoreCensus."
              },
              "hasMore": {
                "type": "boolean",
                "description": "Whether StoreCensus has more results after this page."
              },
              "nextCursor": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The cursor for the next result page."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total": {
                "type": "integer",
                "description": "The total number of matching records when StoreCensus returns it."
              },
              "returned": {
                "type": "integer",
                "description": "The number of records returned in this response."
              },
              "totalPages": {
                "type": "integer",
                "description": "The total number of pages when StoreCensus returns it."
              }
            },
            "additionalProperties": true,
            "description": "StoreCensus pagination metadata."
          },
          "filters": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The filters applied by StoreCensus."
          },
          "sort": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The sort applied by StoreCensus."
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "basic_info",
                "contact_info",
                "location_info",
                "social_media",
                "ecommerce_info",
                "financial_info",
                "traffic_analytics",
                "technical_info",
                "apps_integrations",
                "activity_signals",
                "crm",
                "data_metadata"
              ],
              "description": "A StoreCensus response section to include."
            },
            "description": "The StoreCensus sections included in the response."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when searching StoreCensus stores."
      }
    }
  ]
}