Collect
Inspect the official product site, pricing page, and help center. Never invent metrics, features, or customer claims.
Give a site owner agent the context it needs to collect, validate, submit, and track a high-quality AI tool listing without back-and-forth.
The skill and public form both produce the same normalized record, so editors can evaluate every listing consistently.
Inspect the official product site, pricing page, and help center. Never invent metrics, features, or customer claims.
Normalize the category, pricing model, platforms, features, and audience into the required JSON schema.
Send one request, store the private token securely, and poll the status endpoint only when a review update is expected.
The package contains the submission skill, a field-by-field quality guide, a dependency-free Node.js client, and the free-submission backlink requirement.
The endpoint validates completeness and stores the response in the same queue as the human form. Approval remains human.
/api/v1/tools.phpBrowse approved tools/api/v1/tool.php?slug=chatgptRead a tool profile/api/v1/submissions.phpCreate a review submission/api/v1/submissions.php?id=...&token=...Check private statuscurl -X POST https://aimytool.com/api/v1/submissions.php \
-H "Content-Type: application/json" \
-H "X-AIMYTOOL-Agent: site-owner-agent/1.0" \
-d @listing.jsoncurl "https://aimytool.com/api/v1/submissions.php?id=sub_xxx&token=private_token"{
"data": {
"submission_id": "sub_5c2f...",
"status": "pending",
"status_url": "https://aimytool.com/status/?id=...&token=...",
"edit_token": "shown_once",
"completeness_score": 94
}
}A submission missing any required field is rejected with a machine-readable field error response.
namestring2-120 charsProduct nameurlURLPublic HTTPS URLOfficial product websitetaglinestring20-180 charsOutcome-focused one-line pitchdescriptionstring200-4000 charsProduct and workflow detailwhat_it_doesstring120-5000 charsDetailed public page explanationhelps_usersstring80-5000 charsConcrete user outcomescategoryenumCategory slugPrimary categorypricing_modelenumfree|freemium|paid|contactPublic pricing modelkey_featuresstring[]3-8 itemsConcrete capabilitiesuse_casesstring[]2-8 itemsSpecific jobs to be donefaqsobject[]3-10 itemsQuestion and answer pairswho_forstring20-500 charsBest-fit audienceowner_namestring2-120 charsAuthorized submitterowner_emailemailValid emailContact for reviewfriendly_link_urlURLRequired for freePage containing your AIMYTOOL linkfriendly_link_typeenumfooter|blog|otherLocation of the linkconsent_accuracybooleantrueAccuracy declarationconsent_termsbooleantrueListing terms acceptancelogo_urlsecondary_categoriesstarting_pricefree_trialplatformslaunch_yearnot_forintegrationslanguagesowner_rolex_profiledemo_urlconsent_contactCreate an API key from the editorial dashboard, then send patch, upsert, or hide operations. Batch responses report success or failure per item.
/api/batch/v1/tools.phpCreate, patch, or hide toolscurl -X POST https://aimytool.com/api/batch/v1/tools.php \
-H "Authorization: Bearer aimy_your_key" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"action": "patch",
"slug": "example-tool",
"tagline": "Updated one-line pitch",
"localizations": {
"en": { "tagline": "...", "seo_title": "...", "seo_description": "...", "what_it_does": "...", "helps_users": "...", "faqs": [] }
}
}
]
}'Do not fabricate user counts, funding, awards, ratings, or customer logos.
Check status no more than once per hour. A human review usually takes two business days.
Submit only products the owner is authorized to represent. Public listings still require editorial approval.
Download the skill folder, copy it into your agent's skills directory, and provide the product URL and owner contact.