Tarraing do chuid alt.
Foilsigh iad ar do bhealach féin.

An cuntas lena mbaineann an eochair, agus ainm agus réimír na heochrach féin. Úsáideach thar aon ní eile do rud amháin: a insint daoibh gurb í an eochair sa timpeallacht seo an eochair a shíleann sibh atá inti.

Sampla

curl https://seonis.ai/api/v1/me \
  -H "Authorization: Bearer $SEONIS_API_KEY"

Gach suíomh ar an gcuntas. Is é an id a úsáideann liosta na n-alt le scagadh, agus tá an fearann ann ionas gur féidir le script tógála meaitseáil le rud atá ar eolas aici cheana seachas id a iompar.

Sampla

curl https://seonis.ai/api/v1/sites \
  -H "Authorization: Bearer $SEONIS_API_KEY"

{
  "sites": [
    {
      "id": 5,
      "name": "Peppervale",
      "domain": "peppervale.co.uk",
      "url": "https://peppervale.co.uk",
      "language": "en",
      "country": "GB",
      "market": "en-GB",
      "status": "active",
      "articles_published": 34,
      "created_at": "2026-06-02T11:04:19+00:00"
    }
  ]
}

Leathanach alt, an t-athrú is nuaí ar dtús, gan an scríbhneoireacht. Ordaítear iad de réir an uair dheireanaigh ar athraíodh gach alt seachas de réir an uair a scríobhadh é, agus is é sin a fhágann go bhfuil updated_since úsáideach: is féidir alt atá beo cheana a chur in eagar níos déanaí, nuair a chuirtear nasc isteach ann nó nuair a bhaintear amach arís é.

Paraiméadair iarratais

Sampla

curl -G https://seonis.ai/api/v1/articles \
  -H "Authorization: Bearer $SEONIS_API_KEY" \
  -d site_id=5 \
  -d status=ready \
  -d updated_since=2026-09-01T00:00:00Z \
  -d per_page=50

{
  "articles": [
    {
      "id": 918,
      "site_id": 5,
      "language": "en",
      "status": "ready",
      "title": "How to choose a pepper grinder",
      "slug": "how-to-choose-a-pepper-grinder",
      "meta_title": "How to choose a pepper grinder | Peppervale",
      "meta_description": "Burr or blade, ceramic or steel: what matters in a grinder.",
      "meta_keywords": ["pepper grinder", "burr grinder"],
      "tags": ["Kitchen"],
      "excerpt": "A burr grinder gives an even grind; a blade one does not.",
      "key_takeaways": ["A burr grinder gives an even grind; a blade one does not."],
      "faq": [{ "question": "Ceramic or steel?", "answer": "Steel for pepper, ceramic for salt." }],
      "hero_image": { "url": "https://seonis.ai/storage/images/5/918.jpg", "alt": "A pepper grinder" },
      "infographic_url": null,
      "word_count": 1812,
      "published_url": null,
      "published_at": null,
      "updated_at": "2026-09-06T06:31:12+00:00",
      "created_at": "2026-09-05T02:14:55+00:00",
      "quality": { "seo_score": 88, "language_score": 96, "language_findings": [] }
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 1, "last_page": 1, "has_more": false }
}

Alt amháin, leis gach rud a fhágann an liosta ar lár: content_markdown, content_html, an FAQ mar schema.org JSON-LD réidh le cur isteach sa leathanach, agus aon naisc mhalartaithe atá san alt.

Is iad ainmneacha na réimsí na cinn a sheolann ár webhook, d'aon ghnó. Má tá glacadóir webhook agaibh cheana, léann an parsálaí céanna é seo.

Sampla

curl https://seonis.ai/api/v1/articles/918 \
  -H "Authorization: Bearer $SEONIS_API_KEY"

{
  "article": {
    "id": 918,
    "site_id": 5,
    "language": "en",
    "status": "ready",
    "title": "How to choose a pepper grinder",
    "slug": "how-to-choose-a-pepper-grinder",
    "meta_description": "Burr or blade, ceramic or steel: what matters in a grinder.",
    "content_markdown": "Grinders differ.\n\n## Burr or blade\n\nA **burr** grinder ...",
    "content_html": "<p>Grinders differ.</p>\n<h2>Burr or blade</h2> ...",
    "faq_schema": { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [] },
    "hero_image": { "url": "https://seonis.ai/storage/images/5/918.jpg", "alt": "A pepper grinder" },
    "word_count": 1812,
    "published_url": null,
    "updated_at": "2026-09-06T06:31:12+00:00",
    "quality": { "seo_score": 88, "language_score": 96, "language_findings": [] },
    "exchange_links": []
  }
}

Cuireann sibh an t-alt beo; seo an áit a n-insíonn sibh dúinn an seoladh. Is é seo an t-aon chríochphointe a athraíonn aon rud.

Déanann sé go díreach an rud a dhéanann seachadadh a rinneamar féin: marcáiltear an t-alt mar fhoilsithe, comhaireann do liúntas míosúil é, dúnann mír an phlean, faigheann aon naisc mhalartaithe ann an seoladh a bhfuil an fíoraitheoir ag fanacht leis, agus cuirtear do Facebook Page ar an eolas má tá ceann ceangailte agat. Gan an glao seo fanann an t-alt réidh go deo agus ní tharlaíonn aon cheann de sin.

Sampla

curl -X POST https://seonis.ai/api/v1/articles/918/published \
  -H "Authorization: Bearer $SEONIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://peppervale.co.uk/blog/how-to-choose-a-pepper-grinder"}'

Freagraí