Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Objavljujte na Instagram, TikTok i Facebook iz Pythona jednim API-jem

Uz easyCoexistence, Python kod objavljuje na Instagramu, Facebooku, TikToku, YouTubeu i LinkedInu putem službenog API-ja svake mreže. Svaki se račun jednom prijavi putem poveznice za prijavu; vaša skripta zatim dohvaća svjež token za TikTok, YouTube ili LinkedIn jednim GET zahtjevom, dok se pozivi za Instagram i Facebook šalju kroz MCP alate easyCoexistencea, koji održavaju token. MCP alati daju Python agentu iste račune.

1,000 bytes

Najviše teksta koji jedna Instagram DM poruka može nositi kroz API, brojeno u UTF-8, pa emoji zauzimaju više mjesta.

24 hours

Koliko traje pristupni token TikTok API for Business; njegov token za osvježavanje vrijedi godinu dana.

1 hour

Koliko dugo vrijedi korisnički pristupni token Googlea, onaj koji nosi svaki poziv YouTube API-ja.

OAuthClientProvider

OAuth rukovatelj MCP Python SDK-a, koji registrira klijenta, provodi prijavu s PKCE-om i osvježava tokene.

1 attempt

Proslijeđeni događaji komentara, spominjanja i DM-ova isporučuju se jednom i nikad se ne pohranjuju, pa svaki odmah potvrdite.

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

Putem sesije povezivanja na Partner API-ju easyCoexistencea, autentificirane vašim ključem ec_live_. POST /connect-sessions s channel postavljenim na instagram, facebook, tiktok, youtube ili linkedin vraća poveznicu za jednog korisnika, koja vrijedi sat vremena. Korisnik se prijavljuje vlastitom prijavom mreže i završava na vašem redirect_url s status=connected i channel_id, koji vaš backend potvrđuje pozivom GET /connect-sessions/{session}, umjesto da vjeruje query stringu. Vašem kodu nikad ne treba vlastita developerska aplikacija na Metau, TikToku, Googleu ili LinkedInu.

Zatim zatražite vjerodajnice na početku svakog posla. GET /channels/{id}?credentials=1 vraća osnovu API-ja mreže, id računa na toj mreži i, za TikTok, YouTube i LinkedIn, pristupni token koji easyCoexistence održava obnovljenim. TikTokov token vrijedi 24 sata, Googleov jedan sat, zato ga dohvaćajte po poslu umjesto da ga spremate. Instagramovi i Facebookovi tokeni se nikad ne izdaju; njihovi se pozivi obavljaju putem 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 objavljivati na Instagram i Facebook iz Pythona?

Instagram objavljuje u dva koraka na Metinom Graph API-ju, s tokenom u zaglavlju Bearer. POST /{ig-id}/media s image_url i opisom stvara spremnik; kad GET njegova status_code pokaže FINISHED, POST /{ig-id}/media_publish s spremnikom kao creation_id ga objavljuje na profilu. Meta preporučuje provjeru otprilike jednom u minuti, do pet minuta. Reel slijedi iste korake, poslan s media_type REELS i video_url umjesto slike.

Objava na Facebook stranici jedan je poziv: POST /{page-id}/feed s message i, ako želite, link. Dodavanjem published false i scheduled_publish_time između 10 minuta i 30 dana unaprijed Meta je objavljuje u tom trenutku, bez vašeg procesa u pozadini. Meta u oba slučaja preuzima medije s javnog URL-a, a Instagram prihvaća 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 učitati na YouTube i objaviti na LinkedIn iz Pythona?

YouTube prima video kao nastavljivo učitavanje. Prvi zahtjev ide na endpoint za učitavanje s uploadType=resumable i part=snippet,status te nosi naslov i status kao JSON; zaglavlje Location u odgovoru je adresa sesije. PUT datoteke na tu adresu vraća 201 s novim videom. Postavljanje privacyStatus na private s vremenom publishAt omogućuje YouTubeu da sam objavi video u tom trenutku, a selfDeclaredMadeForKids bilježi je li video namijenjen djeci.

LinkedIn prima jedan POST na /rest/posts s tokenom Bearer, zaglavljem LinkedIn-Version i X-Restli-Protocol-Version 2.0.0. Tijelo navodi autora, nosi tekst kao commentary i postavlja visibility, distribution i lifecycleState. Vjerodajnice daju author_urn, urn:li:organization za stranicu tvrtke ili urn:li:person za profil, te 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 čitati i odgovarati na komentare i DM-ove u Pythonu?

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

Odgovor na Instagram DM ide na /{ig-id}/messages unutar 24 sata od posljednje poruke osobe, u najviše 1,000 bajtova. Komentar dobiva javni odgovor na /{comment-id}/replies ili jedan privatni odgovor unutar 7 dana. Odgovori na TikTok komentare šalju se javno putem business/comment/reply/create/, jer na TikToku nema DM-ova, a komentari na YouTubeu i LinkedInu čitaju se putem njihovih API-ja prema 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 objavljivati na TikTok iz Pythona?

Putem easyCoexistenceova MCP alata publish_tiktok_post. TikTokov API for Business prima video kao video_url i, od 16. studenoga 2023., preuzima ga samo s domene ili prefiksa URL-a provjerenog za aplikaciju developera iza tokena, a to je easyCoexistenceova. Alat prihvaća vaš HTTPS link i TikToku daje potpisanu adresu na easyCoexistenceovoj provjerenoj medijskoj ruti, pri čemu datoteku prosljeđuje bez pohranjivanja. Objave fotografija umjesto toga uzimaju image_urls, 1 do 35 JPEG ili WebP datoteka, a get_tiktok_publish_status prati objavu dok je TikTok obrađuje.

Iz Pythona to je jedan poziv putem službenog MCP SDK-a, verzija 2, na Pythonu 3.10 ili novijem. Poslužitelj na https://easycoexistence.com/api/mcp prihvaća samo OAuth 2.1, pa OAuthClientProvider iz SDK-a registrira vašeg klijenta, provodi jednu prijavu u pregledniku s PKCE-om i osvježava tokene. Pristupni tokeni vrijede jedan sat, a tokeni za osvježavanje 60 dana. Svako osvježavanje izdaje novi par, a pohrana koja ih trajno čuva drži 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 AI agent u Pythonu koristi ove račune?

Putem iste MCP sesije. Poslužitelj popisuje alate za mreže na vašem računu, a svaki okvir za agente koji prihvaća MCP alate može ih predati svom modelu: objavljivanje na svakoj mreži, popis objava, čitanje komentara i odgovaranje na njih, odgovaranje na DM-ove na Instagramu i Facebooku, postavljanje pravila od komentara do DM-a te čitanje uvida i analitike. Upute poslužitelja i opis svakog alata nose pravila mreže, pa model zna da su odgovori na TikToku javni i da Instagram slike moraju biti JPEG.

Agenta pokrenite s list_social_accounts, jer svaki drugi alat za društvene mreže uzima account_id iz njega, a taj je id isti kao channel id koji vraća Partner API. Odgovori koji moraju biti poslani u 3 ujutro bez pokrenutog agenta pripadaju pravilima komentara i automatizacijama, koje rade na samom easyCoexistenceu.

Uobičajene pogreške

  • Spremanje tokena u konfiguracijsku datoteku. TikTokov token vrijedi manje od dana, a Googleov manje od sata. easyCoexistence ih obnavlja iza kulisa, zato na početku svakog posla pozovite endpoint za vjerodajnice.
  • Davanje TikToku poveznice na vašoj vlastitoj domeni. TikTok preuzima medije samo s URL prefiksa provjerenih za aplikaciju koja drži token, zato objavljujte putem publish_tiktok_post, koji vašu datoteku servira s easyCoexistenceove provjerene adrese.
  • Odgovaranje na svaki događaj komentara, uključujući vlastite. Vaši javni odgovori vraćaju se kao novi komentari, a vaši Instagram DM-ovi kao odjeci, pa preskočite događaje čiji je autor sam račun, inače bot odgovara sam sebi.
  • Mjerenje Instagram DM-a u znakovima. Ograničenje je 1,000 bajtova UTF-8, pa tekst s emojijima ili slovima s dijakriticima brže ponestaje. Skratite ga prema kodiranoj duljini prije slanja.
Radite ovo 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, putem službenih API-ja svake mreže. Partner API povezuje račune i izdaje svježe tokene, MCP poslužitelj daje agentima iste račune kao alate, a svaka veza nadzire se 24/7. Od US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Trebam li vlastitu developersku aplikaciju za Meta, TikTok, Google ili LinkedIn?

Ne. Računi se prijavljuju putem vlastite aplikacije easyCoexistencea na svakoj mreži, a poziv za vjerodajnice vašem kodu daje token računa na TikToku, YouTubeu i LinkedInu, spreman za upotrebu prema API-ju mreže.

Koja verzija Pythona i koje biblioteke trebam?

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

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

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

Koliko košta easyCoexistence za Python?

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

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na