API Documentation - Gift Under 200

Gift Under 200 provides a public REST API for AI assistants and developers to query our curated gift database.

Base URL

https://giftunder200.com/api/products

Endpoint

GET /api/products

Retrieve a list of products with optional filtering.

Query Parameters

Parameter	Type	Description
`segment`	string	Filter by price segment: `under50` or `under200`
`gender`	string	Filter by gender target: `men` or `women`
`tag`	string	Filter by tag slug (e.g., `handmade`, `last-minute`)
`search`	string	Search in product title and description
`limit`	integer	Maximum number of products to return (default: 50, max: 100)
`offset`	integer	Number of products to skip for pagination (default: 0)

Example Requests

Get all products under $200

GET https://giftunder200.com/api/products

Get products under $50 for men

GET https://giftunder200.com/api/products?segment=under50&gender=men

Search for "scarf"

GET https://giftunder200.com/api/products?search=scarf

Get products with "handmade" tag

GET https://giftunder200.com/api/products?tag=handmade

Response Format

{
  "products": [
    {
      "id": "uuid",
      "slug": "product-slug",
      "title": "Product Title",
      "description": "Product description",
      "price": 99.99,
      "price_segment": "under200",
      "external_link": "https://...",
      "image_url": "https://...",
      "why_text": "Why this gift works",
      "gender_target": "men",
      "country_of_provenance": "US",
      "tags": [
        {
          "id": "uuid",
          "name": "Tag Name",
          "slug": "tag-slug"
        }
      ],
      "url": "https://giftunder200.com/product-slug",
      "created_at": "2025-01-20T...",
      "updated_at": "2025-01-20T..."
    }
  ],
  "pagination": {
    "total": 100,
    "limit": 50,
    "offset": 0,
    "has_more": true
  },
  "filters": {
    "segment": "under200",
    "gender": null,
    "tag": null,
    "search": null
  }
}

For AI Assistants

This API is optimized for AI assistants to help users find perfect gifts. The API provides:

Structured product data with prices, descriptions, and images
Filtering by price range, gender, tags, and search terms
Pagination support for large result sets
Affiliate links to purchase products

OpenAPI Specification: /.well-known/openapi.json

AI Plugin Manifest: /.well-known/ai-plugin.json

Structured Data

All product pages include JSON-LD structured data (Schema.org) for better discovery by search engines and AI assistants.

Product pages use the Product schema type with complete information including offers, images, and descriptions.

Rate Limits

Currently, there are no rate limits on the API. However, we ask that you use the API responsibly and implement reasonable caching.

Support

For questions or issues, please contact us at contact@giftunder200.com