Monsta SEO Requester

Send Meta Regeneration Request

API Settings

Site URL Requester Key

Request Form

Choose Product Title Description Keyword to Use Coverage Area

Select Action Forward suggestion to RECEIVER Save suggestion to targeted product

API Documentation

API Settings

{api_url}: wp-json/monsta-aiseo/v1/
{api_key}:

1. Get all available products - Retrieves a list of WooCommerce products.


    
        
            Detail
            Value
            Required
        
    
    
        
            Method
            GET
            Yes
        
        
            Endpoint URL
            {api_url}/wp-json/monsta-aiseo/v1/products
            Yes
        
        
            Authorization
            Bearer {api_key}
            Yes
        
        
            Content-Type
            application/json
            Yes
        
        
            Request Example
            
curl -X GET '{api_url}/wp-json/monsta-aiseo/v1/products' \
-H 'Authorization: Bearer {api_key}' \
-H 'Content-Type: application/json'
            
            No
        
        
            Success Response
            
[
    {
        "id": 123,
        "name": "Product Name 1",
        "sku": "SKU123",
        "description": "This is a description of product 1."
    }
    // More products...
]
            
            No
        
        
            Error Response
            
{
    "code": "unauthorized",
    "message": "Unauthorized request.",
    "data": {
        "status": 401
    }
}
            
            No

Detail	Value	Required
Method	GET	Yes
Endpoint URL	{api_url}/wp-json/monsta-aiseo/v1/products	Yes
Authorization	Bearer {api_key}	Yes
Content-Type	application/json	Yes
Request Example	curl -X GET '{api_url}/wp-json/monsta-aiseo/v1/products' \ -H 'Authorization: Bearer {api_key}' \ -H 'Content-Type: application/json'	No
Success Response	[ { "id": 123, "name": "Product Name 1", "sku": "SKU123", "description": "This is a description of product 1." } // More products... ]	No
Error Response	{ "code": "unauthorized", "message": "Unauthorized request.", "data": { "status": 401 } }	No

2. Regenerate Meta - Generates SEO metadata for a product.


    
        
            Detail
            Value
            Required
        
    
    
        
            Method
            POST
            Yes
        
        
            Endpoint URL
            {api_url}/wp-json/monsta-aiseo/v1/regenerate
            Yes
        
        
            Authorization
            Bearer {api_key}
            Yes
        
        
            Content-Type
            application/json
            Yes
        
        
            Request Body
(JSON)
            
{
    "product_id": 123,
    "meta_titles": "Product Title",
    "meta_descriptions": "Product Description",
    "shop_name": "Shop Name",
    "shop_address": "Shops full address",
    "use_keyword": "unique",
    "coverage_radius": 35,
    "sizes": "",
    "is_medal": true,
    "product_grouping_options": "Medals",
    "request_action": "forward"
}
            
            Yes
        
        
            Request Example
            
curl -X POST '{api_url}/wp-json/monsta-aiseo/v1/regenerate' \
-H 'Authorization: Bearer {api_key}' \
-H 'Content-Type: application/json' \
-d '{
    "product_id": 123,
    "meta_titles": "Product Title",
    "meta_descriptions": "Product Description",
    "shop_name": "Shop Name",
    "shop_address": "Shops full address",
    "use_keyword": "unique",
    "coverage_radius": 35,
    "sizes": "",
    "is_medal": true,
    "product_grouping_options": "Medals",
    "request_action": "forward"
}'
            
            No
        
        
            Success Response
            
{
    "meta_title": "Generated SEO Title",
    "meta_description": "Generated SEO Description",
    "friendly_title": "Friendly Title",
    "friendly_description": "Friendly Description",
    "schema_markup": {
        "@context": "https://schema.org",
        "@type": "Product",
        "name": "Product Title",
        "description": "Product Description",
        "sku": "SKU123",
        "address": {
            "@type": "PostalAddress",
            "streetAddress": "Street Address",
            "addressCity": "City",
            "addressRegion": "State",
            "postalCode": "Postal Code",
        }
    }
}
            
            No
        
        
            Error Response
            
{
    "code": "bad_request",
    "message": "Invalid parameters provided.",
    "data": {
        "status": 400
    }
}
            
            No

Detail	Value	Required
Method	POST	Yes
Endpoint URL	{api_url}/wp-json/monsta-aiseo/v1/regenerate	Yes
Authorization	Bearer {api_key}	Yes
Content-Type	application/json	Yes
Request Body (JSON)	{ "product_id": 123, "meta_titles": "Product Title", "meta_descriptions": "Product Description", "shop_name": "Shop Name", "shop_address": "Shops full address", "use_keyword": "unique", "coverage_radius": 35, "sizes": "", "is_medal": true, "product_grouping_options": "Medals", "request_action": "forward" }	Yes
Request Example	curl -X POST '{api_url}/wp-json/monsta-aiseo/v1/regenerate' \ -H 'Authorization: Bearer {api_key}' \ -H 'Content-Type: application/json' \ -d '{ "product_id": 123, "meta_titles": "Product Title", "meta_descriptions": "Product Description", "shop_name": "Shop Name", "shop_address": "Shops full address", "use_keyword": "unique", "coverage_radius": 35, "sizes": "", "is_medal": true, "product_grouping_options": "Medals", "request_action": "forward" }'	No
Success Response	{ "meta_title": "Generated SEO Title", "meta_description": "Generated SEO Description", "friendly_title": "Friendly Title", "friendly_description": "Friendly Description", "schema_markup": { "@context": "https://schema.org", "@type": "Product", "name": "Product Title", "description": "Product Description", "sku": "SKU123", "address": { "@type": "PostalAddress", "streetAddress": "Street Address", "addressCity": "City", "addressRegion": "State", "postalCode": "Postal Code", } } }	No
Error Response	{ "code": "bad_request", "message": "Invalid parameters provided.", "data": { "status": 400 } }	No

3. Regenerate Meta via product URL - Generates SEO metadata for a product.


    
        
            Detail
            Value
            Required
        
    
    
        
            Method
            POST
            Yes
        
        
            Endpoint URL
            {api_url}/wp-json/monsta-aiseo/v1/regenerate-via-url
            Yes
        
        
            Authorization
            Bearer {api_key}
            Yes
        
        
            Content-Type
            application/json
            Yes
        
        
            Request Body
(JSON)
            
{
    "products": [
        {
            "url": "{api_url}/product/supreme-medal-values-50mm-insert/",
            "use_keyword": "high-end",
            "is_medal": true,
            "sizes": "",
            "product_groupings_options": "Medals"
        },
        {
            "url": "{api_url}/product/arizona-football/",
            "use_keyword": "affordable",
            "is_medal": false,
            "sizes": "",
            "product_groupings_options": "Trophies"
        },
        {
            "url": "{api_url}/product/sunrise-football/",
            "use_keyword": "limited",
            "is_medal": false,
            "sizes": "120mm, 140mm, 155mm",
            "product_groupings_options": "Trophies"
        }
    ],
    "shop_name": "Trophy Specialists",
    "shop_address": "19 Colray Ave, Osborne Park WA 6017",
    "coverage_radius": "55",
    "request_action": "forward"
}
            
            Yes
        
        
            Request Example
            
curl -X POST '{api_url}/wp-json/monsta-aiseo/v1/regenerate-via-url' \
-H 'Authorization: Bearer {api_key}' \
-H 'Content-Type: application/json' \
-d '{
    "products": [
        {
            "url": "{api_url}/product/supreme-medal-values-50mm-insert/",
            "use_keyword": "high-end",
            "is_medal": true,
            "sizes": "",
            "product_groupings_options": "Medals"
        },
        {
            "url": "{api_url}/product/arizona-football/",
            "use_keyword": "affordable",
            "is_medal": false,
            "sizes": "",
            "product_groupings_options": "Trophies"
        },
        {
            "url": "{api_url}/product/sunrise-football/",
            "use_keyword": "limited",
            "is_medal": false,
            "sizes": "120mm, 140mm, 155mm",
            "product_groupings_options": "Trophies"
        }
    ],
    "shop_name": "Trophy Specialists",
    "shop_address": "19 Colray Ave, Osborne Park WA 6017",
    "coverage_radius": "55",
    "request_action": "forward"
}'
            
            No
        
        
            Success Response
            
[
	{
		"product_url": "https:\/\/ai-plugin.dev.monstamgt.com\/product\/supreme-medal-values-50mm-insert\/",
		"meta_title": "High-End Vintage Supreme Medal Values-50mm Insert in Osborne Park",
		"meta_description": "Discover the vintage Supreme Medal Values-50mm insert in Gold, Silver, and Bronze variants at Trophy Specialists in Osborne Park. Representing core values in sport, career, and life.",
		"friendly_title": "Explore the High-End Vintage Supreme Medal Values-50mm Insert at Trophy Specialists in Osborne Park",
		"friendly_description": "Step into the world of vintage elegance with our Supreme Medal Values-50mm insert. Available in Gold, Silver, and Bronze variants, this piece beautifully represents the core values in sport, career, and life. Visit Trophy Specialists in Osborne Park to find this timeless treasure."
	},
	{
		"product_url": "https:\/\/ai-plugin.dev.monstamgt.com\/product\/arizona-football\/",
		"meta_title": "Affordable Arizona - Football: Vintage Antique Gold Excellence Award",
		"meta_description": "Discover the vintage charm of the Arizona - Football award in antique gold. Explore our range of affordable variants and sizes from 150mm to 200mm. Visit Trophy Specialists at 19 Colray Ave, Osborne Park WA 6017.",
		"friendly_title": "Explore the Affordable Arizona - Football Vintage Antique Gold Excellence Award",
		"friendly_description": "Experience the vintage charm of the Arizona - Football award in antique gold. Recognize excellence with our range of affordable variants and sizes from 150mm to 200mm. Visit Trophy Specialists at 19 Colray Avenue, Osborne Park, WA 6017."
	},
	{
		"product_url": "https:\/\/ai-plugin.dev.monstamgt.com\/product\/sunrise-football\/",
		"meta_title": "Limited Vintage Sunrise-Football Participation Award in Osborne Park",
		"meta_description": "Discover the limited Vintage Sunrise-Football participation award from Trophy Specialists in Osborne Park. Available in variants 1003-9a, 1003-9b, and 1003-9c. Visit us today!",
		"friendly_title": "Find the Limited Vintage Sunrise-Football Participation Award in Osborne Park",
		"friendly_description": "Looking for a unique participation award? Check out the limited Vintage Sunrise-Football at Trophy Specialists in Osborne Park. Available in variants 1003-9a, 1003-9b, and 1003-9c with sizes from 120mm to 155mm. Visit us today!"
	}
]
            
            No
        
        
            Error Response
            
{
    "code": "bad_request",
    "message": "Invalid or empty URLs parameter.",
    "data": {
        "status": 400
    }
}
            
            No
        
        
            Product not found
            
{
    "success": true,
    "data": [
        {
            "product_url": "{api_url}/product/dummy-product",
            "error": "Product not found or invalid URL."
        }
    ]
}
            
            No