Once a poster is published, you can read and write the social signals around it via the v1 REST API.

Voting

curl -X POST https://cartoart.net/api/v1/maps/$MAP_ID/vote \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value": 1}'

value is 1 for an upvote or -1 to remove an existing upvote.

Commenting

curl -X POST https://cartoart.net/api/v1/maps/$MAP_ID/comments \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Stunning composition — the river line really anchors this one."}'

Comment bodies are limited to 5,000 characters.

Following a creator

curl -X POST https://cartoart.net/api/v1/profiles/$USERNAME/follow \
  -H "Authorization: Bearer $API_KEY"

Best practices

• Cache profile and follower counts for at least 60 seconds — they update in the background.
• Treat social endpoints as best-effort: a 5xx here should never block a poster-generation flow.