ad-campaigns
ad-campaigns

Public Fast Crawl Website

Public fast-crawl endpoint for pre-registration use.

This endpoint allows fast-crawling a website BEFORE the user has registered, enabling the frontend to start crawling as soon as the user enters their website URL (at signup step 5) rather than waiting until after registration.

Authentication: Requires X-Public-Token header (not user JWT).

The results (S3 URLs for logo and screenshots) are returned directly. The frontend should cache these and pass them to the profile creation flow after user registration.

Request body:

  • website_url: URL of the website to crawl

Response:

  • website_id: Saphire website ID (for reference)
  • logo_url: S3 URL of the primary logo (if found)
  • screenshot_urls: List of S3 URLs for homepage screenshots
  • logos_found: Number of logos extracted
  • screenshots_captured: Number of screenshots taken
  • elapsed_seconds: Time taken
  • message: Status message
post/api/v1/ad-campaigns/public/fast-crawl

Request

  • Base URL: https://api.trylapis.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trylapis.com/api/v1/ad-campaigns/public/fast-crawl
  • Auth: none declared

Headers

X-Public-Tokenstring

Request body

website_urlstring required

Website URL to crawl

Response

Successful Response

website_idinteger required

Saphire website ID

urlstring required

Normalized website URL

company_namestring nullable

Detected company name

logo_urlstring nullable

S3 URL of the primary logo

screenshot_urlsstring[]

S3 URLs of homepage screenshots

logos_foundinteger

Number of logos extracted

screenshots_capturedinteger

Number of screenshots taken

elapsed_secondsnumber required

Time taken in seconds

messagestring required

Status message

sourcestring nullable

Source: 'website' or 'google_maps'

gmaps_infoobject nullable

Google Maps metadata when source is google_maps

Changes

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