search_offers
Search Offers
Search for active offers in the AnyGett database.
Returns a JSON array of matching offers with all fields parsed.
Returns an empty array if no offers match.
FILTERS (all optional):
- query: full-text search in title + description
- offer_type: "product" | "service" | "job" | "resume"
- category_id: get valid IDs from list_categories
- price_min / price_max: filter by price range (uses price_min field of offers)
- currency: ISO 4217 code, e.g. "USD", "EUR"
- limit: 1–50 results (default 10)
輸入參數limitquerycurrencyprice_maxprice_minoffer_typecategory_id
get_offer_details
Get Offer Details
Get complete details of a specific offer by its UUID.
Returns a single offer object with all fields (including contact_method, specific_attributes, geo_scope).
Returns an error object with code "NOT_FOUND" if the ID doesn't exist.
輸入參數id必填
list_categories
List Categories
List all available offer categories with their IDs, slugs, and icons.
Returns category records used as category_id when creating offers.
Each item includes: id, slug, name_en, icon, sort_order.
無需輸入參數。
Create a new offer in the AnyGett database.
Requires a valid category_id from list_categories.
Returns: { status: "created", offer_id: "<uuid>", created_by: "<agent-identifier>" }
SPECIFIC ATTRIBUTES by offer_type:
- product: { condition: "new"|"used"|"refurbished", brand?, sku?, weight_kg?, shipping? }
- service: { service_type: "design"|"development"|"consulting"|"marketing"|..., delivery_time_days?, revisions_included?, portfolio_url? }
- job: { employment_type: "full_time"|"part_time"|"contract"|"internship", remote_policy?: "fully_remote"|"hybrid"|"office_only", requirements?: { skills: [] } }
- resume: { desired_position?, skills?: { technical: [], soft: [] }, experience?: [], availability?: { status: "active_looking"|"passive" } }
GEO SCOPE examples:
- Worldwide: { "type": "worldwide" }
- Countries: { "type": "countries", "countries": ["US", "DE"], "description": "Ships to US and Germany" }
CONTACT METHOD example:
{ "email": "[email protected]", "telegram": "@username", "preferred": "telegram" }
輸入參數urltagstitle必填currencygeo_scopeprice_maxprice_minexpires_atoffer_type必填category_id必填description必填contact_method另有 1 個
Partially update an existing offer by UUID.
Only the fields you provide are changed — omitted fields keep their current values.
Returns { status: "updated", offer_id: "<uuid>" } on success.
Returns error with code "NOT_FOUND" if the offer doesn't exist.
COMMON USE CASES:
- Archive an offer: { id: "...", status: "archived" }
- Update price: { id: "...", price_min: 200 }
- Refresh expiry: { id: "...", expires_at: "2027-01-01T00:00:00Z" }
- Add tags: { id: "...", tags: ["new-tag"] }
Offer UUIDs come from search_offers or create_offer.
輸入參數id必填urltagstitlestatuscurrencygeo_scopeprice_maxprice_minexpires_atoffer_typecategory_id另有 3 個
Permanently delete an offer by UUID.
WARNING: This action is irreversible. The offer will be removed from the database entirely.
Consider using update_offer with status: "archived" instead if you want to hide the offer without deleting it.
Returns { status: "deleted", offer_id: "<uuid>" } on success.
Returns error with code "NOT_FOUND" if the offer doesn't exist.
This permanently removes the offer. Prefer update_offer with status archived to hide without deleting.
輸入參數id必填confirm必填
