Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Objavljujte na Instagramu, TikToku i Facebooku iz Pythona jednim API-jem

Uz easyCoexistence, Python kod objavljuje na Instagramu, Facebooku, TikToku, YouTubeu i LinkedInu preko zvaničnog API-ja svake mreže. Svaki nalog se prijavi jednom preko hostovanog linka; vaša skripta zatim dobija svež token za TikTok, YouTube ili LinkedIn jednim GET zahtevom, dok pozivi za Instagram i Facebook idu preko easyCoexistence MCP alata, koji čuvaju token. MCP alati daju Python agentu iste naloge.

1,000 bytes

Najviše teksta koji jedan Instagram DM može da nosi preko API-ja, računato u UTF-8, pa emoji zauzimaju više mesta.

24 hours

Koliko traje pristupni token TikTok API for Business; njegov token za osvežavanje ostaje važeći godinu dana.

1 hour

Koliko traje Google korisnički pristupni token, onaj koji svaki poziv YouTube API-ja nosi.

OAuthClientProvider

OAuth rukovalac MCP Python SDK-a, koji registruje klijenta, vodi prijavu sa PKCE i osvežava tokene.

1 attempt

Prosleđeni događaji o komentarima, pominjanjima i DM-ovima isporučuju se jednom i nikada se ne čuvaju, pa svaki potvrdite odmah.

Kako Python dobija token za Instagram, Facebook, TikTok, YouTube ili LinkedIn?

Preko sesije povezivanja na easyCoexistence Partner API, autentifikovane vašim ec_live_ ključem. POST /connect-sessions sa channel postavljenim na instagram, facebook, tiktok, youtube ili linkedin vraća hostovani link za jednog korisnika, važeći jedan sat. Korisnik se prijavljuje preko sopstvene prijave mreže i vraća se na vaš redirect_url sa status=connected i channel_id, koji vaš backend potvrđuje pozivom GET /connect-sessions/{session}, umesto da veruje parametrima u upitu. Vašem kodu nikada nije potrebna sopstvena developer aplikacija kod Meta, TikTok, Google ili LinkedIn.

Zatim zatražite kredencijale na početku svakog posla. GET /channels/{id}?credentials=1 vraća osnovnu adresu API-ja mreže, ID naloga na toj mreži i, za TikTok, YouTube i LinkedIn, pristupni token koji easyCoexistence održava obnovljenim. TikTok token važi 24 sata, a Google token jedan sat, pa ga preuzimajte za svaki posao, umesto da ga čuvate. Instagram i Facebook tokeni se nikada ne izdaju; njihovi pozivi idu preko MCP alata.

Connect an account, then fetch its credentials per job
import os
import requests

EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...

# A hosted sign-in link for one customer on one network
session = requests.post(f"{EC}/connect-sessions", headers=KEY, json={
    "channel": "instagram",  # or facebook, tiktok, youtube, linkedin
    "redirect_url": "https://app.example.com/connected",
    "external_ref": "customer_4821",
}).json()
print(session["url"])  # they come back with ?session=...&status=connected&channel_id=...

def credentials(channel_id: str) -> dict:
    """The network's API base and a token that is valid now. Call it per job."""
    r = requests.get(f"{EC}/channels/{channel_id}", headers=KEY, params={"credentials": 1})
    r.raise_for_status()
    creds = r.json()["credentials"]
    if not creds.get("access_token"):
        raise RuntimeError(creds.get("note", "This channel is not connected."))
    return creds

Kako iz Pythona objavljujete na Instagramu i Facebooku?

Instagram objavljuje u dva koraka preko Meta Graph API-ja, a token se šalje kao bearer zaglavlje. POST /{ig-id}/media sa image_url i opisom pravi kontejner; kada GET njegovog status_code pokaže FINISHED, POST /{ig-id}/media_publish sa kontejnerom kao creation_id ga objavljuje na profilu. Meta preporučuje proveru otprilike jednom u minut, do pet minuta. Reel ide istim koracima, poslat sa media_type REELS i video_url umesto slike.

Objava na Facebook stranici je jedan poziv: POST /{page-id}/feed sa message i, ako želite, link. Dodavanje published false i scheduled_publish_time između 10 minuta i 30 dana unapred znači da Meta objavljuje u tom trenutku, bez da vaša skripta išta pokreće. Meta u oba slučaja preuzima medije sa javne URL adrese, a Instagram prihvata samo JPEG slike.

Publish a photo on Instagram and schedule a Page post
import time
import requests

def graph(c: dict, path: str, **body) -> dict:
    """Meta's Graph API: a POST when there is a body, a GET when there is none."""
    r = requests.request("POST" if body else "GET", f"{c['graph_api_base']}/{path}",
                         json=body or None, headers={"Authorization": f"Bearer {c['access_token']}"})
    r.raise_for_status()
    return r.json()

def post_to_instagram(channel_id: str, image_url: str, caption: str) -> str:
    c = credentials(channel_id)
    ig = c["account_id_on_meta"]
    container = graph(c, f"{ig}/media", image_url=image_url, caption=caption)["id"]
    for _ in range(5):  # Meta: check about once a minute, for up to five minutes
        status = graph(c, f"{container}?fields=status_code")["status_code"]
        if status == "FINISHED":
            return graph(c, f"{ig}/media_publish", creation_id=container)["id"]
        if status in ("ERROR", "EXPIRED"):
            raise RuntimeError(f"Instagram could not process the media: {status}")
        time.sleep(60)
    raise TimeoutError("The container is still processing")

def schedule_on_facebook(channel_id: str, message: str, publish_at: int) -> str:
    c = credentials(channel_id)
    post = graph(c, f"{c['account_id_on_meta']}/feed", message=message,
                 published=False, scheduled_publish_time=publish_at)  # unix seconds
    return post["id"]

Kako iz Pythona otpremate na YouTube i objavljujete na LinkedInu?

YouTube prima video kao nastavljivi upload (resumable). Prvi zahtev ide na endpoint za upload sa uploadType=resumable i part=snippet,status i nosi naslov i status kao JSON; zaglavlje Location u odgovoru je adresa sesije. PUT fajla na tu adresu vraća 201 sa novim videom. Postavljanje privacyStatus na private sa vremenom publishAt omogućava da YouTube sam objavi video u tom trenutku, a selfDeclaredMadeForKids beleži da li je video namenjen deci.

LinkedIn prima jedan POST na /rest/posts sa bearer tokenom, zaglavljem LinkedIn-Version i X-Restli-Protocol-Version 2.0.0. Telo navodi autora, nosi tekst kao commentary i postavlja visibility, distribution i lifecycleState. Kredencijali daju author_urn, odnosno urn:li:organization za stranicu kompanije ili urn:li:person za profil, i verziju koju easyCoexistence koristi; URN nove objave vraća se u zaglavlju x-restli-id.

Schedule a YouTube upload and publish a LinkedIn post
import requests

def schedule_on_youtube(channel_id: str, path: str, title: str, publish_at: str) -> str:
    c = credentials(channel_id)
    auth = {"Authorization": f"Bearer {c['access_token']}"}
    start = requests.post(
        "https://www.googleapis.com/upload/youtube/v3/videos",
        params={"uploadType": "resumable", "part": "snippet,status"},
        headers={**auth, "X-Upload-Content-Type": "video/mp4"},
        json={"snippet": {"title": title},
              "status": {"privacyStatus": "private", "publishAt": publish_at,  # ISO 8601
                         "selfDeclaredMadeForKids": False}},
    )
    start.raise_for_status()
    with open(path, "rb") as video:  # streamed, not read into memory
        done = requests.put(start.headers["Location"], data=video,
                            headers={**auth, "Content-Type": "video/mp4"})
    done.raise_for_status()
    return done.json()["id"]

def post_on_linkedin(channel_id: str, text: str) -> str:
    c = credentials(channel_id)
    r = requests.post(f"{c['api_base']}/posts", headers={
        "Authorization": f"Bearer {c['access_token']}",
        "LinkedIn-Version": c["required_headers"]["LinkedIn-Version"],  # YYYYMM
        "X-Restli-Protocol-Version": "2.0.0",
    }, json={
        "author": c["author_urn"],  # urn:li:organization:... or urn:li:person:...
        "commentary": text,
        "visibility": "PUBLIC",
        "distribution": {"feedDistribution": "MAIN_FEED", "targetEntities": [],
                         "thirdPartyDistributionChannels": []},
        "lifecycleState": "PUBLISHED",
        "isReshareDisabledByAuthor": False,
    })
    r.raise_for_status()
    return r.headers["x-restli-id"]  # the new post's URN

Kako iz Pythona čitate i odgovarate na komentare i DM-ove?

Uključite prosleđivanje za kanal, proverite svaku isporuku, pa odgovorite preko API-ja mreže. PUT /channels/{id}/webhook sa url vraća signing_secret, prikazan samo jednom. Komentari, pominjanja i DM-ovi na Instagramu i Facebooku, kao i komentari na TikToku, stižu kao POST sa platform, account_id, external_id i entry, pri čemu je entry tačno onakav kakav ga je mreža poslala. Zaglavlje X-EC-Signature glasi t=<unix>,v1=<hex>, a v1 je HMAC-SHA256 vremenske oznake, tačke i neobrađenog tela. Svaki događaj se šalje jednom, bez kopije i bez ponovnog slanja, pa prvo potvrdite prijem i radite iz reda čekanja.

Odgovor na Instagram DM ide na /{ig-id}/messages u roku od 24 sata od poslednje poruke osobe, najviše 1,000 bajtova. Komentar dobija javni odgovor na /{comment-id}/replies ili jedan privatni odgovor u roku od 7 dana. Komentari na TikToku dobijaju javne odgovore preko business/comment/reply/create/, jer na TikToku nema DM-ova, a komentari na YouTubeu i LinkedInu čitaju se preko njihovih API-ja po rasporedu.

Verify forwarded events and reply to Instagram DMs and comments
import hashlib, hmac, json, queue, time
import requests
from flask import Flask, abort, request

app = Flask(__name__)
jobs: queue.Queue = queue.Queue()  # a worker calls reply_on_instagram() for each event
SECRETS: dict[str, str] = {}  # channel_id -> signing_secret; keep them in your database

def forward_events(channel_id: str, url: str) -> None:
    r = requests.put(f"{EC}/channels/{channel_id}/webhook", headers=KEY, json={"url": url})
    r.raise_for_status()
    SECRETS[channel_id] = r.json()["signing_secret"]  # returned only this once

def verified(raw: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False
    mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac.encode(), v1.encode())

@app.post("/hooks/social")
def social_event():
    raw = request.get_data()
    event = json.loads(raw)  # platform, account_id, external_id, entry
    secret = SECRETS.get(event.get("account_id"))
    if not secret or not verified(raw, request.headers.get("X-EC-Signature", ""), secret):
        abort(401)
    jobs.put(event)  # sent once and never retried: acknowledge first, work after
    return "", 204

def reply_on_instagram(event: dict, text: str) -> None:
    c, me = credentials(event["account_id"]), event["external_id"]
    for m in event["entry"].get("messaging", []):  # DMs, minus echoes of your own
        if "message" in m and not m["message"].get("is_echo"):
            graph(c, f"{me}/messages", recipient={"id": m["sender"]["id"]}, message={"text": text})
    for ch in event["entry"].get("changes", []):  # comments, minus your own replies
        if ch["field"] == "comments" and ch["value"]["from"]["id"] != me:
            graph(c, f"{ch['value']['id']}/replies", message=text)

Kako iz Pythona objavljujete na TikToku?

Preko MCP alata publish_tiktok_post na easyCoexistence. TikTok API for Business prima video kao video_url i, od 16. novembra 2023, preuzima ga samo sa domena ili URL prefiksa verifikovanog za developer aplikaciju iza tokena, a to je aplikacija easyCoexistence. Alat prima vaš HTTPS link i predaje TikToku potpisanu adresu na easyCoexistence verifikovanoj ruti za medije, koja fajl prenosi bez čuvanja. Objave fotografija umesto toga uzimaju image_urls, 1 do 35 JPEG ili WebP fajlova, a get_tiktok_publish_status prati objavu dok TikTok obrađuje.

Iz Pythona to je jedan poziv preko zvaničnog MCP SDK-a, verzija 2, uz Python 3.10 ili noviji. Server na https://easycoexistence.com/api/mcp prihvata samo OAuth 2.1, pa OAuthClientProvider iz SDK-a registruje vaš klijent, vodi jednu prijavu u pregledaču sa PKCE i osvežava tokene. Pristupni tokeni traju sat vremena, a tokeni za osvežavanje 60 dana, pri čemu svako osvežavanje izdaje novi par, a skladište koje ih čuva održava backend prijavljenim.

Publish a TikTok video through the MCP server
import asyncio
import os
from urllib.parse import parse_qs, urlparse

import httpx2
from pydantic import AnyUrl
from mcp import Client
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.client.streamable_http import streamable_http_client
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken

MCP_URL = "https://easycoexistence.com/api/mcp"

class Storage:  # keep both values in a database, so the browser sign-in happens once
    tokens: OAuthToken | None = None
    client: OAuthClientInformationFull | None = None
    async def get_tokens(self): return self.tokens
    async def set_tokens(self, tokens): self.tokens = tokens
    async def get_client_info(self): return self.client
    async def set_client_info(self, info): self.client = info

async def show_sign_in(url: str) -> None:
    print("Sign in to easyCoexistence:", url)

async def read_callback() -> AuthorizationCodeResult:
    query = parse_qs(urlparse(input("Paste the address you were sent back to: ")).query)
    return AuthorizationCodeResult(code=query["code"][0], state=query["state"][0])

oauth = OAuthClientProvider(
    server_url=MCP_URL,
    client_metadata=OAuthClientMetadata(
        client_name="My social agent",
        redirect_uris=[AnyUrl("http://localhost:3030/callback")],
        scope="mcp",
    ),
    storage=Storage(),
    redirect_handler=show_sign_in,
    callback_handler=read_callback,
)

async def main() -> None:
    timeout = httpx2.Timeout(30.0, read=300.0)
    async with httpx2.AsyncClient(auth=oauth, timeout=timeout) as http:
        async with Client(streamable_http_client(MCP_URL, http_client=http)) as client:
            result = await client.call_tool("publish_tiktok_post", {
                "account_id": os.environ["TIKTOK_CHANNEL_ID"],  # the Partner API channel id
                "video_url": "https://cdn.example.com/launch.mp4",
                "caption": "New drop #behindthescenes",
            })
            print(result.content[0].text)  # a share_id for get_tiktok_publish_status

asyncio.run(main())

Kako Python AI agent koristi ove naloge?

Preko iste MCP sesije. Server izlistava alate za mreže na vašem nalogu, a svaki agent framework koji prihvata MCP alate može ih predati svom modelu: objavljivanje na svakoj mreži, izlistavanje objava, čitanje komentara i odgovaranje na njih, odgovaranje na DM-ove na Instagramu i Facebooku, podešavanje pravila komentar-u-DM i čitanje uvida i analitike. Uputstva servera i opis svakog alata nose pravila mreže, pa model zna da su TikTok odgovori javni i da Instagram slike moraju biti JPEG.

Agent pokrenite sa list_social_accounts, jer svaki drugi alat za društvene mreže uzima account_id iz njega, a taj ID je isti kao channel ID koji vraća Partner API. Odgovori koje treba poslati u 3 ujutru bez pokrenutog agenta pripadaju pravilima za komentare i automatizacijama, koje rade na samom easyCoexistence.

Česte greške

  • Čuvanje tokena u konfiguracionom fajlu. TikTok token ističe u roku od jednog dana, a Google token u roku od jednog sata. easyCoexistence ih obnavlja iza kulisa, pa pozovite endpoint za kredencijale na početku svakog posla.
  • Davanje TikToku linka sa vašeg domena. TikTok preuzima medije samo sa URL prefiksa verifikovanih za aplikaciju koja drži token, pa objavljujte preko publish_tiktok_post, koji vaš fajl servira sa easyCoexistence verifikovane adrese.
  • Odgovaranje na svaki događaj o komentaru, uključujući vaš sopstveni. Vaši javni odgovori se vraćaju kao novi komentari, a vaši Instagram DM-ovi kao eho, pa preskočite događaje čiji je autor sam nalog, inače bot odgovara sam sebi.
  • Merenje Instagram DM-a u znakovima. Ograničenje je 1,000 bajtova UTF-8, pa tekst sa emoji ili slovima sa dijakritikom brže ponestaje. Skratite ga po kodiranoj dužini pre slanja.
Ovo radite uz EasyCoexistence

easyCoexistence daje vašem Python kodu i vašim AI agentima pristup kupcima na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, preko zvaničnog API-ja svake mreže. Partner API povezuje naloge i izdaje svež token, MCP server daje agentima iste naloge kao alate, a svaka veza se prati 24/7. Od US$ 9 do US$ 0.75 po vezi mesečno, uz pad kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Da li su mi potrebne sopstvene developer aplikacije za Meta, TikTok, Google ili LinkedIn?

Ne. Nalozi se prijavljuju preko aplikacije easyCoexistence na svakoj mreži, a poziv za kredencijale vašem kodu daje token tog naloga na TikToku, YouTubeu i LinkedInu, spreman za upotrebu prema API-ju mreže.

Koju verziju Pythona i koje biblioteke su mi potrebne?

Partner API i API-ji mreža su običan HTTPS sa JSON-om, pa ih pozivaju requests, httpx ili bilo koji drugi Python HTTP klijent. MCP Python SDK, verzija 2, koji koriste TikTok objave i alati za agente, zahteva Python 3.10 ili noviji.

Koje mreže šalju komentare i DM-ove na moj endpoint?

Instagram i Facebook prosleđuju komentare, pominjanja i DM-ove, a TikTok prosleđuje komentare, svaki potpisan tajnom kanala. YouTube i LinkedIn ne šalju takve događaje, pa njihove komentare čitajte preko njihovih API-ja po rasporedu.

Koliko košta easyCoexistence za Python?

Od US$ 9 do US$ 0.75 po vezi mesečno, uz pad kako dodajete veze, isto na svakoj mreži. Partner API i MCP konektor su uključeni, bez naknade po korisniku, a prva 3 dana su besplatna.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na