Adeli API
Adeli maintains the developer app on every network, completes each platform's review, and manages OAuth and token refresh, so you hold one API key. Your first…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Adeli maintains the developer app on every network, completes each platform's review, and manages OAuth and token refresh, so you hold one API key. Your first 3 connected accounts are free. Guides and examples: https://www.tryadeli.com/docs
Endpoints 76
API key
- GETCheck your API key
/api/v1/meWho the key belongs to, which key it is, and the accounts connected to a profile (the default profile unless profileId is given). Read-only; the same shape…
Profiles
- GETList profiles
/api/v1/profilesEvery profile in the API key's organization, the default first. - POSTCreate a profile
/api/v1/profilesSend an Idempotency-Key header to make retries safe. - GETGet a profile
/api/v1/profiles/:profileId - PUTReplace a profile's fields
/api/v1/profiles/:profileId - DELETEDelete a profile and its connected accounts
/api/v1/profiles/:profileId - POSTStart connecting a social account
/api/v1/profiles/:profileId/connectReturns a URL for your customer to authorize the account on the platform. - GETCheck a connection's status
/api/v1/profiles/:profileId/connect/:connectionSessionId
Accounts
- GETList connected accounts
/api/v1/accounts - GETList a profile's connected accounts
/api/v1/profiles/:profileId/accounts - GETGet a connected account
/api/v1/profiles/:profileId/accounts/:accountId - DELETEDisconnect an account
/api/v1/profiles/:profileId/accounts/:accountId - PATCHSwitch an X account's paid background reads
/api/v1/profiles/:profileId/accounts/:accountId - POSTRefresh every account's access token
/api/v1/profiles/:profileId/accounts/refresh
Posts
- GETList posts
/api/v1/posts - POSTPublish a post
/api/v1/postsPublish to Instagram, Facebook, TikTok, YouTube, X, Bluesky, or LinkedIn. A LinkedIn post takes at most one of image, images (2–20 staged images), video (one… - POSTPrepare direct media uploads
/api/v1/media/uploadsCreate short-lived, object-scoped S3 PUT descriptors. Upload each file with the returned headers unchanged, then pass its uploadId as upload_id when… - GETList publications
/api/v1/publicationsPublications in the profile, newest first, or soonest first with status=scheduled. Filter by status, platform, or accountId; page with cursor and limit. - POSTPublish one post to several accounts
/api/v1/publicationsShared content and media go to every target in platforms; a target's own content, media, and options (that platform's createPost fields) override them. Every… - GETCheck a publication's progress
/api/v1/publications/:publicationIdThe publication's status, its overall progress from 0 to 1, and each target's status, result, and error. - DELETECancel a scheduled publication or draft
/api/v1/publications/:publicationIdThe publication becomes canceled and is never published; its kept media is deleted. Answers 409 once it has started. - PATCHReschedule or edit a scheduled publication or draft
/api/v1/publications/:publicationIdOnly while the publication is scheduled or a draft. scheduledFor reschedules it (a draft becomes scheduled). platforms, with optional content and media,… - POSTPublish a scheduled publication or draft now
/api/v1/publications/:publicationId/publishStarts the publication at once, as createPublication without scheduledFor would. Poll getPublication for progress. Answers 409 once it has started or was… - POSTRetry a publication's failed targets
/api/v1/publications/:publicationId/retryRe-runs only failed targets with their original inputs. A target that may already be live (outcome_unknown) is never retried. Answers 409 while the… - POSTUpload a video file to YouTube
/api/v1/posts/youtubeRecommended: send JSON with staged video and optional thumbnail upload references created by createMediaUploads. Legacy multipart remains supported for… - DELETEDelete an X post
/api/v1/posts/x/:postId?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - DELETEDelete a Bluesky post
/api/v1/posts/bluesky/:postId?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETCheck an Instagram post's publishing status
/api/v1/posts/instagram/status?jobId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETList an Instagram account's active stories
/api/v1/posts/instagram/stories?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6Reads the account's live stories from Instagram, newest first: the last 24 hours, with expiresAt 24 hours after timestamp. mediaUrl is null for video with… - GETCheck a Facebook video's processing status
/api/v1/posts/facebook/status?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6&publishId=string - GETCheck a TikTok post's publishing status
/api/v1/posts/tiktok/status?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6&publishId=string - GETGet a TikTok creator's posting options
/api/v1/posts/tiktok/creator-info?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6TikTok requires showing these options (privacy levels, interaction settings) before posting. - GETCheck a YouTube video's processing status
/api/v1/posts/youtube/status?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6&videoId=string
Comments
- GETList comments
/api/v1/comments?platform=instagram&accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - POSTReply to a post or a comment
/api/v1/comments - DELETEDelete a comment
/api/v1/comments/:commentId?platform=instagram&accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - PATCHHide, unhide, or moderate a comment
/api/v1/comments/:commentId
Messages
- GETList direct-message conversations
/api/v1/messagesWithout conversationKey, every message for the profile, account or platform, oldest first. With conversationKey (which requires accountId; 400 invalid_request… - POSTSend a direct message
/api/v1/messagesInstagram and Facebook send text. WhatsApp sends an approved template, or free text (up to 4,096 characters) inside the 24-hour window after the customer's… - POSTSend an Instagram message or private reply
/api/v1/messages/instagramA DM to an IGSID, or a private reply to a comment's author (Instagram Login only, one per comment), with up to three postback or URL buttons. - GETGet an Instagram user who messaged the account
/api/v1/messages/instagram/users/:igsid?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6Reads someone who has messaged the Instagram account, live from Instagram: their username and name, and whether they follow the account (isFollowing).…
Webhooks
- GETList webhooks
/api/v1/webhooks?profileId=3fa85f64-5717-4562-b3fc-2c963f66afa6Lists the profile's webhooks. platform is the platform a webhook receives events from, or null for every supported platform. status says whether delivery is… - POSTCreate a webhook
/api/v1/webhooksRegisters a URL for comment.created, message.postback and message.created events on one profile. Pass platform (instagram, tiktok, facebook or whatsapp) to… - DELETEDelete a webhook
/api/v1/webhooks/:webhookId - POSTSend a test event
/api/v1/webhooks/:webhookId/testSends one signed sample event (test: true) to the webhook now and returns the receiver's status code. One attempt, no retries; at most one test per webhook…
Analytics
- GETInstagram account insights
/api/v1/analytics/instagram/account-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETFacebook Page metrics
/api/v1/analytics/facebook/page-metricsPass profileId or accountId; accountId selects a specific Facebook connection. - GETTikTok account analytics
/api/v1/analytics/tiktok/account-analytics?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETTikTok account insights (TikTok API for Business)
/api/v1/analytics/tiktok/account-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETTikTok video insights
/api/v1/analytics/tiktok/video-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETYouTube channel insights
/api/v1/analytics/youtube/channel-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETYouTube video insights
/api/v1/analytics/youtube/video-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6 - GETLinkedIn account insights
/api/v1/analytics/linkedin/account-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6Followers and a daily series of impressions, reactions, comments, shares and follower gain for a LinkedIn Page or personal profile; clicks and Page views are… - GETLinkedIn post insights
/api/v1/analytics/linkedin/post-insights?accountId=3fa85f64-5717-4562-b3fc-2c963f66afa6Lifetime counters for up to five LinkedIn posts, or the account's recent posts when postUrns is omitted. A personal profile's posts must have been published…
Ads
- GETList Meta businesses
/api/v1/ads/businessesMeta only; a TikTok Ads or LinkedIn Ads account returns 400 unsupported_for_platform. - GETList ad accounts
/api/v1/ads/accountsMeta ad accounts (act_<digits>), TikTok advertisers (<digits>) or LinkedIn ad accounts (<digits>, with the member's role, readOnly and the organizationUrn… - POSTCreate an ad account
/api/v1/ads/accountsMeta only. - GETGet an ad account
/api/v1/ads/accounts/:adAccountIdMeta only. Served from a copy at most five minutes old. - PATCHUpdate an ad account
/api/v1/ads/accounts/:adAccountIdMeta only. - GETCampaigns, ad sets (TikTok ad groups, LinkedIn campaigns), and ads for an ad account
/api/v1/ads/tree?adAccountId=stringFor LinkedIn, campaigns are campaign groups, adSets are campaigns, and ads are creatives. Meta trees are served from a copy at most five minutes old:… - GETAd performance insights
/api/v1/ads/insights?adAccountId=stringA daily series (points), or with breakdown totals split by one dimension (rows). Meta points and rows also carry reach, CTR, CPC, CPM, every action and its… - GETList lead forms or leads from a lead form
/api/v1/ads/leadsMeta only. Forms are served from a copy at most fifteen minutes old; leads are always read from Meta and never stored. - POSTCreate a paused campaign
/api/v1/ads/campaignsMeta: a body with objective builds a full campaign — objective, daily or lifetime budget, schedule, bid strategy, targeting and a new image, video or carousel… - DELETEDelete a campaign
/api/v1/ads/campaigns/:campaignId?adAccountId=string - PATCHChange a Meta campaign's name, budget, bid strategy or spend cap
/api/v1/ads/campaigns/:campaignIdMeta only. A budget or bid strategy applies to Advantage campaign budget (CBO) campaigns; one that budgets per ad set returns 400, so change it on the ad set.… - DELETEDelete a Meta ad set
/api/v1/ads/ad-groups/:adGroupId?adAccountId=stringMeta only. Deletes the ad set and its ads; irreversible. - PATCHChange an ad set (TikTok ad group, LinkedIn campaign)
/api/v1/ads/ad-groups/:adGroupIdMeta: name, daily or lifetime budget (the type it already has), bid, start and end dates, and targeting (which replaces the whole spec). TikTok and LinkedIn:… - DELETEDelete a Meta ad
/api/v1/ads/ads/:adId?adAccountId=stringMeta only. Irreversible; the ad set and campaign stay. - POSTEstimate a Meta audience's size
/api/v1/ads/reach-estimateMeta only. A read: creates nothing. Bounds are null when Meta cannot estimate, as for some custom audiences. - GETList the Instagram accounts a Meta ad account can run ads as
/api/v1/ads/instagram-accounts?adAccountId=stringMeta only. Pass an id as instagramAccountId when creating a campaign. - PUTPause or activate a campaign, ad set (ad group), or ad
/api/v1/ads/statusLinkedIn: activating a draft campaign group Adeli created activates its creative, campaign and group, in that order. Meta: changes to one ad account are… - GETSearch or list targeting options
/api/v1/ads/targeting?adAccountId=string&type=interestsMeta: interests, behaviors, demographics, locations and languages, each option's id being what a campaign's targeting takes (a location's key, a language's… - GETList TikTok ad identities
/api/v1/ads/identities?adAccountId=stringTikTok only. The brand name and avatar an ad runs as. - POSTCreate a TikTok ad identity
/api/v1/ads/identitiesTikTok only.
Usage
- GETThis month's posts, messages and comments
/api/v1/usageThe workspace's sends this UTC month, across all its profiles, against the free tier's allowance: 1,000 posts, 10,000 messages and 10,000 comments per… - GETX API usage for the organization
/api/v1/usage/xX API fees are passed through at X's published rates; this totals the organization's usage.
API details
- Base URL
https://app.tryadeli.com- Authentication
- A bearer token in the Authorization header
- Operations
- 76 operations on 58 pathsGET 40POST 18DELETE 10PATCH 6PUT 2
- Main resources
- Ads 20Posts 19Analytics 9Profiles 7Accounts 6Comments 4Messages 4Webhooks 4Usage 2API key 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Tryadeli's published OpenAPI description
How to test the Adeli API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Adeli API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Check your API key” (GET /api/v1/me), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Adeli API?
Adeli maintains the developer app on every network, completes each platform's review, and manages OAuth and token refresh, so you hold one API key. Your first… It is listed under Social and has 76 endpoints.
Who publishes the Adeli API?
It is listed from Tryadeli's public API description (an OpenAPI document), not published by Tryadeli on Swastik Codes. Anyone who controls tryadeli.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Adeli API?
Requests go to https://app.tryadeli.com. Endpoint paths are added to this base URL.
How do I authenticate with the Adeli API?
With A bearer token in the Authorization header.
How many endpoints does the Adeli API have?
76 operations on 58 paths (40 GET, 18 POST, 10 DELETE, 6 PATCH, 2 PUT). The largest groups are Ads, Posts, Analytics, Profiles.
Is forking the Adeli API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.