apyhub
SEO

SEO Tags Generator API

What it does

SEO Tag Generator creates SEO meta tags from the content you send it. Submit a content string, and you can also set language and voice_tone to guide the output.

Use it when you need page-level metadata generated from article copy, landing-page text, or product descriptions. The POST endpoint starts an asynchronous job and returns a job_id plus a status_url you can poll.

When the job completes, the status endpoint returns the job id, type, and current status. On success, it includes result.meta_tags with fields such as title, description, keywords, author, og:title, og:description, og:image, og:url, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image, and twitter:creator.

SEO Tag Generator fits into content publishing workflows, CMS tooling, and internal marketing automation where you need structured meta tags without hand-writing each field.

▣ ENDPOINT 01 / 02
POST
Generate SEO Tags
https://api.eu.apyverse.com/sharpapi/generate-seo-tags

QUICKSTART

GUIDE

Quickstart

Submit content to generate SEO tags.

curl -X POST "https://api.eu.apyverse.com/sharpapi/generate-seo-tags" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"Write a short blog post about healthy morning routines.","language":"English"}'

What you'll get back

Returns a JSON object with job_id and status_url string fields. job_id is the unique identifier for the submitted job, and status_url is the URL to poll for job status.

{
  "job_id": "job_12345",
  "status_url": "https://example.com/jobs/job_12345"
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Provide the content to generate SEO tags.
Specify the language of the output.
Specify the voice tone of the output. It can be adjectives like funny or joyous, or even the name of a famous writer.

About this endpoint

What it does

Submits content to generate SEO tags asynchronously. The response returns a job identifier and a status URL that you can use to check progress.

Request Body

ParameterTypeMandatoryDescription
contentStringYesProvide the content to generate SEO tags.
languageStringNoSpecify the language of the output. Default: English.
voice_toneStringNoSpecify the voice tone of the output. It can be adjectives like funny or joyous, or even the name of a famous writer.

Response

Returns a JSON object with job_id and status_url string fields. job_id is the unique identifier for the submitted job, and status_url is the URL to poll for job status.

ParameterTypeMandatoryDescription
job_idStringNoThe unique identifier for the submitted job.
status_urlStringNoThe URL to poll for job status.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Extract the job identifier from job_id.

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 02 / 02
GET
Check SEO Tags Status
https://api.eu.apyverse.com/sharpapi/generate-seo-tags/job/status/:job_id

QUICKSTART

GUIDE

Quickstart

Check the status of an SEO tags generation job by its job ID.

curl -X GET "https://api.eu.apyverse.com/sharpapi/generate-seo-tags/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data object. Inside data, id is the job UUID, type is api_job_result, and attributes.status shows the job state (queued, running, success, or failed). When the job succeeds, data.attributes.result.meta_tags contains the generated SEO meta tags.

{
  "data": {
    "id": "2f3c1d9e-7b8a-4c9f-9d0e-1a2b3c4d5e6f",
    "type": "api_job_result",
    "attributes": {
      "type": "seo_generate_tags",
      "status": "success"
    }
  }
}
TRY ITLIVE · 1 ATOM
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Checks the status of an asynchronous SEO tags generation job using the job_id in the path. The response returns the job metadata and, once the job succeeds, the generated SEO meta tags under data.attributes.result.meta_tags.

Path Parameter(s)

AttributeTypeMandatoryDescription
job_idStringYesThe job's unique UUID.

Response

Returns a JSON object with a data object field. data contains the job id string, type string, and an attributes object with the job type, status, and, on success, a nested result object containing meta_tags.

AttributeTypeMandatoryDescription
dataObjectYesJob wrapper object containing the job identifier, resource type, and attributes.
data.idStringNoThe job's unique UUID.
data.typeStringNoResource type for the job result.
data.attributesObjectNoJob attributes object containing the operation type, status, and result.
data.attributes.typeStringNoThe operation type associated with the job.
data.attributes.statusENUMNoCurrent status of the asynchronous job. Allowed values: queued, running, success, failed.
data.attributes.resultObjectNoGenerated result object returned when the job succeeds.
data.attributes.result.meta_tagsObjectNoGenerated SEO meta tags.
data.attributes.result.meta_tags.titleStringNoSEO title tag.
data.attributes.result.meta_tags.authorStringNoSEO author tag.
data.attributes.result.meta_tags.og:urlStringNoOpen Graph URL tag.
data.attributes.result.meta_tags.og:typeStringNoOpen Graph type tag.
data.attributes.result.meta_tags.keywordsStringNoSEO keywords tag.
data.attributes.result.meta_tags.og:imageStringNoOpen Graph image tag.
data.attributes.result.meta_tags.og:titleStringNoOpen Graph title tag.
data.attributes.result.meta_tags.descriptionStringNoSEO description tag.
data.attributes.result.meta_tags.og:site_nameStringNoOpen Graph site name tag.
data.attributes.result.meta_tags.twitter:cardStringNoTwitter card tag.
data.attributes.result.meta_tags.twitter:imageStringNoTwitter image tag.
data.attributes.result.meta_tags.twitter:titleStringNoTwitter title tag.
data.attributes.result.meta_tags.og:descriptionStringNoOpen Graph description tag.
data.attributes.result.meta_tags.twitter:creatorStringNoTwitter creator tag.
data.attributes.result.meta_tags.twitter:descriptionStringNoTwitter description tag.

Notes

Poll this endpoint with the job_id returned by the submit call. The data.attributes.status field cycles through transitional values (queued, running) before reaching a terminal state (success, failed). The result fields are only populated once status is success; treat them as absent otherwise.

Path parameters

Name
Type
Description
job_idREQUIRED
string
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.