Overview Tags help you organize and categorize your queries within a project. Use tags to group related queries, filter results, and create meaningful segments for analysis.
Tag Properties Property Type Description idnumber Unique identifier namestring Display name of the tag colorstring Hex color code for visual identification projectstring (UUID) Parent project ID
curl -X POST "https://api.mentionlab.io/api/tags" \ -H "x-api-key: ml_live_abc123xyz789..." \ -H "x-organisation-id: YOUR_ORG_ID" \ -H "x-project-id: YOUR_PROJECT_ID" \ -H "Content-Type: application/json" \ -d '{ "name": "Competitors", "color": "#EF4444" }'
{ "id" : 1 , "project" : "01234567-89ab-cdef-0123-456789abcdef" , "name" : "Competitors" , "color" : "#EF4444" } Link a Tag curl -X POST "https://api.mentionlab.io/api/tags/1/link" \ -H "x-api-key: ml_live_abc123xyz789..." \ -H "x-organisation-id: YOUR_ORG_ID" \ -H "x-project-id: YOUR_PROJECT_ID" \ -H "Content-Type: application/json" \ -d '{ "queryId": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6" }'
Unlink a Tag curl -X POST "https://api.mentionlab.io/api/tags/1/unlink" \ -H "x-api-key: ml_live_abc123xyz789..." \ -H "x-organisation-id: YOUR_ORG_ID" \ -H "x-project-id: YOUR_PROJECT_ID" \ -H "Content-Type: application/json" \ -d '{ "queryId": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6" }' curl -X POST "https://api.mentionlab.io/api/tags/list?limit=50&page=1" \ -H "x-api-key: ml_live_abc123xyz789..." \ -H "x-organisation-id: YOUR_ORG_ID" \ -H "x-project-id: YOUR_PROJECT_ID" \ -H "Content-Type: application/json" Tag Organization Strategies
Group queries by subject matter:
Features - Queries about specific featuresPricing - Queries about costs and plansComparison - Queries comparing productsHow-to - Instructional queries
Organize by customer journey:
Awareness - General category queriesConsideration - Comparison and evaluation queriesDecision - Specific product queriesRetention - Usage and support queries
Track competitor mentions:
Competitor A Competitor B Competitor C
Geographic segmentation:
North America Europe Asia Pacific curl -X PATCH "https://api.mentionlab.io/api/tags/1" \ -H "x-api-key: ml_live_abc123xyz789..." \ -H "x-organisation-id: YOUR_ORG_ID" \ -H "x-project-id: YOUR_PROJECT_ID" \ -H "Content-Type: application/json" \ -d '{ "name": "Updated Tag Name", "color": "#6366F1" }' Deleting a tag will remove it from all associated queries. This action cannot be undone.
curl -X DELETE "https://api.mentionlab.io/api/tags/1" \ -H "x-api-key: ml_live_abc123xyz789..." \ -H "x-organisation-id: YOUR_ORG_ID" \ -H "x-project-id: YOUR_PROJECT_ID" Next Steps 
