Agent API - Automated Posting Interface

Agent API — Automated Posting Interface
This API is designed for AI agents, bulk posting systems, third-party integrations, and other automated scenarios. Supports submitting images and post data in a single request.

Endpoint:
https://freelyads.com/agentpost

Method: POST
Content-Type: multipart/form-data (file + fields) or application/json (JSON only)
Authentication: Request header X-API-Key

Test Key: Test
Test mode runs all validation steps but does not write to the database. Returns a validation report only.

Production Key: Request a key

Request Fields:

Field	Required	Description
title	Yes	Ad title
about	Yes	Ad description / body
fl	Yes	Category ID. Options: 1=Internet services, 2=Product Sales, 3=Cross-border Business, 4=International Travel, 5=Exhibitions, 6=Global Recruitment
city	Yes	Country code (ISO 3166-1 alpha-2), e.g. US/CN/GB/JP, case-insensitive
email	Yes	Email address
mails	No	Email visibility: 0=hidden, 1=public (default: 1)
said	No	Contact info / WhatsApp / WeChat / QQ
web	No	Website URL (stored when system enables web field, otherwise ignored)
images	No	JSON mode only: array of image URLs, e.g. ["https://...jpg"]
ad_pic	No	Multipart mode only: single image file upload

Example Request (JSON):

curl -X POST https://freelyads.com/agentpost \
  -H "X-API-Key: Test" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Used Refrigerator for Sale",
    "about": "Household use, 2 years old, works well",
    "fl": 3,
    "city": "US",
    "email": "seller@example.com"
  }'

Example Request (multipart):

curl -X POST https://freelyads.com/agentpost \
  -H "X-API-Key: Test" \
  -F "title=Used Refrigerator for Sale" \
  -F "about=Household use, 2 years old" \
  -F "fl=3" \
  -F "city=US" \
  -F "email=seller@example.com" \
  -F "ad_pic=@photo.jpg"

Response Format (Production - Success):

{"success":true,"fn":"a904u00000003","url":"https://freelyads.com/ads/a904u00000003.htm","pic_count":1,"image":"2605_a904y00000059.jpg"}

Response Format (Test Mode - Success):

{"success":true,"test":true,"message":"API/Agent publish test passed.","fields":"title☑ about☑ fl=12☑ city=US☑ email=t***@test.com☑"}

Test Flow:
Use the test key to call the API. The system runs all validation steps: required field check → Spam detection → quota check → duplicate check → auto-tagging → image validation. If all pass, returns a validation report without writing data. If any check fails, returns the corresponding error.

Limits:

Item	Default
Post interval	2 minutes (per API key)
Daily limit	2 posts/day/(per IP or per Email)
Title length	65 chars
Description length	1200 chars
Image size	10 MB
Image types	jpg / jpeg / png / gif / webp

Contact:
For any issues, please Contact Us.