Product Information Issue Diagnosis

Diagnose multiple existing live (status: ACTIVATE) products to obtain information that helps you to improve the product content, enhancing product visibility and customer trust. The returned information includes:

• Listing quality information (available only for the US market).
• Issues with the current product details and the overall recommendations
• Auto-generated optimization suggestions targeted for specific product fields, including the title, description, and image. Note: This API focuses solely on optimizing product visibility and does not evaluate whether your product meets listing requirements. Quality issues identified by this API do not block your product from being listed. To verify listing requirements, use the Check Product Listing API.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Note:

• Max number of IDs: 200
• The product must be live (status: ACTIVATE) |

Query

https://open-api.tiktokglobalshop.com/product/202405/products/diagnoses?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&product_ids=12345678,123456

Possible values:

• POOR
• FAIR
• GOOD

Note: Available only for the US market. | ^^^remaining_recommendations |int |3 |The remaining number of recommendations (see diagnosis_results) that must be implemented for the product to reach the highest tier. Note:

• To reach the highest tier, you must implement all recommendations listed in diagnosis_results.
• Available only for the US market. | ^^diagnoses |[]object | |Product diagnosis and optimization information. | ^^^field |string |TITLE |The product field being diagnosed. Possible values:
• TITLE: Product title
• DESCRIPTION: Product description
• IMAGE: Product image (main_images in the product entity)
• ATTRIBUTE: Product attribute
• SIZE_CHART: Product size chart | ^^^diagnosis_results |[]object | |The results of diagnosing the specified field. | ^^^^code |string |TITLE_LESS_THAN_40_CHARACTERS |A machine-readable code that represents an identified issue. Refer to Listing quality diagnosis for the full list of diagnosed issues and the corresponding recommendations. | ^^^^how_to_solve |string |Names must be at least 40 characters long and contain product-identifying information, such as "hiking boots" or "lipstick". |The recommendation for resolving the identified issue, returned in the default locale language of the shop. Refer to Listing quality diagnosis for the full list of recommendations. | ^^^^quality_tier |string |GOOD |The listing quality tier you can reach by implementing the recommendation. Possible values:
• FAIR
• GOOD

Note:

• To reach a higher tier, you must implement all recommendations from the destination tier and all preceding tiers. For example, a product will reach the "GOOD" tier once all "FAIR" and "GOOD" recommendations are addressed or implemented.
• Available only for the US market. | ^^^suggestion |object | |Optimization suggestions that are auto-generated by the system to improve the effectiveness of the specified field. | ^^^^seo_words |[]object | |The SEO keyword suggestions for product titles. | ^^^^^text |string |dress |The suggested SEO keyword. | ^^^^smart_texts |[]object | |The list of optimized product title or description. | ^^^^^text |string |this is a good title |The optimized text. | ^^^^images |[]object | |The optimized image. Only the first image in the main_images set will be optimized. | ^^^^^height |int |600 |The image height after optimization. | ^^^^^width |int |600 |The image width after optimization. | ^^^^^uri |string |tos-maliva-i-o3syd03w52-us/53b55d6e8cdf1f315affa7e70b45707d |The original URI of the image. | ^^^^^url |string |https://p16-graph-va.ibyteimg.com/tos-maliva-i-1por3rr4fy-us/v2/53b55d6e8cdf1f315affa7e70b45707d~tplv-1por3rr4fy-image.webp |The original URL of the image. | ^^^^^optimized_uri |string |tos-maliva-i-o3syd03w52-us/0266127022264e54ad2f639f5e0fb5e6 |The URI of the image after optimization. | ^^^^^optimized_url |string |https://p16-graph-va.ibyteimg.com/tos-maliva-i-1por3rr4fy-us/v2/0266127022264e54ad2f639f5e0fb5e6~tplv-1por3rr4fy-image.webp |The URL of the image after optimization. |

{"code":0,"data":{"products":[{"id":"123456","listing_quality":{"current_tier":"POOR","remaining_recommendations":3},"diagnoses":[{"field":"TITLE","diagnosis_results":[{"code":"TITLE_LESS_THAN_40_CHARACTERS","how_to_solve":"Names must be at least 40 characters long and contain product-identifying information, such as \"hiking boots\" or \"lipstick\".","quality_tier":"GOOD"}],"suggestion":{"seo_words":[{"text":"dress"}],"smart_texts":[{"text":"this is a good title"}],"images":[{"height":600,"width":600,"uri":"tos-maliva-i-o3syd03w52-us/53b55d6e8cdf1f315affa7e70b45707d","url":"https://p16-graph-va.ibyteimg.com/tos-maliva-i-1por3rr4fy-us/v2/53b55d6e8cdf1f315affa7e70b45707d~tplv-1por3rr4fy-image.webp","optimized_uri":"tos-maliva-i-o3syd03w52-us/0266127022264e54ad2f639f5e0fb5e6","optimized_url":"https://p16-graph-va.ibyteimg.com/tos-maliva-i-1por3rr4fy-us/v2/0266127022264e54ad2f639f5e0fb5e6~tplv-1por3rr4fy-image.webp"}]}}]}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code