Advertisers

Match advertisers

Matches advertising networks to website content based on classification demographics. Provide either a URL (classification will be fetched automatically) or demographics directly (category, age, gender, sentiment). At least one of url, category, age, gender, or sentiment must be provided. Scoring weights: category match (+10), age match (+5), gender match (+3), sentiment match (+2), with CPM as tiebreaker.

get/api/v1/advertisers

Request

  • Base URL: https://llmse.ai
  • URL: https://llmse.ai/api/v1/advertisers
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

urlstring uri

URL to match advertisers for (classification will be fetched)

categorystring

Target category (e.g., Sports, Technology)

subcategorystring

Target subcategory

agestring

Target age group (e.g., 18-24, 25-34)

gender'male' | 'female' | 'all'

Target gender (male, female, or all)

sentiment'Good' | 'Neutral' | 'Bad'

Content sentiment

limitinteger

Number of advertisers to return (1-10)

min_cpmnumber

Minimum CPM cost filter (inclusive)

max_cpmnumber

Maximum CPM cost filter (inclusive)

Response

Advertiser matches. Response shape varies: includes 'classification' when URL is provided, or 'demographics' and 'cpm_filter' when demographics are provided directly.

OR

Example response

{
  "matches": [
    {
      "advertiser": {
        "id": "adv_001",
        "name": "Nike"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.