search

Search Images

Search for diagrams, figures, and tables in 3GPP specifications by natural language query.

Finds protocol architecture diagrams, procedure flow charts, network topology figures, message sequence charts, and other visual content embedded in 3GPP specs.

When to use: When the user asks about a diagram or figure, or when a visual would help explain a concept (e.g. "show me the handover procedure", "NR user plane protocol stack diagram").

Results: Each result includes the figure caption, surrounding text context (context_before/context_after), and the section it appears in. Use the context to understand what the figure depicts.

Prefer text search (search_text) for most queries. Use image search specifically when diagrams/figures are needed.

Dates: each result's provenance gives the 3GPP archive upload time and approving TSG plenary of its version; available_before keeps only versions uploaded before a date.

post/search/images

Request

  • Base URL: https://api.3gppscout.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.3gppscout.com/search/images
  • Auth: none declared

Request body

querystring required

Natural language query describing the diagram, figure, or table you're looking for. E.g. 'protocol stack architecture', 'random access procedure flow chart'.

match_countinteger

Number of image results to return.

match_thresholdnumber

Minimum similarity score. Default 0.3 filters low-quality matches.

deduplicateboolean

Collapse near-duplicate image results from different releases/versions (same doc_number, section_number, and caption). Keeps the highest-similarity result (the newest release when similarities tie) and annotates 'also_in' with each collapsed match's release, version, and similarity. Ignored when filter_release is set.

filter_releasestring nullable

Restrict to a specific 3GPP release. Examples: 'Rel-15', 'Rel-17', 'Rel-20'. Omit for all indexed releases (Rel-15 through Rel-20).

filter_doc_numberstring nullable

Restrict to a specific document, e.g. '38.300', '23.501'. Numeric format only.

filter_seriesstring nullable

Restrict by series: '38' = NR/5G, '23' = system architecture, '36' = LTE, '33' = security.

available_beforestring date nullable

Only versions uploaded to the 3GPP archive before this date (YYYY-MM-DD; before 00:00 UTC, so the day itself is excluded), e.g. a patent application's priority date. A version whose upload time is unknown is left out. Usually one version per release of each spec is indexed (the newest in that release, Rel-15 onward), so a release appears only if that version predates the cutoff; older versions are in the 3GPP archive but not searchable here.

Response

Successful Response

querystring required
totalinteger required
elapsed_msnumber required

Changes

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