Comunicate.eu

Comunicate.eu API

Publish articles (advertorials, press releases) on 3.800+ websites in Romania, Italy and beyond: catalogue, articles, publications, campaigns, reports. Open,…

Finance & banking#business

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

Publish articles (advertorials, press releases) on 3.800+ websites in Romania, Italy and beyond: catalogue, articles, publications, campaigns, reports.

Open, no key needed. The routes under /public/ are open to anyone and read-only: niches, catalogue figures and market statistics (authority distribution, turnaround times, price per campaign type). No sign-up, no rate-limit headers to negotiate. There is deliberately no public route that returns the full publication list.

Everything else needs an API key issued in Integrations, sent as Authorization: Bearer bk_live_…, or an OAuth 2.1 access token. Writing anything — articles, orders, publications — always requires a key. Also available as an MCP server at https://app.comunicate.eu/mcp.

Endpoints 43

Public catalogue

  • GETCatalogue search/public/catalogSearches publications by text, niche, campaign type, DA and price. At most 20 per page and the first 120 per search. No authentication required: this route is…
  • GETBudget plan/public/planPublication packages for a budget in lei, by niche, topic (cuvinte) and city (zona). For other options, send back the exclude list from the response. No…
  • GETCampaign types/public/campaign-typesWhat each campaign type means and what the text must or must not contain. No authentication required: this route is open to anyone.
  • GETCatalogue figures/public/statsHow many active publications the network has, and across how many niches. No key needed. No authentication required: this route is open to anyone.
  • GETThe network’s niches/public/nichesAll niches, with the publication count and average authority of each. No key needed. No authentication required: this route is open to anyone.
  • GETOne niche, with sample publications/public/niches/:slugThe requested niche and a few of its publications, with authority, turnaround and price. It is a sample, not the inventory: the full list is visible from an…
  • GETMarket statistics/public/statistici-piataThe catalogue’s aggregate figures: how many publications, how many from our own network, the authority distribution, turnaround times and the price for each…

Key and permissions

  • GETWho am I/partner/meThe organisation behind the key, its permissions and the AI assistants switch. Requires no scope: any valid key may ask. No scope required.

Catalogue

  • GETList publications/partner/catalogThe paginated catalogue, with the same filters as the interface. Each entry also states how it can be paid for: from a package, from the balance, or not at…
  • GETOne publication/partner/catalog/:siteIdThe same shape as a list entry, plus what does not fit in a listing: per-campaign terms, accepted topics, active offers — writing, homepage placement,…
  • GETCampaign types/partner/campaign-typesA type is not a label but a set of conditions the article passes or fails on submission. Checking them up front saves a chain of one-by-one rejections. Which…

Articles

  • GETList articles/partner/articlesThe organisation's articles, most recently updated first. Cursor-paginated: the response's nextCursor is sent back as cursor for the next page, null on the…
  • POSTCreate an article from HTML/partner/articlesThe direct route, when you already have the text. The markup goes through the same sanitiser as imports: scripts, inline styles and elements that do not…
  • POSTImport a document/partner/articles/importAccepts Word documents (.docx, .docm, .doc, .dot, .dotx), LibreOffice and OpenOffice ones (.odt, .ott, .fodt, .sxw), .rtf, .wpd, .wps, plus .html and .htm.…
  • GETList a Drive folder/partner/articles/drive?link=stringThe folder must be shared "anyone with the link": the platform reads it with its own account, the client signs in nowhere. Listing is deliberately a separate…
  • POSTImport from the Drive folder/partner/articles/driveAt most fifty documents at a time. A broken document does not stop the rest: the result has one entry per file, with either the article count or its error.…
  • GETOne article/partner/articles/:articleIdThe whole article, with its text. This is also where you see whether a draft requested through redactare has finished: redactedAt set means done, and…
  • PATCHUpdate an article/partner/articles/:articleIdEvery field from creation, all optional. Send only what changes. The same normalisations apply: one keyword, at most three tags. version increases only when…

Writing orders

  • GETYour orders/partner/redactarestatus filters. Most recent first. Required scope: ARTICLES_READ.
  • POSTOrder an article/partner/redactareThe response is the order, with status: "NOUA". When it is done, the same order has status: "LIVRATA" and articleId filled in. It is paid from the money…
  • GETOrder status/partner/redactare/:orderIdStates: NOUA (received), IN_LUCRU (someone here picked it up), LIVRATA (articleId filled in, chargedCents says what was charged), REFUZATA (with…
  • POSTCancel an order/partner/redactare/:orderId/anuleazaOnly while it is NOUA. Once someone here has picked it up the work is done or in progress and cancelling is no longer yours to do: you get 409, and closing it…

Checks

  • DELETEDelete an article/partner/articles/:articleIdResponds 204 on success. Refused with 409 if the article has publications: a publication's history must be able to show what was sent, and a published article…
  • GETSEO analysis/partner/articles/:articleId/seoScore, findings, statistics and the heading outline. The score is the percentage of checks passed, not a ranking promise. What matters in the response is…
  • GETDoes it match the campaign type?/partner/articles/:articleId/potrivireA different question from the SEO analysis: that one says how well the text is written, this one says whether it is the article that was ordered. A flawless…
  • GETPrevious revisions/partner/articles/:articleId/revisionsThe full text of every replaced version. A revision is written on each title or content change — exactly when version increases. It exists for the moment a…

Media

  • POSTUpload an image/partner/mediaJPEG, PNG, GIF, WebP or AVIF. The type is detected from content, not from the extension or header: a disguised file is rejected. The same image uploaded twice…

Publications

  • GETList publications/partner/publicationsAll the organisation's publications. status filters. Cursor-paginated: the response's nextCursor is sent back as cursor for the next page, null on the last…
  • POSTRequest publication/partner/publicationsOne article, one or more publications. Payment ambiguity is never guessed. When several owned packages cover the same site, the request is rejected with 409…
  • GETOne publication/partner/publications/:publicationIdThe whole publication, with its event history and the reason, when it failed or was rejected. Required scope: PUBLICATIONS_READ.

Campaigns

  • GETList campaigns/partner/campaignsstatus filters. Cursor-paginated: the response’s nextCursor is sent back as cursor for the next page, null on the last one. Required scope: CAMPAIGNS_READ.
  • POSTCreate a campaign/partner/campaignsThe body is strict: a field it does not know is rejected with 400, not silently ignored. Better an error on the first attempt than a setting that looks…
  • GETOne campaign/partner/campaigns/:campaignIdThe campaign, with its articles and publications. Required scope: CAMPAIGNS_READ.
  • DELETEDelete a campaign/partner/campaigns/:campaignIdResponds 204 on success. Refused with 409 if the campaign is active and has articles — the same rule as in the interface: a campaign with history gets…
  • PATCHUpdate a campaign/partner/campaigns/:campaignIdEvery field from creation, all optional. Send only what changes. Most often used for campaignType: binds an already-created campaign to a type, or clears it…

Balance and reports

  • GETAvailable balance/partner/balanceThe packages you own, with the credit left on each, and the money balance. Check it before requesting a publication — otherwise the integration finds out from…
  • GETPeriod summary/partner/reports/summaryDefaults to the last 30 days. An integration that sends no range gets something useful, not the entire history. Required scope: REPORTS_READ.
  • GETPublications in range/partner/reports/publicationsRow by row, for reporting to the client. Required scope: REPORTS_READ.

Domain audit

  • GETAudit a domain/partner/audit?url=stringRequires no permission: it neither reads nor writes anything about any organisation, it measures a public page anyone can open in a browser. Nothing is…

Partner sites

  • GETPartner catalogue/partner/vitrina/catalogWithout updatedSince: the whole current catalogue, paged (cursor). With updatedSince: only what changed since, plus removed publications in removed. First…
  • GETOne catalogue publication/partner/vitrina/catalog/:slugBy slug, domain or id. 404 when it is not in the partner catalogue. Required scope: CATALOG_READ.
  • POSTHand over a cart/partner/vitrina/handoffsThe finished partner cart becomes a handoff with a signed link valid for 72 hours. Send the customer to url. Prices are recalculated on our side;…
  • GETHandoff status/partner/vitrina/handoffs/:idCREATED, OPENED, CLAIMED, EXPIRED or CANCELLED, plus the publications made from it (publication and status only). Nothing about the customer. Required scope:…

API details

Base URL
https://app.comunicate.eu/api/v1
Authentication
A bearer token in the Authorization header
OAuth 2.0 (authorization code flow) with 10 scopes
Operations
43 operations on 34 pathsGET 30POST 9PATCH 2DELETE 2
Main resources
Articles 7Public catalogue 7Campaigns 5Checks 4Partner sites 4Writing orders 4Balance and reports 3Catalogue 3Publications 3Domain audit 1
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the Comunicate.eu API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Comunicate.eu API collection, without the publisher's secrets.
  3. 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.
  4. Send a requestPick an endpoint, for example “Catalogue search” (GET /public/catalog), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Comunicate.eu API?

Publish articles (advertorials, press releases) on 3.800+ websites in Romania, Italy and beyond: catalogue, articles, publications, campaigns, reports. Open,… It is listed under Finance & banking and has 43 endpoints.

Who publishes the Comunicate.eu API?

It is listed from Comunicate.eu's public API description (an OpenAPI document), not published by Comunicate.eu on Swastik Codes. Anyone who controls comunicate.eu can claim the profile by adding a DNS TXT record.

What is the base URL of the Comunicate.eu API?

Requests go to https://app.comunicate.eu/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the Comunicate.eu API?

It accepts 2 methods: A bearer token in the Authorization header; OAuth 2.0 (authorization code flow) with 10 scopes.

How many endpoints does the Comunicate.eu API have?

43 operations on 34 paths (30 GET, 9 POST, 2 PATCH, 2 DELETE). The largest groups are Articles, Public catalogue, Campaigns, Checks.

Is forking the Comunicate.eu API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.