Create a bulk lookup batch

POST /api/v1/bulk/lookup
Api key

Enqueue up to 100 domains for lookup. Charges 1 credit per URL upfront and returns a batch id for polling.

Headers

  • Authorization string Required

    API token in format: Bearer YOUR_API_TOKEN

application/json

Body Required

  • domains array[string] Required

    At least 1 but not more than 100 elements.

  • recompute boolean
  • max_age integer

    ms

  • list_id integer

Responses

  • 202 application/json

    Batch accepted

    Hide headers attribute Show headers attribute
    • Location string

      URL to poll the batch

    Hide response attributes Show response attributes object
    • id integer Required
    • status string Required
    • requested_count integer Required
    • processed_count integer Required
    • success_count integer Required
    • error_count integer Required
    • created_at string(date_time)
    • started_at string(date_time) | null
    • finished_at string(date_time) | null
    • links object Required
      Hide links attribute Show links attribute object
      • self string
  • 401

    Unauthorized

  • 402

    Payment required

  • 422 application/json

    Unprocessable entity

    Hide response attribute Show response attribute object
    • error string Required
POST /api/v1/bulk/lookup 
curl \
 --request POST 'https://api.techlens.app/api/v1/bulk/lookup' \
 --header "Content-Type: application/json" \
 --header "Authorization: string" \
 --data '{"domains":["example.com","https://foo.bar/"],"recompute":false,"max_age":604800000,"list_id":42}'
Request examples 
# Headers
Authorization: string

# Payload
{
  "domains": [
    "example.com",
    "https://foo.bar/"
  ],
  "recompute": false,
  "max_age": 604800000,
  "list_id": 42
}
Response examples (202) 
# Headers
Location: string

# Payload
{
  "id": 123,
  "status": "queued",
  "requested_count": 2,
  "processed_count": 0,
  "success_count": 0,
  "error_count": 0,
  "created_at": "string",
  "started_at": "string",
  "finished_at": "string",
  "links": {
    "self": "/api/v1/bulk/lookup/123"
  }
}
Response examples (422) 
{
  "error": "domains must be a non-empty array"
}