1ThreadsDocs
API key
API reference
Get started

Introduction

Automate 1Threads: queue, publish and analyse Threads posts from your own code.

The 1Threads API is plain HTTPS and JSON. Every path in this reference is relative to this deployment's base URL:

https://smanager.mrfirdavs.uz/api/v1
Schedule posts

Queue drafts and scheduled posts, or publish right away.

Upload media

Attach images and videos, uploaded or imported from a URL.

Read insights

Views, likes, followers and per-post metrics.

Recipes

Complete scripts for common automations.

Quickstart

  1. 1

    Create an API key

    Open Settings → API keys, create a key and keep it somewhere safe, like an environment variable.

    export ONETHREADS_KEY="smk_…"
  2. 2

    Make your first request

    curl https://smanager.mrfirdavs.uz/api/v1/accounts \
  -H "Authorization: Bearer $ONETHREADS_KEY"
  3. 3

    Schedule a post

    curl https://smanager.mrfirdavs.uz/api/v1/posts \
  -H "Authorization: Bearer $ONETHREADS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Hello from the API 👋", "scheduledAt": "2026-11-02T09:00:00Z" }'

Conventions

  • Request bodies are JSON with Content-Type: application/json, except file uploads.
  • Times are ISO 8601 strings. Responses use UTC; requests may use any time zone offset.
  • Lists come back as { "data": [...] }; single objects come back as they are.